Propósito:
Se explica por qué ciertos endpoints de la API, específicamente aquellos diseñados para reportes y análisis, solo admiten el método GET y no permiten operaciones de modificación o eliminación como POST, PUT o DELETE.
Desarrollo del Tema
1. Comprendiendo la Función de un Endpoint de API
No todos los “puntos de acceso” (endpoints) en nuestra API tienen el mismo propósito. Su diseño está directamente relacionado con la función que deben cumplir dentro del sistema ERP. Podemos clasificarlos principalmente en dos categorías:
- Endpoints Transaccionales: Permiten crear, modificar o eliminar registros de datos. Por ejemplo, un endpoint para
crear una factura,actualizar un clienteoeliminar un producto. - Endpoints de Consulta o Reporte: Su única función es recopilar, procesar y mostrar información existente en la base de datos. No están diseñados para alterar los datos de origen.
El endpoint ANAFACTURACION (Análisis de Facturación) pertenece a esta segunda categoría. Su objetivo es proporcionar una vista consolidada y analítica de la información de facturación, no gestionar las facturas individuales.
2. Métodos HTTP y su Correspondencia Lógica
Los métodos HTTP son los “verbos” que le indican a la API qué acción se desea realizar. Los más comunes son:
GET(Obtener): Se utiliza para solicitar y recuperar información. Es una operación de solo lectura. Es como pedir un informe o consultar un saldo.POST(Publicar): Se utiliza para crear un nuevo registro. Es como emitir una nueva factura en el sistema.PUT/PATCH(Actualizar): Se utiliza para modificar un registro existente. Es como editar los datos de un cliente.DELETE(Eliminar): Se utiliza para borrar un registro de forma permanente. Es como anular una factura.
3. Análisis del Caso: ¿Por qué no es posible un DELETE en ANAFACTURACION?
La respuesta se basa en el principio de diseño y seguridad de la API:
- Función Principal: El endpoint
ANAFACTURACIONes un reporte. Su única responsabilidad es mostrar datos.