인터페이스 오해 경험 → Mock 서버 공유 → SLA 명시 + 지표 리포트
협력사와 API를 연동하는 프로젝트를 맡았을 때, 문서만으로 소통하면 인터페이스 오해가 생긴다는 걸 초반에 경험했습니다. 스펙 문서를 주고받았는데 필드 형식과 에러 코드 해석이 달라 초기 통합 테스트에서 오류가 많이 나왔습니다. Mock 서버를 먼저 만들어 공유하고 양쪽이 같은 계약을 기준으로 개발하는 방식으로 바꾸니 의사소통 비용이 크게 줄었습니다. SLA 기준을 협력사와 명시적으로 합의하고, 응답 시간과 가용성 지표를 주기적으로 공유하는 리포트를 만들었습니다.
문제가 생겼을 때보다 정상 상태를 먼저 정의해두는 것이 협력사와의 신뢰를 만드는 방법이라고 생각합니다.