API

REST API · v1

TrustService API v1

La API permite listar servicios, crear pedidos, consultar SMS, cancelar un pedido en espera y ver el saldo. Envía la clave en la cabecera, no en la URL.

Mi cuenta

Tu clave

API v1 devuelve JSON y admite 60 solicitudes por minuto y usuario.

X-API-Key: YOUR_API_KEY
Authorization: Bearer YOUR_API_KEY

GET/api/v1/services

Listar servicios

El parámetro country es opcional. La respuesta incluye ID, país, nombre, precio final y moneda.

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

POST/api/v1/orders

Crear pedido

TrustService selecciona automáticamente el mejor número disponible para tu solicitud. Si la primera opción no está disponible, el sistema comprueba de inmediato la siguiente con el mismo precio mostrado. No tienes que repetir el pedido.

Content-Type: application/json

{"service_id": 123}

GET/api/v1/orders/{id}

Estado del pedido y SMS

Estados posibles: waiting, completed y closed. El SMS recibido aparece en message.

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

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

Cancelar pedido

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

GET/api/v1/balance

Saldo

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

HTTP4xx / 5xx

Errores

Códigos HTTP: 401 clave inválida, 402 saldo insuficiente, 404 no encontrado, 409 operación fallida, 422 servicio inválido y 429 límite superado.

API