API TrustService

REST API · v1

TrustService API v1

Use a API para listar serviços, criar um pedido, verificar um SMS, cancelar um pedido em espera e ler seu saldo. Habilite o acesso à API na sua conta e envie a chave em um cabeçalho de solicitação, não no URL.

Minha conta

Sua chave de API

A API v1 retorna JSON e permite até 60 solicitações por minuto para cada usuário.

X-API-Key: YOUR_API_KEY
Authorization: Bearer YOUR_API_KEY

GET/api/v1/services

Listar serviços

O parâmetro country é opcional. Cada resultado contém um ID, país, nome, preço do cliente e moeda.

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

POST/api/v1/orders

Crie um pedido

A TrustService seleciona automaticamente o melhor número disponível para o seu pedido. Se a primeira opção não estiver disponível, o sistema verifica imediatamente a próxima pelo mesmo preço exibido. Não é preciso repetir o pedido.

Content-Type: application/json

{"service_id": 123}

GET/api/v1/orders/{id}

Status do pedido e SMS

Os status possíveis são aguardando, concluído e fechado. Após a chegada de um SMS, o campo mensagem contém seu texto.

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

POST/api/v1/orders/{id}/cancel

Cancelar um pedido

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

GET/api/v1/balance

Equilíbrio

https://trustservice.io/api/v1/balance

HTTP4xx / 5xx

Erros

A API usa códigos HTTP padrão: 401 chave inválida ou desativada, 402 saldo insuficiente, 404 pedido não encontrado, 409 pedido ou cancelamento com falha, 422 serviço inválido e 429 limite de taxa excedido.