Skip to main content

​
Qué es esta API

La API SMS de json.pe permite disparar el envío de mensajes SMS hacia un número de destino. A diferencia de un proveedor SMS en la nube que entrega el mensaje desde sus propios canales, este flujo usa el teléfono móvil del cliente como origen real del SMS: la petición HTTP llega al servicio y el dispositivo Android vinculado es quien envía el mensaje a través de la red de su operadora móvil. URL base: https://api.sms.json.pe Es un producto aparte de la API Consulta y de la API WhatsApp: la URL base, el token y los límites pueden ser distintos.

​
App en el celular del cliente

Para que los SMS puedan enviarse desde el dispositivo del cliente, debe instalarse la aplicación oficial en Google Play: Descargar la app en Play Store Sin la app instalada, configurada y conectada según el flujo del producto, las llamadas a la API no podrán completar el envío desde ese terminal.

​
Requisitos del dispositivo

La integración está pensada para dispositivos Android. No está soportado el mismo mecanismo en iOS u otros sistemas para este producto.
Cada SMS sale por el canal de voz/datos del operador del chip que lleva el teléfono. El dispositivo debe poder enviar SMS de forma nativa: en la práctica eso implica tener saldo, un plan que incluya SMS, o las condiciones que exija la operadora para que el mensaje se envíe con éxito. Si no hay cobertura, saldo o permisos para SMS, el envío puede fallar aunque la API responda correctamente en la capa HTTP.
Todas las peticiones a https://api.sms.json.pe deben incluir el header Authorization: Bearer TU_TOKEN. Obtén o gestiona el token desde el panel json.pe, igual que en otros productos json.pe. No publiques el token en repositorios abiertos.

​
Flujo resumido

1

1. Cuenta y token

Activa el producto en el panel, genera el token Bearer y guárdalo de forma segura.
2

2. App en Android del cliente

Instala la app desde Play Store en el teléfono que actuará como emisor de los SMS y completa la vinculación según las indicaciones del producto.
3

3. Llamada POST /send

Envía POST https://api.sms.json.pe/send con Content-Type: application/json, el header Authorization: Bearer ... y un JSON con number y message.
Para el detalle de campos y ejemplos, abre la página Enviar SMS.