API

REST API · v1

TrustService API v1

API 可列出服务、创建订单、检查短信、取消等待中的订单并查询余额。请在请求头而不是 URL 中传递密钥。

您的密钥

API v1 返回 JSON,每位用户每分钟最多 60 次请求。

X-API-Key: YOUR_API_KEY
Authorization: Bearer YOUR_API_KEY
GET/api/v1/services

获取服务列表

country 参数可选。结果包含 ID、国家、名称、客户价格和币种。

https://trustservice.io/api/v1/services?country=US
POST/api/v1/orders

创建订单

TrustService 会自动为你的请求选择最佳可用号码。如果首个选项暂不可用,系统会立即以相同的显示价格检查下一个选项,无需手动重复下单。

Content-Type: application/json

{"service_id": 123}
GET/api/v1/orders/{id}

订单状态与短信

状态包括 waitingcompletedclosed。收到短信后,内容位于 message

https://trustservice.io/api/v1/orders/{order_id}
POST/api/v1/orders/{id}/cancel

取消订单

https://trustservice.io/api/v1/orders/{order_id}/cancel
GET/api/v1/balance

余额

https://trustservice.io/api/v1/balance
HTTP4xx / 5xx

错误

HTTP 状态:401 密钥无效,402 余额不足,404 未找到,409 操作失败,422 服务无效,429 超出频率限制。