Crear subcuenta

Agrega información de tus subcuentas, como: Correo electrónico, Contraseña, Número y/o Nombre.

Encabezados
Encabezado Descripción
apikey   Campos obligatorios   Apikey generada a través de la sección de Integraciones.
Atributos
Atributo Descripción Tipo de Dato
email   Obligatorio   Usuario para acceder al panel de smsmasivos.
  Nota 1:   El email debe tener como mínimo 10 y máximo 100 caracteres.
  Text  
password   Obligatorio   Contraseña para acceder a smsmasivos.
  Nota 1:   La contraseña debe tener al menos 10 y máximo 36 caracteres.
  Text  
cellphone   Obligatorio   Número de celular a registrar.
  Nota 1:   Este parámentro debe de existir en smsmasivos.
  Nota 2:   El número de celular debe contener como mínimo 10 y máximo 14 caracteres.
  Number  
name   Opcional   Nombre de la subcuenta a registrar.
  Nota 1:   El nombre debe tener al menos 3 y máximo 250 caracteres
  Text  
lang   Opcional  Idioma de la respuesta. Por defecto   es  .
  es   Español.
  en   Inglés.
  Nota 1:   El idioma solo acepta 2 caracteres.
  Text  
Errores
Código Mensaje
auth_01 Usuario no autorizado
subaccount_02 Correo electrónico con formato incorrecto
subaccount_03 Correo electrónico es muy largo, máximo 100 caracteres
subaccount_04 El campo email es necesario
subaccount_05 Contraseña muy corta, mínimo 10 caracteres
subaccount_06 Contraseña demasiado larga, máximo 36 caracteres
subaccount_07 El campo password es necesario
subaccount_08 Nombre es muy largo, máximo 100 caracteres
subaccount_09 Número con formato incorrecto
subaccount_10 Número de celular muy corto, mínimo 10 caracteres
subaccount_11 Ya existe un usuario con la misma dirección de correo electrónico. Intenta con una cuenta diferente.
subaccount_12 Parámetro cellphone ya se encuentra registrado
subaccount_13, subaccount_14 Error al crear la subcuenta, verifica que los datos estén completos
subaccount_15 Error al asignar al usuario

Crear subcuenta

Para enviar SMS debes hacer una petición a la siguiente dirección:


 POST  https://api.smsmasivos.com.mx/manager/subaccount/add 

Ejemplo para crear subcuenta
                                
curl -X POST "https://api.smsmasivos.com.mx/manager/subaccount/add" -H "apikey: your_apikey_auth" -d "email=your_subaccount_email&password=your_subaccount_password&cellphone=your_subaccount_cellphone"
                                
                            
                                    
$params = array(
"email" => your_subaccount_email,
"password" => your_subaccount_password,
"cellphone" => your_subaccount_cellphone
);
$headers = array(
"apikey: your_apikey_auth"
);
curl_setopt_array($ch = curl_init(), array(
CURLOPT_URL => "https://api.smsmasivos.com.mx/manager/subaccount/add",
CURLOPT_SSL_VERIFYPEER => 0,
CURLOPT_HEADER => 0,
CURLOPT_HTTPHEADER => $headers,
CURLOPT_POST => 1,
CURLOPT_POSTFIELDS => http_build_query($params),
CURLOPT_RETURNTRANSFER => 1
));
$response = curl_exec($ch);
curl_close($ch);

echo json_encode($response);
                                    
                                
                                    
require "net/http"
require "uri"

uri = URI.parse("https://api.smsmasivos.com.mx/manager/subaccount/add")
headers = {
"apikey": your_apikey_auth
}
request = Net::HTTP::Post.new(uri, headers)
request.set_form_data(
"email" => your_subaccount_email,
"password" => your_subaccount_password,
"cellphone" => your_subaccount_cellphone
)
req_options = {
use_ssl: uri.scheme == "https",
}
response = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
http.request(request)
end

puts response.body
                                    
                                
                                    
var request = (HttpWebRequest)WebRequest.Create("https://api.smsmasivos.com.mx/manager/subaccount/add");
var postData = "email=your_subaccount_email&";
postData += "password=your_subaccount_password&";
postData += "cellphone=your_subaccount_cellphone&";
var data = Encoding.ASCII.GetBytes(postData);
Console.WriteLine(postData.ToString());
request.Method = "POST";
request.Headers["apikey"] = your_apikey_auth;
request.ContentType = "application/x-www-form-urlencoded";
request.ContentLength = data.Length;
using (var stream = request.GetRequestStream())
{
stream.Write(data, 0, data.Length);
}
var response = (HttpWebResponse)request.GetResponse();
var responseString = new StreamReader(response.GetResponseStream()).ReadToEnd();

Console.WriteLine(responseString);
                                    
                                
                                    
var request = require("request");

