¿Qué es un Endpoint (API)?
Definición breve: Un endpoint es la URL específica de una API a la que se realiza una petición para crear, leer, actualizar o borrar recursos (CRUD), generalmente mediante HTTP.
Ejemplo rápido
// Obtener un usuario (REST)
GET https://api.ejemplo.com/v1/users/42
// Crear un usuario
POST https://api.ejemplo.com/v1/users
Content-Type: application/json
{"name":"Ana","email":"ana@ejemplo.com"}
¿Por qué importa?
Un diseño claro de endpoints (nombres de recursos consistentes, versiones /v1, filtros y paginación) facilita el desarrollo y evita errores. La documentación debe especificar método HTTP, parámetros, códigos de estado y autenticación.
Mini-FAQ
¿Endpoint vs ruta?
La ruta es el patrón (ej., /users/{id}); el endpoint es la URL concreta (ej., /users/42).
¿Cómo versiono la API?
Común: prefijo /v1. Alternativas: cabeceras o negociación de contenido. Mantén contratos estables.