Endpoint
URL específica de una API para acceder a un recurso o realizar una acción. Un buen endpoint se explica solo: su URL y método deberían dejar claro qué hace.
Definición
Un endpoint es una URL específica dentro de una API que representa un recurso o una acción disponible para los clientes. Cada endpoint se asocia con un método HTTP (GET, POST, PUT, DELETE) y define el punto exacto de comunicación entre el cliente y el servidor para realizar operaciones concretas como consultar, crear, actualizar o eliminar datos. El diseño adecuado de endpoints es clave para crear APIs intuitivas, mantenibles y escalables que otros desarrolladores puedan usar sin fricción.
Ejemplos
- • GET /api/usuarios devuelve la lista completa de usuarios registrados en el sistema
- • POST /api/productos/{id}/comprar ejecuta la compra de un producto específico identificado por su ID
Ejemplo de código
// Definición de endpoints REST con Express.js
const express = require('express');
const router = express.Router();
// CRUD de usuarios
router.get('/usuarios', listarUsuarios); // GET /api/usuarios
router.get('/usuarios/:id', obtenerUsuario); // GET /api/usuarios/123
router.post('/usuarios', crearUsuario); // POST /api/usuarios
router.put('/usuarios/:id', actualizarUsuario); // PUT /api/usuarios/123
router.patch('/usuarios/:id', modificarUsuario); // PATCH /api/usuarios/123
router.delete('/usuarios/:id', eliminarUsuario); // DELETE /api/usuarios/123
// Endpoints anidados para relaciones
router.get('/usuarios/:id/pedidos', obtenerPedidosDeUsuario);
router.get('/pedidos/:id/productos', obtenerProductosDePedido);
module.exports = router;