var targetURL = "https://api.smsmasivos.com.mx/manager/subaccount/add"
var response = request.post(
{
url: targetURL,
headers: {
"apikey": your_apikey_auth
},
form: {
"email": your_subaccount_email,
"password": your_subaccount_password,
"cellphone": your_subaccount_cellphone
}
}, (err, res, body) => {
if(err == null){
console.log(body);
}
}
);
                                    
                                
                                    
import requests

targetURL = "https://api.smsmasivos.com.mx/manager/subaccount/add"
headers = {
"apikey":your_apikey_auth
}
data = {
"email" => your_subaccount_email,
"password" => your_subaccount_password,
"cellphone" => your_subaccount_cellphone
}
r = requests.post(url = targetURL, data = data, headers = headers)

print(r.text)
                                    
                                

Respuesta:
{
"success":true,
"message":"Subcuenta creada satisfactoriamente",
"status":200,
"code":"subaccount_01",
"apikey": "XXXXX-XXXXXX-XXXXX-XXX",
"email": "[email protected]"
}
                        

Archivar subcuenta

Agrega información de tus subcuentas, como: Correo electrónico, Contraseña, Número y/o Nombre.

Encabezados
Encabezado Descripción
apikey   Campos obligatorios   Apikey generada a través de la sección de Integraciones.
Atributos
Atributo Descripción Tipo de Dato
email   Obligatorio   Email registrado como subcuenta
  Nota 1:   El email debe tener como mínimo 10 y máximo 100 caracteres.
  Text  
Errores
Código Mensaje
auth_01 Usuario no autorizado
subaccount_02 La subcuenta ya ha sido archivada
subaccount_03 Hubo un error al actualizar la subcuenta
subaccount_04 No se encontró la información de la subcuenta

Archivar subcuenta

Para archivar una subcuenta debes hacer una petición a la siguiente dirección:


 POST  https://api.smsmasivos.com.mx/manager/subaccount/archive 

Ejemplo para archivar subcuenta
                                                
curl -X POST "https://api.smsmasivos.com.mx/manager/subaccount/archive" -H "apikey: your_apikey_auth" -d "email=your_subaccount_email"
                                                
                                            
                                                    
$params = array(
"email" => your_subaccount_email
);
$headers = array(
"apikey: your_apikey_auth"
);
curl_setopt_array($ch = curl_init(), array(
CURLOPT_URL => "https://api.smsmasivos.com.mx/manager/subaccount/archive",
CURLOPT_SSL_VERIFYPEER => 0,
CURLOPT_HEADER => 0,
CURLOPT_HTTPHEADER => $headers,
CURLOPT_POST => 1,
CURLOPT_POSTFIELDS => http_build_query($params),
CURLOPT_RETURNTRANSFER => 1
));
$response = curl_exec($ch);
curl_close($ch);

echo json_encode($response);
                                                    
                                                
                                                    
require "net/http"
require "uri"

uri = URI.parse("https://api.smsmasivos.com.mx/manager/subaccount/archive")
headers = {
"apikey": your_apikey_auth
}
request = Net::HTTP::Post.new(uri, headers)
request.set_form_data(
"email" => your_subaccount_email
)
req_options = {
use_ssl: uri.scheme == "https",
}
response = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
http.request(request)
end

puts response.body
                                                    
                                                
                                                    
var request = (HttpWebRequest)WebRequest.Create("https://api.smsmasivos.com.mx/manager/subaccount/archive");
var postData = "email=your_subaccount_email&";
var data = Encoding.ASCII.GetBytes(postData);
Console.WriteLine(postData.ToString());
request.Method = "POST";
request.Headers["apikey"] = your_apikey_auth;
request.ContentType = "application/x-www-form-urlencoded";
request.ContentLength = data.Length;
using (var stream = request.GetRequestStream())
{
stream.Write(data, 0, data.Length);
}
var response = (HttpWebResponse)request.GetResponse();
var responseString = new StreamReader(response.GetResponseStream()).ReadToEnd();

Console.WriteLine(responseString);
                                                    
                                                
                                                    
var request = require("request");

var targetURL = "https://api.smsmasivos.com.mx/manager/subaccount/archive"
var response = request.post(
{
url: targetURL,
headers: {
"apikey": your_apikey_auth
},
form: {
"email": your_subaccount_email
}
}, (err, res, body) => {
if(err == null){
console.log(body);
}
}
);
                                                    
                                                
                                                    
import requests

targetURL = "https://api.smsmasivos.com.mx/manager/subaccount/archive"
headers = {
"apikey":your_apikey_auth
}
data = {
"email" => your_subaccount_email
}
r = requests.post(url = targetURL, data = data, headers = headers)

print(r.text)
                                                    
                                                

Respuesta:
{
"succes": true,
"message": "Subcuenta archivada correctamente",
"status": 200
}
                                        

Gestión de mensajes

Abonar o descontar créditos a tus subcuentas.

