REST #API #API설계 #백엔드 #개발자실무 #트러블슈팅1 개발기초 REST API 설계하면서 겪은 실수와 배운 점 (실무에서 얻은 기준) MES 서비스 백엔드 개발을 맡으면서 API 설계를 처음부터 담당한 적이 있습니다. 문서로 배운 REST 원칙과 실제 실무에서 API를 설계하는 건 꽤 다르다는 걸 그 과정에서 깨달았습니다.상황: 왜 다시 설계를 고민하게 됐나초반에 급하게 만든 API들이 있었는데, 기능이 늘어나면서 [엔드포인트가 뒤죽박죽되거나 / 프론트엔드 개발자가 API 스펙을 계속 다시 물어보는] 상황이 반복됐습니다. 이 시점에 설계 기준을 다시 세워야겠다고 판단했습니다.문제 1: 엔드포인트 이름 규칙이 제각각이었다초반에 급하게 만들다 보니 [/getUser, /user_list, /Users] 처럼 같은 리소스인데 표기 방식이 다 달랐습니다. 새 기능을 추가할 때마다 "이번엔 어떤 이름으로 지어야 하나" 매번 고민하게 됐습니다.해.. 2026. 7. 24. 이전 1 다음 반응형