Explicación clara y técnica de APIs REST: concepto, métodos HTTP, códigos de estado, autenticación, buenas prácticas y ejemplos reales con JSON.
La columna vertebral del internet moderno
API REST es el estándar de comunicación entre sistemas. Cuando usas una app del banco, pides un Uber o revisas el clima, tu celular está consumiendo APIs REST.
¿Qué es una API?
API = Application Programming Interface. Es un contrato que permite que dos sistemas se comuniquen. La API define qué datos puedes pedir y qué operaciones puedes realizar.
REST = Representational State Transfer. Es un estilo arquitectónico con reglas claras:
Métodos HTTP
| Método | Acción | Ejemplo |
|--------|--------|---------|
| GET | Leer | GET /api/productos/123 |
| POST | Crear | POST /api/productos |
| PUT | Reemplazar | PUT /api/productos/123 |
| PATCH | Actualizar parcial | PATCH /api/productos/123 |
| DELETE | Eliminar | DELETE /api/productos/123 |
Códigos de estado
Autenticación
**API Keys**: Una clave secreta en el header. Simple pero menos segura.
**JWT (JSON Web Tokens)**: Token firmado que contiene claims (usuario, roles, expiración). El estándar actual.
**OAuth 2.0**: Delega autenticación a un tercero (Google, Facebook). Usado para "Iniciar sesión con X".
Ejemplo real
Request: GET /api/clientes/456
Headers: Authorization: Bearer eyJhbGciOiJIUzI1NiIs...
Respuesta:
{
"id": 456,
"nombre": "Comercial XYZ Ltda.",
"rut": "76.123.456-K",
"email": "contacto@xyz.cl",
"saldo_pendiente": 450000
}