API Reference
Documentacion completa de Veridia Nexus API. RESTful, JSON, OAuth2.
Base URL
https://api.veridia.green/v1 HTTPS JSON UTF-8
Autenticacion
API Key
RecomendadoPara integraciones server-to-server. Incluye tu key en el header.
X-API-Key: vnx_live_xxxBearer Token
JWT tokens obtenidos via login. Expiran en 24 horas.
Authorization: Bearer eyJhbG...OAuth2
Para aplicaciones de terceros en el Marketplace.
Authorization: Bearer {access_token}Seguridad
Nunca expongas tu API key en codigo frontend. Usa variables de entorno y realiza llamadas desde tu backend.
Endpoints
ESG Data
Consumos, emisiones y huella de carbono
GET
/consumption-dataPOST
/consumption-dataGET
/consumption-data/{id}PUT
/consumption-data/{id}DELETE
/consumption-data/{id}GET
/consumption-data/summaryProjects
Gestion de proyectos ESG
GET
/projectsPOST
/projectsGET
/projects/{id}PUT
/projects/{id}DELETE
/projects/{id}Reports
Generacion de reportes ESG
GET
/reportsPOST
/reports/generateGET
/reports/{id}GET
/reports/{id}/downloadPOST
/reports/generate-multi-frameworkGoals
Metas de reduccion de carbono
GET
/goalsPOST
/goalsGET
/goals/{id}GET
/goals/{id}/progressGET
/goals/{id}/trajectoryLogistics
WMS, inventario y envios
GET
/warehousesPOST
/warehousesGET
/inventoryPOST
/shipmentsGET
/shipments/{id}/trackUsers & Team
Gestion de usuarios y permisos
GET
/usersPOST
/usersGET
/users/mePUT
/users/{id}/roleRate Limits
| Plan | Requests | Burst |
|---|---|---|
| Sprout (Free) | 1,000/mes | 10/min |
| Green | 50,000/mes | 100/min |
| Forest | 500,000/mes | 500/min |
| Enterprise | Ilimitado | Custom |
Los headers X-RateLimit-Remaining y X-RateLimit-Reset indican tu uso actual.
Codigos de Error
| Codigo | Nombre | Descripcion |
|---|---|---|
| 400 | Bad Request | Parametros invalidos o faltantes |
| 401 | Unauthorized | API key invalida o token expirado |
| 403 | Forbidden | Sin permisos para esta accion |
| 404 | Not Found | Recurso no encontrado |
| 422 | Validation Error | Error de validacion en datos |
| 429 | Too Many Requests | Rate limit excedido |
| 500 | Server Error | Error interno - contactar soporte |
Prueba la API ahora
Usa Swagger UI para probar endpoints en vivo con tu API key.