Versiones y rutas
Las rutas REST /api/v1 y por qué los alias en castellano de la v0 siguen operativos.
La API tiene dos formas de llamada, ambas operativas y sobre la misma lógica:
/api/v1/…recomendado |
API REST versionada: recursos en plural y en inglés, con el verbo HTTP que
corresponde a cada operación — POST /api/v1/invoices crea una factura,
GET /api/v1/invoices las lista, GET /api/v1/invoices/{id} devuelve una
y PUT /api/v1/crm/opportunities/{id}/close cierra una oportunidad.
En GET los parámetros van por query string; en POST y
PUT, en el cuerpo JSON.
|
/{operación}v0 · legacy |
Los alias en castellano de siempre (POST /crearFactura,
POST /consultarVentas…), todos por POST con el cuerpo JSON.
Se mantienen sin fecha de caducidad: las integraciones existentes no tienen
que tocar nada. Cada endpoint documenta su alias bajo la ruta REST.
|
La respuesta es idéntica en ambas: mismo envelope, mismos identificadores cifrados y
mismos códigos de error. Para lo nuevo, usa /api/v1/: cuando llegue una v2, la v1 seguirá
respondiendo igual.
La misma operación, en las dos formas
GET https://api.afer.pro/api/v1/invoices?fecha_inicio=2026-08-01&cobrada=0
POST https://api.afer.pro/consultarFacturas { "fecha_inicio": "2026-08-01", "cobrada": false }