Encabezados
Encabezado Descripción
apikey   Campos obligatorios   Apikey generada a través de la sección de Integraciones.
Atributos
Atributo Descripción Tipo de Dato
email   Obligatorio   Email registrado como subcuenta
  Nota 1:   El email debe tener como mínimo 10 y máximo 100 caracteres.
  Text  
type   Obligatorio   Tipo de transacción a realizar.
  1   Agregar créditos.
  2   Descontar créditos.
  Nota 1:   El tipo solo acepta un caracter.
  Number  
credits   Obligatorio   Total de créditos a modificar.
  Nota 1:   Los créditos deben tener como mínimo 1 caracter y como máximo la cantidad de créditos con los que cuentas.
  Number  
lang   Opcional  Idioma de la respuesta. Por defecto   es  .
  es   Español.
  en   Inglés.
  Nota 1:   El idioma solo acepta 2 caracteres.
  Text  
Errores
Código Mensaje
auth_01 Usuario no autorizado
subaccount_credits_01 Tipo no definido
subaccount_credits_02 El campo email es necesario
subaccount_credits_03 La cantidad de créditos a recargar es requerida
subaccount_credits_04 Los créditos no deben de contener decimales
subaccount_credits_05 Los créditos deben de ser mayor a 0
subaccount_credits_06, subaccount_credits_09 Créditos actualizados correctamente
subaccount_credits_07, subaccount_credits_10 Error al asignar los créditos
subaccount_credits_08, subaccount_credits_11 Créditos insuficientes
subaccount_credits_12 Tipo de transacción invalido
dist_credits_01 No se encontró la información del usuario para asignar créditos
subaccount_13 Error al asignar al usuario

Gestión de mensajes

Para gestionar los mensajes debes hacer una petición a la siguiente dirección:


 POST  https://api.smsmasivos.com.mx/manager/subaccount/credits/manage 

Ejemplo para consultar una apikey
                                                
curl -X POST "https://api.smsmasivos.com.mx/manager/subaccount/credits/manage" -H "apikey: your_apikey_auth" -d "type=your_transaction_type&credits=total_transaction_credits"
                                                
                                            
                                                                                        
$params = array(
"type" => your_transaction_type,
"credits" => total_transaction_credits
);
$headers = array(
"apikey: your_apikey_auth"
);
curl_setopt_array($ch = curl_init(), array(
CURLOPT_URL => "https://api.smsmasivos.com.mx/manager/subaccount/credits/manage",
CURLOPT_SSL_VERIFYPEER => 0,
CURLOPT_HEADER => 0,
CURLOPT_HTTPHEADER => $headers,
CURLOPT_POST => 1,
CURLOPT_POSTFIELDS => http_build_query($params),
CURLOPT_RETURNTRANSFER => 1
));
$response = curl_exec($ch);
curl_close($ch);

echo json_encode($response);
                                                    
                                                
                                                    
require "net/http"
require "uri"

uri = URI.parse("https://api.smsmasivos.com.mx/manager/subaccount/credits/manage")
headers = {
"apikey": your_apikey_auth
}
request = Net::HTTP::Post.new(uri, headers)
request.set_form_data(
"type" => your_transaction_type,
"credits" => total_transaction_credits
)
req_options = {
use_ssl: uri.scheme == "https",
}
response = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
http.request(request)
end

puts response.body
                                                    
                                                
                                                    
var request = (HttpWebRequest)WebRequest.Create("https://api.smsmasivos.com.mx/manager/subaccount/credits/manage");
var postData = "type=your_transaction_type&";
postData += "credits=total_transaction_credits&";
var data = Encoding.ASCII.GetBytes(postData);
Console.WriteLine(postData.ToString());
request.Method = "POST";
request.Headers["apikey"] = your_apikey_auth;
request.ContentType = "application/x-www-form-urlencoded";
request.ContentLength = data.Length;
using (var stream = request.GetRequestStream())
{
stream.Write(data, 0, data.Length);
}
var response = (HttpWebResponse)request.GetResponse();
var responseString = new StreamReader(response.GetResponseStream()).ReadToEnd();

Console.WriteLine(responseString);
                                                    
                                                
                                                                                        
var request = require("request");

var targetURL = "https://api.smsmasivos.com.mx/manager/subaccount/credits/manage"
var response = request.post(
{
url: targetURL,
headers: {
"apikey": your_apikey_auth
},
form: {
"type" => your_transaction_type,
"credits" => total_transaction_credits
}
}, (err, res, body) => {
if(err == null){
console.log(body);
}
}
);
                                                    
                                                
                                                                                        
import requests

targetURL = "https://api.smsmasivos.com.mx/manager/subaccount/credits/manage"
headers = {
"apikey":your_apikey_auth
}
data = {
"type" => your_transaction_type,
"credits" => total_transaction_credits
}
r = requests.post(url = targetURL, data = data, headers = headers)

print(r.text)
                                                    
                                                

Respuesta:
{
"success":true,
"message":"Créditos actualizados correctamente.",
"status":200,
"code":"subaccount_credits_09"
}