오류 및 한도
Partner API가 반환하는 모든 오류 코드와, 적용하는 모든 제한.
모든 실패는 같은 형태를 가집니다. 다음을 기준으로 분기하세요 error.error_code; 로그 설명 사람이 읽기 위한 것입니다. 텍스트 자체로는 절대 일치시키지 마세요. error.error_attributes 코드가 정의한 세부 정보를 담고 있으며, null 나머지에는 사용됩니다.
{
"description": "story_document: 링크는 \"text/html\"을 제공합니다. 이 입력은 이를 허용하지 않습니다. 파일 자체를 지정하세요.",
"code": "url_type_not_allowed",
"error": {
"id": null,
"error_code": "url_type_not_allowed",
"error_attributes": null,
"user_readable_message": null,
"locale": "en"
}
}코드 반복됩니다 error.error_code 이전 클라이언트용입니다. 다음을 읽어보세요 error.error_code.
오류 코드
| HTTP | error_code | 의미 | 조치 방법 |
|---|---|---|---|
| 400 | invalid_request | 본문이나 입력값이 잘못되었습니다. 설명에 해당 입력이 명시됩니다 | 수정한 뒤 다시 보내세요. 변경 없이 재시도하지 마세요 |
| 400 | url_not_fetchable | 링크를 가져올 수 없었거나, 링크 규칙 중 하나를 위반했거나, 빈 파일을 제공했습니다 | 다음과 비교해 확인하세요 URL로 파일 전달 |
| 400 | url_type_not_allowed | 링크가 이 입력에서 허용하지 않는 콘텐츠 유형을 제공했거나, 선언한 유형이 아닌 바이트를 제공했습니다 | 파일 자체를 실제 유형으로 제공하세요 |
| 400 | url_too_large | 파일이 입력의 max_bytes, 또는 실행에 남아 있는 바이트 예산을 초과했습니다 | 더 작은 파일을 보내세요 |
| 401 | unauthorized | 키가 없거나, 형식이 잘못되었거나, 취소되었거나, 만료되었습니다 | 중단하고 누군가에게 알리세요. 재시도로는 해결되지 않습니다 |
| 403 | api_key_credit_limit_reached | 키가 자체 크레딧 한도 중 하나에 도달했습니다; error_attributes.period 어느 한도인지 나타냅니다 | 관리자에게 Studio에서 키의 한도를 올려 달라고 요청하거나, 일간 또는 월간 한도가 초기화될 때까지 기다리세요 |
| 403 | credits_exhausted | 조직에 남은 크레딧이 없습니다 | 조직에 크레딧을 충전하세요 |
| 403 | access_denied | org_id 키의 조직이 아니거나, 키에 필요한 범위가 없거나, 이 워크플로를 실행할 수 없을 수 있습니다 | Studio에서 키의 범위와 워크플로 허용 목록을 확인하세요 |
| 404 | entity_not_found | 조직에 해당 워크플로, 프로젝트, 실행 또는 웹훅 엔드포인트가 없거나, 키의 허용 목록 밖의 워크플로 실행입니다 | id를 확인하세요 |
| 409 | idempotency_conflict | 같은 idempotency_key 다른 본문으로 도착했습니다 | 새 작업에는 새 키를 사용하세요 |
| 429 | too_many_requests | 읽기 한도에 도달했습니다 | 기다리세요 Retry-After, 그런 다음 다시 보내세요 |
| 500 | internal_error | 저희 쪽 | 백오프를 적용해 재시도하세요. 그래도 계속되면 다음을 보내 주세요 x-morphic-trace-id |
제한 사항
| 한도 | 기본값 | 참고 |
|---|---|---|
| 크레딧 | 키 자체의 한도 | 모든 키에 공통으로 적용되는 총량과, 선택적 일간 및 월간 상한 — 다음을 참조하세요: 크레딧 한도 |
| 한 실행에 대한 읽기 | 키당 분당 30회 | 실행당 분당 1회 읽기로 충분합니다; wait=45 가 여전히 더 저렴합니다 |
| 전체 실행의 읽기 | 키당 분당 1,200회 | 한 번에 수백 개의 실행을 추적할 여지가 있습니다 |
| 실행당 링크 | 10 | 모든 파일 입력을 합쳐 |
| 실행당 바이트 | 500 MB | 모든 링크를 합쳐 |
| 파일당 바이트 | 입력의 max_bytes | 문서는 최대 100 MB까지 가능하며, 미디어 상한은 입력별로 적용됩니다 |
| 실행 수명 | 24시간 | 까지 완료되지 않은 실행은 expires_at 가 됩니다 만료됨 |
| 웹훅 엔드포인트 | 조직당 10개 | 다른 것을 추가하기 전에 하나를 제거하세요 |
실행 시작은 절대 속도 제한되지 않습니다. 키의 크레딧 한도는 재시도 루프가 사용할 수 있는 금액을 제한하며, idempotency_key 은 재시도를 리플레이로 바꿉니다. 읽기 한도는 우리가 논의한 용량에 대해 요청 시 상향 조정됩니다.
청구
API로 시작한 실행의 크레딧은 키를 소유한 조직에 청구되며, 실행을 시작한 키에 차감됩니다. 관리자는 지출을 다음에서 확인할 수 있습니다: 청구 및 사용량 → 크레딧 활동 는 Studio에서, 각 키의 한도는 다음에서 확인할 수 있습니다: API 키 페이지.
누군가 Studio의 채팅에 들어와 실행을 넘겨받더라도, 실행은 시작한 키에 계속 차감되므로 키의 남은 예산이 전체 실행의 예산입니다.
시작 전에 거부된 실행 — 잘못된 링크이거나 크레딧이 없는 키 또는 조직 — 에는 비용이 들지 않습니다. 도중에 실패한 실행은 완료된 단계에 든 비용만큼은 소모한 것입니다; credits_used 는 실행에서 얼마가 사용되었는지를 나타냅니다.