Comece aqui
Sua primeira solicitação em quatro etapas
Listar seus celulares conectados e copiar o alvo SID.
Crie uma notificação com um título e uma mensagem.
Pesquise o endpoint da lista por SID.
Use os carimbos de data/hora distribued_status e GMT para rastrear a distribuição.
Official mobile application
The secure bridge between your phone, dashboard and API.
SMS and call operations pass through the official SMSMobileAPI app installed on your connected phone. The app securely pairs the device with your account, synchronizes authorized events and links the mobile network to the dashboard and REST API.
- Signed releases distributed through the official Google Play and Apple App Store listings
- Google and Apple platform review, signing and distribution controls
- Secure device pairing, HTTPS transport and authenticated API access
- Only the permissions required for the mobile features you enable
Autenticação
Mantenha as credenciais no seu servidor
Os endpoints de notificação usam o parâmetro apikey. Um telefone de destino é identificado por sid ao enviar e por sid ou sidentifiant ao listar.
POST · GET
Enviar uma notificação
https://api.smsmobileapi.com/notification/sendCria uma notificação interna para um dispositivo conectado.
Use-o para alertas operacionais que devem aparecer em um telefone gerenciado.
Parâmetros
| Nome | Tipo | Requisito | Descrição |
|---|---|---|---|
apikey |
corda | Obrigatório | Sua chave de API. |
sid |
corda | Obrigatório | SID móvel de destino. |
title |
corda | Opcional | Título da notificação; o padrão é Notificação. |
message |
corda | Obrigatório | Conteúdo da notificação. |
type |
corda | Opcional | Tipo de notificação; o padrão é notificação. |
Exemplo de solicitação
curl -X POST "https://api.smsmobileapi.com/notification/send" \
-d "apikey=YOUR_API_KEY" \
-d "sid=TARGET_SIDENTIFIANT" \
--data-urlencode "title=Order ready" \
--data-urlencode "message=Order #1042 is ready for collection."Exemplo de resposta
{
"success": true,
"message": "Notification created.",
"id": 22087,
"apikey": "YOUR_API_KEY",
"sid": "508b004b4aadacc4"
}Deseja executar esta solicitação?Conecte sua chave de API na parte superior da página para desbloquear o interativo testador.
Chave de conexão ↑- A criação e a distribuição são eventos separados. Use o endpoint da lista para verificar a entrega no dispositivo.
PEGAR
Listar notificações
https://api.smsmobileapi.com/notification/list/Retorna até 200 notificações ordenadas da mais recente para a mais antiga.
Use-a para monitorar a distribuição e criar um histórico de notificações.
Parâmetros
| Nome | Tipo | Requisito | Descrição |
|---|---|---|---|
apikey |
corda | Obrigatório | Sua chave de API. |
sidentifiant |
corda | Opcional | Filtre por celular de destino. |
sid |
corda | Opcional | Alias de sidentifiant. |
distribued |
0 | 1 | Opcional | 1 para distribuído, 0 para não distribuído. |
date_from |
AAAA-MM-DD | Opcional | Data de início. |
date_to |
AAAA-MM-DD | Opcional | Data de término. |
Exemplo de solicitação
curl "https://api.smsmobileapi.com/notification/list/?apikey=YOUR_API_KEY&sidentifiant=TARGET_SIDENTIFIANT&distribued=1"Exemplo de resposta
{
"success": true,
"count": 1,
"data": [{
"sidentifiant": "508b004b4aadacc4",
"title": "Order ready",
"message": "Order #1042 is ready for collection.",
"distribued": "1",
"distribued_status": "distributed",
"distributed_at_gmt": "2026-03-18 10:18:30",
"distributed_at_unix": 1773829110,
"sent_at_gmt": "2026-03-18 10:15:03",
"sent_at_unix": 1773828903
}]
}Deseja executar esta solicitação?Conecte sua chave de API na parte superior da página para desbloquear o interativo testador.
Chave de conexão ↑- Todos os carimbos de data/hora enviados e distribuídos são GMT.
Solução de problemas
Erros e novas tentativas seguras
Leia o status HTTP e o campo de erro JSON antes de tentar novamente. Não tente novamente falhas de validação ou autenticação sem primeiro corrigir a solicitação.
| HTTP | Código | O que fazer |
|---|---|---|
| 400 | Missing required param | apikey, sid ou mensagem está faltando. |
| 400 | Invalid date format | Use AAAA-MM-DD para data_de e date_to. |
| 400 | Invalid distribued value | Apenas 0 ou 1 é aceito. |
| 500 | DB connection / query failed | O serviço de notificação não pôde concluir a operação. |
Precisar de ajuda?
Traga o contexto da solicitação, não seus segredos.
Compartilhe o endpoint, o carimbo de data/hora, o status HTTP e a resposta limpa. Nunca inclua chaves de API, tokens ou conteúdo de mensagens privadas.
