인증
모든 API 요청은 Bearer Token 방식의 API 키로 인증합니다. 도메인별로 사용하는 키의 종류가 다릅니다.
API 키 형식
| 필드 | 타입 | 필수 | 제한 | 예시 |
|---|---|---|---|---|
ak_live_xxxxxxxxxxxxxBank API, PIN API 공용 키 | string | 필수 | — | ak_live_9f2c... |
em_live_xxxxxxxxxxxxxEmail API 전용 키 | string | 필수 | — | em_live_7ba1... |
인증 헤더
발급받은 API 키는 다음과 같이 Authorization 헤더에 Bearer Token으로 담아 전송합니다.
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Accept: application/json실제 요청 헤더 예시입니다.
Authorization: Bearer ********
Content-Type: application/json
Accept: application/json키 종류와 호환성
- Bank API와 PIN API는 같은 종류의 키(ak_live_)를 함께 사용합니다.
- Email API는 별도의 키(em_live_)를 사용하며, Bank/PIN 키로 Email API를 호출할 수 없습니다.
- 잘못된 종류의 키로 요청하면
403 api_key_wrong_type오류가 반환됩니다.
키 보안
문서에 표시된 API 키는 모두 예시이며 실제로 작동하지 않습니다. 실제 키는 대시보드에서 발급 후 서버 환경 변수에만 저장하세요.