인증 - 볼타 사용 가이드

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 키 가이드를 참고하세요.

요청 헤더

Client-Reference-Id

요청의 멱등성(idempotency)을 보장하기 위한 헤더입니다. 동일한 Client-Reference-Id로 중복 요청하면 기존 결과가 반환됩니다.

Bolta-Client-Reference-Id: your-unique-reference-id

네트워크 오류 등으로 응답을 받지 못한 경우, 같은 ID로 재요청하면 중복 발행을 방지할 수 있습니다.

API 소개

API 가이드

사용 사례

SDK/노코드 연동

인증

API 키 인증 (Basic Auth)

테스트 키 vs 라이브 키

요청 헤더

Client-Reference-Id

​API 키 인증 (Basic Auth)

​테스트 키 vs 라이브 키

​요청 헤더

​Client-Reference-Id

API 키 인증 (Basic Auth)

테스트 키 vs 라이브 키

요청 헤더

Client-Reference-Id