모든 페이지를 읽고, 속도 제한을 준수하며, 오류 발생 시 안전하게 복구하십시오.
속도 제한
제한은 구성 가능합니다. GET 및 /v1/operations/capabilities 오류는 requestsPerMinute 및 authenticationRequestsPerMinutePerIp 오류를 보고합니다. 429 오류 발생 후, 재시도 간격을 준수하고 스로틀링이 계속될 경우 더 오래 기다리십시오. 일괄 읽기는 최대 100개의 ID를 허용하며, 개별 엔드포인트는 페이지 또는 페이로드 제한이 더 작을 수 있습니다. (Retry-After)
모든 페이지를 읽어보세요
호출한 엔드포인트에 대한 연속 규칙을 사용하고, 필터는 그대로 유지합니다. 목록은 읽는 동안 변경될 수 있으므로, 일관된 복사본이 필요할 때는 스냅샷을 사용하세요.
페이지네이션 계속 진행 중지 조건 커서 next를 after로 전달합니다. 다음은 null입니다. nextOffset와의 오프셋 nextOffset를 offset로 전달합니다. nextOffset는 null입니다. hasMore를 사용한 오프셋 반환된 항목 수만큼 오프셋을 증가시킵니다. hasMore는 거짓입니다. 소프트웨어 숫자 next 값을 after로 전달합니다. updatedAtUtc가 변경되면 다시 시작합니다. 다음은 null입니다. 이벤트 피드 next를 after로 전달합니다. hasMore는 거짓입니다. 오류 처리
오류 코드와 HTTP 상태를 읽습니다. 응답에 requestId가 포함된 경우 지원팀에 문의할 때 해당 값을 알려주세요.
HTTP 상태 수행할 작업 400 요청을 수정하세요. 401 자격 증명을 확인하거나 새 액세스 토큰을 받으세요. 403 범위, 권한 및 액세스 활성화 여부를 확인하세요. 404 리소스가 없거나 사용 범위에 없을 수 있습니다. 409 결정을 내리기 전에 오류 코드와 현재 상태를 확인하십시오. 410 스냅샷 또는 이벤트 커서가 만료되었습니다. 새 기준선을 시작하십시오. 쓰기 시간 초과
시간 초과 또는 503 오류는 작업 실패를 의미하지 않습니다. 작업 영수증을 반환하는 쓰기의 경우, 다시 시도하기 전에 GET 및 /v1/operations/by-key?idempotencyKey={key}를 확인하십시오. 유지 관리 생성의 경우, 원래 Idempotency-Key 및 본문을 재사용하십시오.