---
title: "API REST"
description: "Una API REST es una interfaz web que expone recursos, como mensajes, contactos o plantillas, en URL y permite a los programas crearlos, leerlos, actualizarlos y eliminarlos con métodos HTTP estándar (POST, GET, PATCH, DELETE), normalmente intercambiando JSON."
canonical: "https://omnichannels.ai/es/glossary/rest-api/"
language: "es"
updated: "2026-10-10"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
---

# API REST

Canonical: https://omnichannels.ai/es/glossary/rest-api/
Language: es
Publisher: OmniChannels.ai by BroadNet Technologies

**Definición:** Una API REST es una interfaz web que expone recursos, como mensajes, contactos o plantillas, en URL y permite a los programas crearlos, leerlos, actualizarlos y eliminarlos con métodos HTTP estándar (POST, GET, PATCH, DELETE), normalmente intercambiando JSON.

REST (representational state transfer, transferencia de estado representacional) es un estilo de arquitectura que Roy Fielding describió en 2000. En la práctica, una API REST de mensajería consiste en enviar una solicitud HTTPS autenticada, por ejemplo POST /messages con un cuerpo JSON, y recibir una respuesta JSON con un ID y un estado. Los códigos de estado HTTP indican el resultado: 2xx éxito, 4xx errores del cliente, como números no válidos o falta de autorización, y 5xx errores del servidor.

Patrones habituales: autenticación con bearer token en la cabecera Authorization, claves de idempotencia para que los reintentos no generen duplicados, paginación en los listados, límites de frecuencia con cabeceras retry-after y webhooks para resultados asíncronos, como los informes de entrega.

REST se adapta a la mayoría de las integraciones: CRM, plataformas de comercio electrónico y sistemas de back office. Para volúmenes muy altos de SMS, los operadores y agregadores suelen usar SMPP, que mantiene abierta una conexión persistente.

Una especificación OpenAPI describe los endpoints en un formato legible por máquinas, de modo que a partir de ella pueden generarse SDK de cliente, documentación y pruebas.

OmniChannels.ai ofrece una API REST/JSON en https://api.broadnet.me con autenticación mediante bearer token, una especificación OpenAPI 3.1 y un SDK para TypeScript.

## Ejemplo

```
POST https://api.broadnet.me/… con la cabecera "Authorization: Bearer <token>" y un cuerpo JSON; la respuesta devuelve un ID de mensaje.
```

## Fuentes

- [Fielding, Architectural Styles and the Design of Network-based Software Architectures, ch. 5 (REST)](https://ics.uci.edu/~fielding/pubs/dissertation/rest_arch_style.htm)
- [RFC 9110: HTTP Semantics (IETF)](https://datatracker.ietf.org/doc/html/rfc9110)