API

REST API · v1

TrustService API v1

Подключите приложение к TrustService: получите список услуг, создайте заказ, заберите SMS, отмените заказ и проверьте баланс. Передавайте API-ключ в заголовке запроса.

Мой аккаунт

Ваш ключ

Ответы в 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

Создать заказ

Создайте заказ с ID услуги. TrustService вернёт ID заказа — по нему проверяйте статус и получайте SMS.

Content-Type: application/json

{"service_id": 123}

GET/api/v1/orders/{id}

Статус заказа и SMS

Статусы: waiting, completed и closed. После получения SMS поле 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 превышен лимит.

API