https://api.budandan.com/v1
X-API-KEY: YOUR_ACCESS_KEY
X-Timestamp: 2025-03-13T10:00:00Z
Content-Type: application/json
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"}}'
-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
}
}
"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"}}'
-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
}
}
"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"
}
}
"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"
}
}
"message": "Success",
"time": 1777193575839,
"data": {
"balance": 12345.67,
"currency": "USD"
}
}
| Code | ||
|---|---|---|
| 1001 | ||
| 1002 | ||
| 1003 | ||
| 1004 | ||
| 1005 | ||
| 1006 | ||
| 429 | ||
| 400 | ||
| 2001 |