개발자 참고자료

요청 헤더

모든 API 요청에는 인증이 필요합니다. 무료로 가입하여 API 키와 월 10,000개의 무료 크레딧을 받으세요.

요청 헤더

모든 API 요청에는 인증이 필요합니다. 무료로 가입하여 API 키와 월 10,000개의 무료 크레딧을 받으세요.

  • Content-Type: application/json (POST 요청에 필수)
  • Accept: application/json (선택 사항이지만 권장됨)
  • X-API-Key: API 키(무료로 다음에서 받을 수 있습니다 /dashboard)
  • Authorization: Bearer your-api-key (X-API-Key의 대체 옵션)
  • Idempotency-Key: 선택 사항이며, 크레딧이 차감되는 POST 요청에 사용합니다. 24시간 이내에 같은 키로 동일한 요청을 다시 시도하면 저장된 응답이 Idempotent-Replayed: true와 함께 반환되며 추가 요금은 부과되지 않습니다. 다른 요청에 키를 재사용하면 422 IDEMPOTENCY_KEY_REUSED가 반환되고, 첫 번째 요청이 아직 실행 중일 때 중복 요청을 보내면 409 IDEMPOTENCY_IN_PROGRESS가 반환됩니다. 1 MiB를 초과하는 응답과 환불된 오류는 저장되지 않으므로 재시도가 정상적으로 실행됩니다. 키는 UUID와 같은 1~255자의 인쇄 가능한 ASCII 문자입니다.
  • DomScan-Naming: 선택 사항입니다. snake를 지정하면 camelCase 응답 키가 모두 snake_case로 반환되며, naming=snake와 동일합니다. 둘 다 전송하면 쿼리 매개변수가 우선합니다. snake_case 키를 참고하세요.