개발자
고객 API 작업 제출
키, 멱등성, 한도 및 결과 페이지네이션.
범위가 지정된 키 사용
프로덕션 검증에는 submit 범위가 있는 Live 키를 사용하세요. 키는 서버에 보관하고 필요한 submit, read 또는 balance 범위만 부여하세요. Test 키는 예약된 예시 주소를 시뮬레이션하며, 제공업체 호출이나 크레딧 사용이 없습니다.
라이브 키 한도에는 차감된 크레딧과 접수된 예약이 함께 계산됩니다. 한도에 도달하면 새 작업은 보류를 생성하지 않고 거부됩니다. 워크스페이스 크레딧은 검사가 처리 대상으로 접수될 때 예약되며, 대시보드와 동일한 차감 및 반환 규칙이 적용됩니다.
안전한 재시도
작업과 함께 고정된 Idempotency-Key를 보내세요. 일치하는 재시도는 동일한 작업을 반환합니다. 반환된 작업 ID로 상태와 페이지가 나뉜 결과를 조회하세요. 같은 키로 다른 페이로드를 보내면 거부됩니다.
운영상 일시 중지로 인해 새 라이브 작업이 HTTP 503 live_verification_unavailable 응답과 함께 일시적으로 거부될 수 있으며, 이때 크레딧은 보류되지 않습니다. 나중에 동일한 멱등성 키로 다시 시도하세요. 이는 API 키 권한, 키 한도 및 요청 속도 제한과는 별개입니다.