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.
Rate 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.