wiki/API e integraciones/API pública y OpenAPI: un contrato, no un CSV educado
01API e integracionesLectura mínima 4

API pública y OpenAPI: un contrato, no un CSV educado

Cómo la API /v1 expone activos, pedidos, documentos, listings, subastas, eventos y más para equipos con necesidades reales de integración.

Algunos tenants vivirán todo el día dentro de ReVend OS. Otros ya tienen ERP, WMS, finanzas o BI que no van a desaparecer porque llegó un botón más bonito. La API pública existe para esos equipos: acceso estructurado a registros operativos sin diplomacia de copiar y pegar.

Qué cubre

La superficie /v1 incluye activos, pedidos, evidencia, documentos, empresas, contactos, direcciones, almacenes, catálogos, activos vendibles, listings, subastas, eventos, webhooks e import jobs. No es un endpoint demo con blazer; el contrato se genera, se prueba y se expone mediante OpenAPI.

OpenAPI

/api/v1/openapi.json publica el esquema. Artefactos para Postman, Bruno y clientes TypeScript salen del mismo registro. Así documentación, validación y código no mantienen tres verdades educadamente distintas.

Cuándo usarla

Usa la API para integraciones repetibles: ERP, WMS, reporting, automatización de listings o sincronización de eventos. Para una carga puntual, el import center suele ser menos ceremonia.