¿Qué es una API REST?

También llamado: REST, RESTful, Representational State Transfer

Definición

Una API REST es una API web que organiza los datos en recursos, cada uno con su URL, y usa los métodos de HTTP (GET, POST, PUT, DELETE) para leerlos y modificarlos. Es el estilo de API más común.

REST aprovecha lo que ya ofrece HTTP en lugar de inventar un protocolo: las URL identifican cosas, los métodos dicen qué hacer con ellas y los códigos de estado indican el resultado. Los datos suelen viajar en JSON.

Ejemplo

Una API REST para gestionar los términos de un diccionario:

Método y URL	Acción	Respuesta
`GET /terminos`	Listar términos	200 + lista
`GET /terminos/dns`	Ver un término	200, o 404 si no existe
`POST /terminos`	Crear uno	201 + el término creado
`PUT /terminos/dns`	Reemplazarlo	200
`PATCH /terminos/dns`	Modificar algunos campos	200
`DELETE /terminos/dns`	Borrarlo	204

$ curl -X POST https://api.example.com/terminos \
    -H "Content-Type: application/json" \
    -d '{"slug":"spf","titulo":"SPF","categorias":["correo"]}'
{"slug":"spf","titulo":"SPF","categorias":["correo"],"creado":"2026-10-11T10:00:00Z"}

Buenas prácticas

Sustantivos en las URL, no verbos: POST /pedidos, no /crearPedido.
Códigos de estado correctos: no devuelvas 200 con {"error": "..."} dentro.
Paginación en las listas (?pagina=2&por_pagina=50).
Sin estado: cada petición lleva todo lo necesario, incluida la autenticación (normalmente un token en la cabecera Authorization).

Errores habituales

Usar GET para acciones que modifican datos: los rastreadores, las cachés y la precarga del navegador pueden ejecutarlas sin querer.

¿Tienes un producto o servicio relacionado con API REST? Anúnciate en este término.

Términos relacionados

Categorías: Backend