API 키 인증 (Basic Auth)
볼타 API는 HTTP Basic Authentication을 사용합니다. API 키를 Base64로 인코딩하여 Authorization 헤더에 포함합니다.
Authorization: Basic {Base64(API_KEY:)}
API 키 뒤에 콜론(:)을 붙인 후 Base64 인코딩해야 합니다.
# API 키가 test_abc123인 경우
# Base64("test_abc123:") = dGVzdF9hYmMxMjM6
curl -X POST https://xapi.bolta.io/v1/taxInvoices/issue \
-H "Authorization: Basic dGVzdF9hYmMxMjM6" \
-H "Content-Type: application/json"
테스트 키 vs 라이브 키
| 구분 | 접두사 | 용도 |
|---|
| 테스트 키 | test_ | 샌드박스 환경, 국세청 미연동 |
| 라이브 키 | live_ | 실제 환경, 국세청 연동 |
API 키 발급 방법은 API 키 가이드를 참고하세요.
요청 헤더
Customer-Key
고객(공급자)을 식별하는 헤더입니다. 고객 생성 API로 발급받은 customerKey 값을 전달합니다.
Customer-Key: customer_bf8paz
customerKey는 API 키 단위로 독립적으로 관리됩니다. 테스트 키와 라이브 키 각각에서 생성한 customerKey는 서로 다른 값이며, 상호 호환되지 않습니다.
Client-Reference-Id
요청의 멱등성(idempotency)을 보장하기 위한 헤더입니다. 동일한 Client-Reference-Id로 중복 요청하면 기존 결과가 반환됩니다.
Bolta-Client-Reference-Id: your-unique-reference-id
