계정

잔액 및 비용 예상

GET/v1/balance

현재 USD 잔액.

curl https://bulksmsapi.cc/v1/balance \
  -H "Authorization: Bearer $BULKSMSAPI_KEY"
200 OKJSON
{
  "object": "balance",
  "balance": "184.32950",
  "currency": "USD"
}

예상

POST/v1/estimates

POST /v1/batches와 동일한 본문을 받아 비용을 반환해요. 아무것도 전송되지 않고, 요금도 청구되지 않아요.

curl https://bulksmsapi.cc/v1/estimates \
  -H "Authorization: Bearer $BULKSMSAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Doors open at 18:00 tonight.", "to": ["+14155550123", "+447400123456", "+447400123456", "12"]}'
200 OKJSON
{
  "object": "estimate",
  "recipients": 2,
  "set_aside": [
    { "to": "+447400123456", "reason": "duplicate" },
    { "to": "12", "reason": "invalid_number" }
  ],
  "encoding": "GSM-7",
  "segments": 2,
  "max_segments": 1,
  "cost": "0.01294",
  "currency": "USD",
  "by_country": [
    { "country": "US", "recipients": 1, "segments": 1, "cost": "0.00507" },
    { "country": "GB", "recipients": 1, "segments": 1, "cost": "0.00787" }
  ]
}

부족함

잔액보다 비용이 더 많이 드는 요청은 402 top_up_required 오류와 함께 두 금액을 메시지로 반환하며, 아무것도 전송되지 않아요. 대량 배치 전에 잔액을 확인하거나 먼저 예상 비용을 계산하고, 콘솔에서 충전하세요.

잔액 및 비용 예상 | BulkSMSAPI 문서