공개 API

결과를 넘겨 가며 한도 안에 머무르기

목록 엔드포인트는 오프셋이 아니라 커서로 페이지를 나눕니다. 직접 계산하지 말고 응답이 주는 커서를 따라가세요. 속도 한도 헤더를 지켜보고, 전부 다시 읽는 대신 updatedSince로 폴링하세요.

최종 검토 2026년 8월 20일

절차

1. 커서가 더 이상 돌아오지 않을 때까지 각 응답의 커서를 따라갑니다. 커서를 직접 만들지 마세요.
2. 페이지 크기는 적당히 유지합니다. 클수록 요청은 줄지만 느려집니다.
3. 정해진 시각에 전체를 훑는 대신 updatedSince로 폴링합니다.
4. 속도 한도 헤더를 읽고, 거부당한 뒤가 아니라 그 전에 속도를 늦춥니다.
5. 실패한 것의 requestId는 지원팀을 위해 보관합니다.

결과 확인 방법

한 바퀴 훑으면 모든 객체가 정확히 한 번씩 돌아오고, 반복 폴링은 바뀐 것만 읽습니다.

흔히 어긋나는 지점

• 오프셋 방식 페이지. 아래에서 데이터가 바뀌면 어긋납니다.
• 매 분 전부 다시 읽다가 한도에 부딪히는 것.
• 오래된 커서를 다시 써서 유효하지 않은 커서 오류를 받는 것.