Introdução
API REST para envio de SMS com autenticação Bearer Token, suporte a Bulk SMS e sistema OTP integrado.
https://api.mozesms.com
Bearer Token
Autenticação segura
Bulk SMS
Até 1000 mensagens
Sistema OTP
Geração automática
SenderID
Nome personalizado
Como Começar
1. Crie uma conta em my.mozesms.com
2. Registre um SenderID no painel
3. Gere sua API Key em Configurações
Autenticação
Todas as requisições requerem Bearer Token no header:
| Header | Valor |
|---|---|
Authorization |
Bearer {seu_token} |
Content-Type |
application/json |
Enviar SMS
POST
/v2/sms/send
Parâmetros
| Campo | Tipo | Descrição |
|---|---|---|
phone |
string | Número com código (258...) |
message |
string | Texto da mensagem |
sender_id |
string | Nome ou número remetente |
Exemplo
- PHP
- cURL
- Python
- Node.js
- C#
- Ruby
- Java
$ch = curl_init('https://api.mozesms.com/v2/sms/send');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer SEU_TOKEN',
'Content-Type: application/json'
],
CURLOPT_POSTFIELDS => json_encode([
'phone' => '258845888195',
'message' => 'Olá, teste de SMS',
'sender_id' => 'MozeSMS'
]),
CURLOPT_RETURNTRANSFER => true
]);
$response = curl_exec($ch);
curl_close($ch);
curl -X POST https://api.mozesms.com/v2/sms/send \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"phone": "258845888195",
"message": "Olá, teste de SMS",
"sender_id": "MozeSMS"
}'
import requests
response = requests.post(
'https://api.mozesms.com/v2/sms/send',
headers={
'Authorization': 'Bearer SEU_TOKEN',
'Content-Type': 'application/json'
},
json={
'phone': '258845888195',
'message': 'Olá, teste de SMS',
'sender_id': 'MozeSMS'
}
)
print(response.json())
const response = await fetch('https://api.mozesms.com/v2/sms/send', {
method: 'POST',
headers: {
'Authorization': 'Bearer SEU_TOKEN',
'Content-Type': 'application/json'
},
body: JSON.stringify({
phone: '258845888195',
message: 'Olá, teste de SMS',
sender_id: 'MozeSMS'
})
});
const data = await response.json();
using System.Net.Http;
using System.Text;
using System.Text.Json;
var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer SEU_TOKEN");
var data = new {
phone = "258845888195",
message = "Olá, teste de SMS",
sender_id = "MozeSMS"
};
var json = JsonSerializer.Serialize(data);
var content = new StringContent(json, Encoding.UTF8, "application/json");
var response = await client.PostAsync(
"https://api.mozesms.com/v2/sms/send",
content
);
var result = await response.Content.ReadAsStringAsync();
require 'net/http'
require 'json'
uri = URI('https://api.mozesms.com/v2/sms/send')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Post.new(uri)
request['Authorization'] = 'Bearer SEU_TOKEN'
request['Content-Type'] = 'application/json'
request.body = {
phone: '258845888195',
message: 'Olá, teste de SMS',
sender_id: 'MozeSMS'
}.to_json
response = http.request(request)
puts response.body
import java.net.http.*;
import java.net.URI;
HttpClient client = HttpClient.newHttpClient();
String json = """{
"phone": "258845888195",
"message": "Olá, teste de SMS",
"sender_id": "MozeSMS"
}""";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.mozesms.com/v2/sms/send"))
.header("Authorization", "Bearer SEU_TOKEN")
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(json))
.build();
HttpResponse response = client.send(
request,
HttpResponse.BodyHandlers.ofString()
);
System.out.println(response.body());
Resposta
{
"status": 200,
"message": "SMS enviado com sucesso",
"sms_id": "12345678"
}
Bulk SMS
POST
/v2/sms/bulk
Envie até 1000 mensagens em uma única requisição.
| Campo | Tipo | Descrição |
|---|---|---|
messages |
array | Lista de objetos com phone e message |
sender_id |
string | Remetente para todas mensagens |
Exemplo
{
"messages": [
{"phone": "258845888195", "message": "Olá João"},
{"phone": "258845888196", "message": "Olá Maria"}
],
"sender_id": "MozeSMS"
}
Sistema OTP
Enviar OTP
POST
/v2/otp/send
| Campo | Tipo | Descrição |
|---|---|---|
phone |
string | Número com código |
length |
integer | Tamanho do código (4-8) |
Verificar OTP
POST
/v2/otp/verify
| Campo | Tipo | Descrição |
|---|---|---|
phone |
string | Número que recebeu OTP |
code |
string | Código recebido |
Códigos OTP expiram em 5 minutos
Códigos de Resposta
| Código | Status | Descrição |
|---|---|---|
200 |
Sucesso | Operação realizada com sucesso |
400 |
Erro | Dados inválidos |
401 |
Não autorizado | Token inválido ou ausente |
402 |
Sem saldo | Créditos insuficientes |
429 |
Limite | Muitas requisições |
500 |
Erro servidor | Erro interno do sistema |
Suporte
suporte@mozesms.com
Telefone
+258 84 588 8195
Portal
my.mozesms.com
+258 84 588 8195