Diseño de APIs REST: Mejores prácticas

Fri, 25 Apr 2025 00:00:00 +0900

Una API REST bien diseñada es intuitiva, consistente y fácil de mantener. Estas prácticas aplican a cualquier lenguaje y framework.

Nombres de recursos

Sustantivos en plural: /users, /articles. Jerarquía: /users/123/posts. URLs limpias, sin verbos. Versionado: /v1/users.

Métodos HTTP

GET (leer), POST (crear), PUT (reemplazar), PATCH (actualizar parcial), DELETE (eliminar). Siempre respeta la semántica HTTP.

Respuestas consistentes

Estructura JSON unificada. Códigos HTTP correctos: 200, 201, 204, 400, 401, 403, 404, 409, 422, 500. Mensajes de error descriptivos.

Rate Limiting en APIs: Estrategias y mejores prácticas

Tue, 07 May 2024 00:00:00 +0900

Rate limiting protege las APIs contra abusos limitando el número de solicitudes en un período de tiempo. Esencial para seguridad y estabilidad.

Estrategias comunes

Fixed Window: cuenta en ventanas de tiempo fijas. Sliding Window: ventana deslizante más precisa. Token Bucket: tokens que se regeneran. Leaky Bucket: cola de velocidad fija.

Cabeceras de respuesta

X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset. El cliente puede ajustar su comportamiento. HTTP 429 Too Many Requests con Retry-After.

Implementación

Redis para rate limiting distribuido. Almacenamiento en memoria para single-server. Middleware en Express, FastAPI, Cloudflare Workers.

Backend on Commentary of Takao