https://api.budandan.com/v1

X-API-KEY: YOUR_ACCESS_KEY
X-Timestamp: 2025-03-13T10:00:00Z
Content-Type: application/json

POST/sms/send
POST/sms/wsend
GET/sms/status?message_id={message_id}
GET/account/balance

POST /sms/send

phone string
template_id string
params object

curl
curl -X POST https://api.budandan.com/v1/sms/send
-H "X-API-KEY: YOUR_ACCESS_KEY"
-H "X-Timestamp: 2025-03-13T10:00:00Z"
-H "Content-Type: application/json"
-form-data '{"phone":"13800138000","template_id":"SMS_123","params":{"code":"382910"}}'

{
 "code": 200,
 "message": "Success",
 "time": 1777193575841,
 "data": {
  "message_id": "S20260426165255779",
  "phone": "85413696913942",
  "status": "delivered",
  "report_time": 1777193575841
 }
}

POST /sms/wsend

code string
phone string
template_id string
params object

curl
curl -X POST https://api.budandan.com/v1/sms/wsend
-H "X-Access-Key: YOUR_ACCESS_KEY"
-H "X-Timestamp: 2025-03-13T10:00:00Z"
-H "Content-Type: application/json"
-form-data '{"code":86,"phone":"13800138000","template_id":"SMS_123","params":{"code":"382910"}}'

{
 "code": 200,
 "message": "Success",
 "time": 1777193575841,
 "data": {
  "message_id": "S20260426165255779",
  "phone": "85413696913942",
  "status": "delivered",
  "report_time": 1777193575841
 }
}

GET /sms/status

GET https://api.budandan.com/v1/sms/status?message_id=MSG20250313123456789

{
 "code": 200,
 "message": "Success",
 "time": 1777193575839,
 "data": {
  "message_id": "S20260426165255779",
  "phone": 85233234234,
  "status": "failed", //pending,delivered
  "report_time": 1777193575839,
  "remark": "Insufficient account balance"
 }
}

GET /account/balance

GET https://api.budandan.com/v1/sms/balance

{  "code": 200,
 "message": "Success",
 "time": 1777193575839,
 "data": {
  "balance": 12345.67,
  "currency": "USD"
 }
}

Code
1001
1002
1003
1004
1005
1006
429
400
2001