요청 제한(Rate Limit)과 멱등성

요청 제한

키 단위로 초당 요청 수가 제한됩니다. 응답 헤더로 현재 한도를 확인할 수 있습니다.

초과하면 429 rate_limit_error가 반환됩니다. Retry-After 헤더만큼 기다린 뒤 재시도하세요.

멱등성(Idempotency)

네트워크 오류로 같은 생성 요청을 두 번 보내도 문서가 중복 생성되지 않도록 Idempotency-Key를 보냅니다.

curl https://api.pactery.com/v1/documents \
  -H "Authorization: Bearer sk_live_..." \
  -H "Idempotency-Key: order-2026-0605-0001" \
  -H "Content-Type: application/json" \
  -d '{ "title": "..." }'

같은 키로 들어온 반복 요청은 최초 응답을 그대로 돌려줍니다(24시간 보관). 키는 요청마다 고유해야 합니다.