notesthoughts

API 연동의 핑퐁도 작업이다

누락 필드를 찾고, 수정을 요청하고, 다시 확인하는 시간은 연동 작업의 일부다. 그 시간을 기록하지 않으면 일정에서 사라진다.

API 연동을 한다고 하면 호출을 붙이고 응답을 화면에 넣는 일이 먼저 떠오른다. 그런데 실제로 시간을 쓰는 곳은 그 사이에 많다. 필요한 필드가 없고, 예상한 타입과 다르고, 빈 배열이 오면 화면의 전제가 깨진다. 확인해서 전달하고, 수정됐다는 답을 받고, 다시 확인한다.

이 과정을 그냥 대화로 취급하면 일정에는 흔적이 거의 남지 않는다. 프론트엔드 티켓은 여전히 진행 중이고, API 티켓은 이미 완료돼 있다. 나중에 보면 화면을 붙이는 데 오래 걸린 것처럼 보이지만, 그동안 한 일은 응답을 사용할 수 있는 상태로 만드는 일이었다.

완료됐다는 말의 범위

백엔드에서 완료됐다고 말할 때와 프론트엔드가 연동할 수 있다고 말할 때 가리키는 상태가 다를 수 있다. 엔드포인트가 열리는 것만으로는 부족하다. 필요한 응답 형태가 합의됐는지, 필수 필드가 들어오는지, 주요 실패 상황을 화면에서 구분할 수 있는지도 확인해야 한다.

그래서 API가 준비됐다는 기준을 함께 갖고 싶다. 최신 명세와 샘플 응답이 있고, 성공과 주요 실패 케이스를 확인할 수 있는 정도면 연동을 시작할 때의 불확실성이 줄어든다. 모든 예외를 미리 막자는 뜻은 아니다. 무엇이 준비됐고 무엇은 아직 확인해야 하는지 서로 같은 상태를 보고 싶다는 것이다.

기록해야 견적에 들어간다

누락 필드를 확인했다면 그 작업을 티켓에 남긴다. 수정 요청과 재검증도 남긴다. 작업 시간을 설명하려고 과거의 대화를 뒤지는 대신, 연동 과정 자체가 보이게 하는 편이 낫다.

이건 책임을 다른 쪽으로 넘기려는 기록이 아니다. 반복해서 필요한 일을 다음 견적에도 포함하기 위한 기록이다. 호출 코드를 빨리 작성할 수 있어도 응답 검증과 조율이 자동으로 사라지지는 않는다. 연동을 연결 한 번으로 계산하면, 같은 시간이 매번 예상 밖의 지연으로 돌아온다.