Endpoint

¿Qué es un endpoint?

Un endpoint es una dirección (URL) específica dentro de una API que representa un recurso o una acción. Es el punto donde el cliente y el servidor se comunican, normalmente usando el protocolo HTTP.

Cada endpoint responde a una ruta determinada, como /api/usuarios o /productos/23.

¿Para qué sirve un endpoint?

Los endpoints permiten:

Consultar datos desde el cliente (GET).
Enviar nuevos datos (POST).
Actualizar información (PUT, PATCH).
Eliminar registros (DELETE).

En resumen, son los “puntos de acceso” de una API.

Ejemplo de endpoints REST

GET     /api/productos           → Lista todos los productos
GET     /api/productos/5         → Muestra el producto con ID 5
POST    /api/productos           → Crea un nuevo producto
PUT     /api/productos/5         → Actualiza el producto con ID 5
DELETE  /api/productos/5         → Elimina el producto con ID 5

Cada endpoint representa una acción sobre un recurso (productos en este caso).

Características de un endpoint

Es una URL única (como una dirección).
Se asocia a un verbo HTTP (GET, POST, etc.).
Puede requerir autenticación (token, sesión, etc.).
Devuelve datos, normalmente en formato JSON.

¿Dónde se usa?

En cualquier API RESTful o GraphQL.
En llamadas fetch o axios desde el frontend.
En sistemas distribuidos, microservicios o apps móviles.

Conclusión

Un endpoint es el punto de entrada a una API, donde los clientes envían peticiones y reciben respuestas. Comprender cómo funcionan y cómo estructurarlos es clave para diseñar APIs limpias y eficientes.