공통 요청 파라미터¶
이 문서에서는 External API의 공통 요청 파라미터를 소개합니다.
공통 요청 헤더(Header)¶
| 파라미터 이름 | 필수 | 예시 | 설명 |
|---|---|---|---|
| Content-Type | 요청 본문이 있을 때 | application/json | 요청 내용과 일치해야 합니다. JSON 요청에는 application/json을 사용하고, 업로드에는 boundary가 포함된 multipart/form-data를 사용하며, GET 요청에 본문이 없으면 생략할 수 있습니다. |
| X-Df-Access-Key | 예 | e243xxxxxxxx | 방문자 식별자입니다. 이 값은 「서비스 구성 항목」에 설명된 accessKey입니다. |
| X-Df-Timestamp | 예 | 1711701527 | 요청이 시작된 시점의 초 단위 타임스탬프입니다. 허용되는 오차의 절댓값은 「서비스 구성 항목」에 설명된 timeliness 값이며, 이 시간 범위를 초과하면 400 ft.IllegalTimestamp가 반환됩니다. |
| X-Df-SVersion | 설정 권장 | v20240417 | 아래 예시에서는 v20240417을 사용합니다. 이 버전을 지정하지 않으면 서버는 이전 버전 호환 알고리즘을 사용합니다. |
| X-Df-Nonce | 예 | 5931f3059ba244dxxx | 요청마다 생성되는 임시 난수 값입니다. |
| X-Df-Signature | 예 | <signature> |
서명 결과 값입니다. |
오류 응답은 공통 오류 정의를 참조하세요.