REST API 통합 인증 오류 해결 결
팀 프로젝트에서 외부 날씨 API를 통합할 때 처음으로 REST API 연동 문제를 겪었습니다. API 키 인증 방식을 이해하지 못한 채 헤더 형식을 잘못 전달해 401 오류가 계속 났고, 공식 문서를 꼼꼼히 읽어 Bearer 토큰 포맷이 아닌 쿼리 파라미터 방식이라는 것을 확인한 뒤 해결했습니다. 이후 Postman으로 API를 먼저 테스트한 뒤 코드를 작성하는 순서가 훨씬 효율적이라는 것을 배웠습니다. Rate limit 오류도 한 번 겪었는데, 짧은 시간에 요청이 몰리면 429 응답이 오는 것을 확인하고 지수 백오프 재시도 로직을 추가했습니다. 또한 외부 API 응답이 변경됐을 때 앱 전체가 깨지는 문제를 경험해, 응답 파싱 레이어를 별도로 분리하는 방식을 도입했습니다. 이 구조 덕분에 이후 API 응답 구조가 바뀌었을 때 한 파일만 수정해도 전체가 정상 동작했습니다. REST API 통합에서 공식 문서를 먼저 읽는 것이 시행착오를 줄이는 결이었습니다.