전체 글
-
OpenAPI와 스웨거를 활용한 실전 API 설계를 읽고 ... (4, 마지막)개발하면서/타인글보면서 2024. 5. 12. 20:42
지금까지 구현한 API에서 오류가 발생하는 상황을 살펴보고 예외 처리를 어떻게 하는지 알아본다.그리고 JSON 스키마를 이용하여 엄격하게 입력값 유효성 검증 하는 방법도 알아본다. 모든 일이 다 잘되기를 바라지만 현실은 그렇지 못하다.실패를 항상 피해 갈 수는 없지만 그 실패를 발견하고, 복구하고, 고치는 방법을 찾아내야 한다. 모든 API에 대해 클라이언트 에러가 발생할 상황을 나열하고 범주화해서 상태 코드 3개로 매핑한다.상태설명발생 위치400유효하지 않은 입력POST, PUT, 쿼리 파라미터가 포함된 GET을 사용하는 엔드포인트403허용되지 않은 접근권한 관련 비즈니스 로직이 포함된 모든 엔드포인트404자원이 존재하지 않음리소스 엔드포인트 및 서브 리소스 컬렉션 엔드포인트 오류 메시지가 사람이 이해..
-
OpenAPI와 스웨거를 활용한 실전 API 설계를 읽고 ... (3)개발하면서/타인글보면서 2024. 5. 10. 20:00
2부는 백지상태에서 서비스 오픈까지의 과정을 알아봤다면3부에선 펫시터 오픈 이후 API 확장과 진화되는 과정을 알아본다.OpenAPI의 고급 주제를 다룬다. 스프린트라는 단어는 소프트웨어 개발 프로젝트에서 시간 블록을 의미한다.1. 요구사항을 모두 확인하여 달성율을 판단하고 (회고, 피드백),2. 다음에는 어떤 걸 할 수 있고 무엇을 해야 하는지 확인하는 과정이다. (계획, 준비)한 스프린트에서 우선순위 목록을 나열하고 도메인 모델 재검토, 사용자 스토리 검토하는 내용이 나온다. 개인적으로 스프린트에서 가장 중요하다고 생각하는건하나의 스프린트에 끝낼 수 있는 크기의 것으로 시작하는 것이다. (두 번째는 임팩트라고 생각)요구사항이 크고 복잡하다면 한 스프린트에 달성 가능한 크기로 잘게 쪼개도록 의도적으로 ..
-
OpenAPI와 스웨거를 활용한 실전 API 설계를 읽고 ... (2)개발하면서/타인글보면서 2024. 5. 8. 20:20
지난 글에 선 만들어져 있는 API를 OpenAPI로 표현하는 법을 배웠다면이번에는 하나의 서비스를 백지상태부터 오픈기까지의 과정 소개한다. OpenAPI와 스웨거를 활용한 실전 API 설계를 읽고 ... (1)어느 날 DigitalOcean 블로그에서 "journey to Python Client generation" 글을 보았다. 최근 전자공시시스템의 OPENDART와 한국투자증권의 OpenKIS 연동하면서규격화된 무언가가 있어서 간단하고 빠르게 클라이dol9.tistory.com책에서는 아이디어 구상과 팀 구성, 도메인 모델 설계와 프로젝트 구현에 필요한 계획 수립 과정 등을 소개하는데그중 기술적인 부분만 일부 정리했다.실무에 적용하면서 겪을만한 내용들이 있으니 관심이 있다면 꼭!! 책을 읽어보길..
-
OpenAPI와 스웨거를 활용한 실전 API 설계를 읽고 ... (1)개발하면서/타인글보면서 2024. 5. 6. 20:00
어느 날 DigitalOcean 블로그에서 "journey to Python Client generation" 글을 보았다. 최근 전자공시시스템의 OPENDART와 한국투자증권의 OpenKIS 연동하면서규격화된 무언가가 있어서 간단하고 빠르게 클라이언트 코드 생성 했으면 좋겠다고 생각하던 차였다. DigitalOcean's journey to Python Client generationIn this blog post, we will dive into our journey of building our new Python Client, and how we used code generation to create the SDK.www.digitalocean.com 요약하면 DigitalOcean의 api를 O..
-
다니는 회사 재무제표 살펴보기살아가면서/생각하면서 2024. 4. 10. 22:14
언제부터인지, 어떤 계기인지 정확히 기억나진 않지만 2021년 즈음에 회계(정확히는 DART에 올라오는 공시들)에 관심 갖기 시작했다. 아직도 재무제표 계정과 주석에 모르는 내용이 한 트럭이지만 자주 보다 보면 익숙해지지 않을까 생각하면서 주기적으로 보고 있다. (자주 보진 못해서 제자리걸음인 건 함정..ㅋㅋㅋ) 어제 지금 다니고 있는 회사의 DART에 감사보고서가 올라오면서 좋은 기사도 올라왔다. https://www.hankyung.com/article/202404090179i 카카오스타일, 작년 매출 62% 늘어…지그재그는 흑자 전환 카카오스타일, 작년 매출 62% 늘어…지그재그는 흑자 전환, 카카오스타일, 작년 실적공시 매출 62% 늘어난 1650억 영업손실 581억->198억으로 감소 지그재그 ..
-
Kotlin 사용하면서 배운 10가지개발하면서/타인글보면서 2024. 1. 30. 09:42
IT 컨설턴트 회사 Xebia에서 Kotlin을 사용하면서 배운 10가지 정리한 글을 읽었다. https://xebia.com/blog/using-kotlin-in-a-java-project-10-lessons-learned/ Using Kotlin in a Java project: 10 lessons learned Kotlin Using Kotlin in a Java project: 10 lessons learned - Xebia xebia.com Java에서 Kotlin으로 넘어가면서 느낀 장점은 Null safety와 data class를 이용해서 boilerplate 코드가 눈에 띄게 줄었다는 점이다. 현재 업무로 Kotlin + Spring을 쓰고 있는데 (Java 보다는) 직관적이고 다양한 표..