API REST v1
Documentação da API pública
Autenticação
Todas as requisições devem incluir o header:
Authorization: Bearer tmx_seu_token_aqui
Gere seu token em Meu Perfil. Rate limit: 60 req/min.
POST
/api/v1/sms
Enviar SMS (máx. 160 caracteres)
Body:
{"number": "5511999999999", "message": "Hello", "interaction": false}
Resposta:
{"success": true, "id": "abc123", "mtId": "12345"}
POST
/api/v1/sms
Enviar SMS em massa (máx. 1000 números)
Body:
{"numbers": ["5511999999999", "5511888888888"], "message": "Hello"}
Resposta:
{"success": true, "sent": 2, "failed": 0, "errors": []}
GET
/api/v1/balance
Consultar saldo de créditos
Resposta:
{"credits": 150}
GET
/api/v1/history?limit=20&offset=0
Histórico de SMS (limit máx. 100)
Resposta:
{"items": [...], "total": 100, "limit": 20, "offset": 0}
GET
/api/v1/status?id=smsId
Status de entrega
Resposta:
{"id": "...", "number": "...", "status": "sent", "mtId": "...", "deliveryStatus": "1", "carrierName": "...", "createdAt": "..."}
Códigos de Status
200 Sucesso
400 Requisição inválida
401 Token inválido ou ausente
404 Recurso não encontrado
405 Método não permitido
429 Rate limit excedido
TrackMAX SMS v2.0.1