# Generador de solicitudes API.

- URL canónica: https://www.broadnet.me/es/tools/api-request-builder
- Idioma: es
- Última actualización: 2026-10-21
- Editor: BroadNet (https://www.broadnet.me)
- Versión Markdown de la página, generada a partir de la página publicada.

Herramienta gratuita para desarrolladores · funciona en tu navegador

Rellena los campos y observa cómo se construye en directo una solicitud SMS de BroadNet correcta: POST /sms/sendSms con un token Bearer y un cuerpo JSON, además de fragmentos listos para copiar en cURL, Node, Python y con el TypeScript SDK. La API HTTP heredada también está disponible, para integraciones existentes de la era SMPP. La herramienta construye la solicitud; nunca la envía.

API

Prueba un ejemplo

Campos de la solicitud

obligatorio

El token de acceso a la API de tu cuenta de BroadNet. Guárdalo en una variable de entorno (BROADNET_TOKEN), nunca en el código fuente.

obligatorio

El ID de remitente aprobado que ve el destinatario.

obligatorio

Dígitos con el código de país y sin + inicial, p. ej. 447700900123.

obligatorio

32 carácteres en el cuerpo del mensaje

Autenticación — token Bearer

La REST API autentica cada llamada con un encabezado Authorization: Bearer que lleva el token de acceso de tu cuenta. Las credenciales nunca van en la URL ni en el cuerpo JSON. Las integraciones nuevas deben usar esta API.

Cuerpo JSON

POST · api.broadnet.me/sms/sendSms

```
{
  "senderId": "BroadNet",
  "destinationNumber": "447700900123",
  "message": "Your verification code is 482913",
  "messageType": "TEXT"
}
```

Fragmentos listos para copiar

POST · api.broadnet.me/sms/sendSms

Vista previa de la solicitud

```
1curl -X POST https://api.broadnet.me/sms/sendSms \2  -H "Authorization: Bearer $BROADNET_TOKEN" \3  -H "Content-Type: application/json" \4  -d '{5  "senderId": "BroadNet",6  "destinationNumber": "447700900123",7  "message": "Your verification code is 482913",8  "messageType": "TEXT"9}'
```

Respuesta esperada

```
HTTP/1.1 200 OK

2603121407537573731
```

Un envío exitoso devuelve HTTP 200 con el ID del mensaje como cuerpo de la respuesta. Un token faltante o no válido es rechazado por la pasarela API con 401 y un cuerpo JSON de dos campos: error y message; otros errores API devuelven una ExceptionResponse (status, error, message, errorCode, requestUri). El ID que se muestra es ilustrativo.

La herramienta construye la solicitud: no la envía.

Todo se ejecuta en tu navegador. Ninguna solicitud sale de esta página y no se transmite ninguna credencial. Copia un fragmento y ejecútalo con tu propio token contra la API de producción.

La respuesta breve

## ¿Qué hace el generador de solicitudes?

Convierte un formulario en una solicitud correcta para la API de SMS de BroadNet. Rellena el ID de remitente, el destinatario, el mensaje y la codificación, y la herramienta arma POST /sms/sendSms con un encabezado Authorization: Bearer y un cuerpo JSON, junto con fragmentos de cURL, Node, Python y TypeScript SDK listos para ejecutar. No se envía nada: genera exactamente la solicitud que ejecutarías tú.

### Cómo funciona un envío

Envía por POST un cuerpo JSON con cuatro campos obligatorios —senderId, destinationNumber, message y messageType (TEXT para GSM-7, UNICODE para todo lo demás)— a /sms/sendSms, con tu token en el encabezado Authorization: Bearer. Una respuesta 200 contiene el ID del mensaje. El TypeScript SDK oficial (@broadnet/cpaas-sdk) encapsula la misma llamada; desde cualquier otro lenguaje, llama directamente a la REST API o genera un cliente a partir de la especificación OpenAPI 3.1.

### Campos del cuerpo de POST /sms/sendSms

| Parámetro | Obligatorio | Descripción |
|---|---|---|
| senderId | Sí | El ID de remitente aprobado que ve el destinatario. |
| destinationNumber | Sí | Número del destinatario: dígitos con el código de país, sin +. |
| message | Sí | El cuerpo del mensaje. |
| messageType | Sí | TEXT (GSM-7) o UNICODE (árabe, emoji, otras escrituras). |
| campaignName | No | Una etiqueta que agrupa los envíos en tus informes. |
| templateId | No | ID de la plantilla registrada, cuando la normativa local lo exige. |

### Parámetros de GET /websmpp/websms (heredada)

| Parámetro | Obligatorio | Descripción |
|---|---|---|
| user | Sí | Nombre de usuario de la API heredada (accesskey puede sustituir a user + pass). |
| pass | Sí | Contraseña de la API heredada. |
| sid | Sí | ID de remitente que ve el destinatario. |
| mno | Sí | Número del destinatario con el código de país, sin +. |
| type | Sí | Codificación: 1 inglés/GSM-7, 2 Unicode, 3 inglés + caracteres especiales, 4 árabe. |
| text | Sí | Cuerpo del mensaje, codificado para URL. |
| schtime | No | Hora de entrega programada (yyyyMMddHHmm). |
| gmt | No | Diferencia horaria de la hora programada. |

## Preguntas frecuentes

**¿Esta herramienta envía un mensaje?**

No. El generador arma la solicitud por completo en tu navegador y la muestra. No se transmite nada y ninguna credencial sale de la página. Copia un fragmento y ejecútalo tú mismo con tu propio token.

**¿Qué API debo usar?**

Las integraciones nuevas deben usar la REST API: POST /sms/sendSms con un token Authorization: Bearer y un cuerpo JSON. La API HTTP heredada (GET /websmpp/websms, con las credenciales como parámetros de consulta) se mantiene para integraciones existentes de la era SMPP.

**¿Cómo me autentico?**

Envía el token de acceso de tu cuenta en un encabezado Authorization: Bearer en cada llamada REST. El generador muestra la variable de entorno $BROADNET_TOKEN como marcador: mantén el token real fuera del código fuente.

**¿Qué diferencia hay entre TEXT y UNICODE?**

TEXT usa el alfabeto GSM-7: 160 caracteres en un SMS simple y 153 por parte cuando se concatena. UNICODE cubre el árabe, los emoji y otras escrituras: 70 caracteres en un SMS simple y 67 por parte. POST /sms/identify devuelve el messageType correcto y el número de segmentos de cualquier mensaje.

**¿Hay un SDK?**

Sí: un SDK oficial, para TypeScript / Node.js: @broadnet/cpaas-sdk (npm install @broadnet/cpaas-sdk axios). Desde cualquier otro lenguaje, llama directamente a la REST API como muestran los fragmentos, o genera un cliente a partir de la especificación OpenAPI 3.1.

**¿Qué respuesta debo esperar?**

Una llamada POST /sms/sendSms correcta devuelve HTTP 200 con el ID del mensaje como cuerpo. Un token Bearer faltante o no válido recibe un 401 de la pasarela API con un cuerpo JSON de error y message; otros errores devuelven una ExceptionResponse con status, error, message, errorCode y requestUri.

[Referencia completa de la API Cada endpoint, parámetro y respuesta en la referencia para desarrolladores.](https://www.broadnet.me/es/developers/api) [Obtén credenciales Crea una cuenta para obtener tu token de acceso a la API y tus ID de remitente.](https://www.broadnet.me/es/signup) [API de SMS REST + SMPP 3.4, autenticación con token Bearer, webhooks de entrega.](https://www.broadnet.me/es/products/sms-api) [Todas las herramientas Todas las utilidades gratuitas de BroadNet para desarrolladores.](https://www.broadnet.me/es/tools)

## ¿Listo para enviar de verdad?

Obtenga su token de acceso, inserte el fragmento generado en su código y envíe mensajes de prueba a su propio número verificado antes de pasar a producción.

[Solicitar acceso de prueba](https://www.broadnet.me/es/signup) [Leer la referencia de la API](https://www.broadnet.me/es/developers/api)
