OpenAPI 문서와 실제 API가 어긋날 때 먼저 잡을 기준Swagger UI에는 분명 email이 필수라고 적혀 있는데, 실제 응답에는 가끔 빠집니다. 문서에는 status가 active | blocked라고 되어 있지만 운영 데이터에는 pending이 섞여 있습니다. 프론트엔드는 타입을 믿고 배포했는데, 어느 날 특정 고객 계정에서만 화면이 깨집니다.이런 문제는 OpenAPI를 "문서 자동 생성" 정도로만 보면 계속 반복됩니다. OpenAPI는 예쁜 API 문서가 아니라, 클라이언트와 서버가 함께 지키는 계약으로 다뤄야 합니다. 계약이 깨지는 순간은 대개 큰 리팩토링 때가 아닙니다. 필드 하나를 optional로 바꾸거나, 에러 응답 형식을 급하게 추가하거나, 테스트 데이터에 없는 케이스가 운영에서..
나는 잡종 개발자 이다.
나는 잡종 개발자이다. 이번 포스팅은 글쓴이의 잡담이며, 누구에게 조언이나, 토의를 하고 싶어서 쓴 글이 아닙니다. 지극히 잡담이며, 그냥 끄적이는 글입니다. 살짝 후회중 ... 작년에 "나는 PHP 개발자이다"라는 글을 썼는데 많은 분들의 응원과 질문을 받았다. 그 후로 1년이 지난 나는 어떤 모습으로 살고 있으며, 후배(선배님들 말고)들에게 하고 싶은 말을 적는다. PHP 개발자가 되고선 최근에 후회 아닌 후회를 조금씩 하고 있다. 연차가 높아지고, 가정이 생기고, 높은 연봉과 안정적인 직장에 대한 기대가 생기면서, PHP 언어의 한계가 아니라 PHP 개발자로서의 한계를 조금씩 맞닿고 있기 때문이다. 괜찮은 스타트업이나, 괜찮은 직장은 PHP에도 많다. 생각보다 많다. 그렇지만 대기업은 흐음... 대..