문서 본문으로 이동
문서요청과 오류

요청과 오류.

요청 형식

읽기는 GET, 쓰기는 POST와 Content-Type: application/json을 사용합니다. 선언되지 않은 필드는 거부됩니다. 응답은 객체나 배열을 직접 반환합니다.

재시도

같은 작업을 재시도할 때 requestKey와 매개변수를 유지하세요. 202 또는 pending:true는 완료가 아닙니다. taskKey, 결제 또는 주문을 조회하고 불확실한 결과 때문에 다시 구매하지 마세요.

오류

HTTP 상태와 결과를 함께 확인하세요. 지원되지 않는 기능이 HTTP 200과 supported:false를 반환할 수 있습니다. 오류 문자열은 고정된 코드가 아닙니다.

요청 예시
{ "error": "invalid request" }

요청 제한

HTTP와 MCP는 각각 IP와 프로세스별 분당 120회입니다. HTTP 지갑 인증은 추가로 분당 10회입니다. 429에는 Retry-After: 60이 포함됩니다.

페이지와 금액

기록은 불투명 커서, 메시지는 페이지당 8개, 이벤트는 10개입니다. USD 잔액과 견적은 정수 센트 문자열이고 카탈로그는 소수 달러 문자열입니다.

파괴적 작업

각 엔드포인트의 경고를 확인하세요. AI 종료와 재설치에는 지갑 동의가 필요합니다. 갱신은 아직 연동되지 않았으며 자동 갱신 설정만으로 서비스가 연장되지 않습니다.