실제 API로 개발하는 일은 문서를 읽는 것과는 전혀 다르다

개발자는 API 연동의 진짜 어려움이 인증이나 요청 자체가 아니라, 문서와 다르게 움직이는 실제 응답을 해석하는 일이라고 말한다.

여러 서비스는 데이터 형식, 이벤트 정의, 타임스탬프 처리, 예외 상황이 제각각이라 통합이 예상보다 훨씬 복잡해진다.

그래서 엔지니어는 OAuth나 엔드포인트 호출뿐 아니라, 페이징·레이트 제한·에러 처리까지 현실적인 변수를 모두 고려해야 한다.

이 글은 외부 시스템을 다룰 때 문서만 믿기보다, 프로덕션에서 발생하는 불일치와 엣지 케이스를 전제로 설계해야 한다는 점을 강조한다.