2. 샌드박스 API 키 발급받기

키 발급하기

1. 샌드박스 대시보드에서 Settings > Developer Settings로 이동합니다.
2. 우측 상단의 Generate API Key를 클릭합니다.
3. 키를 복사해 안전한 곳(시크릿 매니저 또는 환경변수 — 소스 코드에는 절대 금지)에 보관합니다.

발급한 키는 Developer Settings에서 언제든 다시 확인할 수 있습니다. 키가 노출됐을 가능성이 있다면 그 자리에서 삭제하고 새로 발급하세요.

샌드박스 키는 항상 sodagift_test_로, 프로덕션 키는 sodagift_live_로 시작하므로 어느 환경의 키인지 한눈에 구분할 수 있습니다. 예제의 YOUR-API-KEY 자리에는 접두사를 포함한 키 전체를 붙여넣으세요.

키 사용하기

모든 요청의 SODA-API-KEY 헤더에 키를 담습니다:

curl --request GET \
     --url 'https://biz-sandbox-api.sodagift.com/v1/accounts/balance' \
     --header 'SODA-API-KEY: YOUR-API-KEY' \
     --header 'accept: application/json'

샌드박스 잔액이 응답으로 옵니다 — 신규 계정은 $5,000의 테스트 크레딧으로 시작합니다:

{
  "amount": 5000.0,
  "currency": "USD",
  "payment_method": "PREPAID"
}

키가 없거나 잘못된 경우 API는 401과 빈 응답 바디를 반환합니다. 자세한 내용은 인증을 참고하세요.

다음: 첫 리워드 발송하기 →