> ## Documentation Index
> Fetch the complete documentation index at: https://docs.json.pe/llms.txt
> Use this file to discover all available pages before exploring further.

# Introducción

> API SMS json.pe (api.sms.json.pe): envío de SMS desde el celular Android del cliente, app Play Store com.leroik.sms, saldo de operadora y autenticación Bearer.

## Qué es esta API

La **API SMS** de [json.pe](https://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](https://play.google.com/store/apps/details?id=com.leroik.sms)

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

<AccordionGroup>
  <Accordion title="Solo Android">
    La integración está pensada para **dispositivos Android**. No está soportado el mismo mecanismo en iOS u otros sistemas para este producto.
  </Accordion>

  <Accordion title="Saldo o plan de la operadora">
    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.
  </Accordion>

  <Accordion title="Token Bearer">
    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](https://app.json.pe/login), igual que en otros productos json.pe. No publiques el token en repositorios abiertos.
  </Accordion>
</AccordionGroup>

***

## Flujo resumido

<Steps>
  <Step title="1. Cuenta y token">
    Activa el producto en el panel, genera el **token Bearer** y guárdalo de forma segura.
  </Step>

  <Step title="2. App en Android del cliente">
    Instala la app desde [Play Store](https://play.google.com/store/apps/details?id=com.leroik.sms) en el teléfono que actuará como **emisor** de los SMS y completa la vinculación según las indicaciones del producto.
  </Step>

  <Step title="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`.
  </Step>
</Steps>

Para el detalle de campos y ejemplos, abre la página **[Enviar SMS](/api-sms/endpoint/send)**.

***

## Sobre json.pe

Esta documentación pertenece a **[json.pe](https://json.pe)**, la plataforma líder de APIs para desarrolladores en Perú. Ofrecemos consultas oficiales de DNI, RUC, placa, SOAT, licencia de conducir, integración WhatsApp y envío SMS con alta disponibilidad y soporte experto.

<CardGroup cols={2}>
  <Card title="Sitio web oficial" icon="globe" href="https://json.pe">
    Conoce planes, precios y todos los productos en json.pe
  </Card>

  <Card title="Crear cuenta gratis" icon="user-plus" href="https://json.pe/signup">
    Regístrate y genera tu token Bearer en minutos
  </Card>

  <Card title="Panel de control" icon="gauge" href="https://app.json.pe/login">
    Gestiona tokens, consumo y facturación
  </Card>

  <Card title="Soporte técnico" icon="headset" href="mailto:soporte@json.pe">
    Escríbenos a [soporte@json.pe](mailto:soporte@json.pe)
  </Card>
</CardGroup>