La API de plataforma es el plano de control de RenLayer. Es una API REST multi-tenant escrita en Rust + Axum y respaldada por PostgreSQL. La consola es su cliente principal; también puedes usarla directamente para integrar RenLayer con tus propias herramientas, dashboards o flujos de trabajo.
Lo que la API expone
- Tenants: unidades de facturación y configuración, raíz del árbol multi-tenant.
- Usuarios y roles: identidad de operador y autorización para la consola.
- Agentes: los agentes de IA registrados a través de los cuales fluye el tráfico.
- Claves de API: credenciales asignadas a cada agente.
- Políticas: las reglas que el proxy aplica.
- Detectores y patrones DLP: la configuración de prevención de pérdida de datos.
- Trazas y sesiones: cada acción que el proxy ha registrado.
- Log de auditoría: cada acción de operador en la consola.
Si un recurso es visible en la consola, es accesible a través de la API.
Diseño
- REST: JSON sobre HTTPS, URLs de recurso predecibles (
/tenants/:id/agents/:id). - Versionado: prefijado en URL (
/v1/...); los cambios disruptivos incrementan la versión. - Paginación: basada en cursor para endpoints de lista; el cursor es opaco.
- Filtrado: parámetros de query; consistentes entre recursos.
- Errores: JSON problem-detail RFC 7807 con códigos de error estables.
- Idempotencia: los endpoints de escritura aceptan headers
Idempotency-Key.
Autenticación
Todas las peticiones requieren un JWT en el header Authorization: Bearer …. Los JWTs los emite el flujo de login OTP o SAML/OIDC según la configuración del tenant. Consulta autenticación para el flujo de emisión.
Multi-tenancy
Cada endpoint delimita sus datos al tenant del usuario que llama. No existe un endpoint admin que pueda leer entre tenants desde el JWT estándar, el acceso entre tenants requiere un mecanismo separado y auditado reservado para soporte.
Qué hay en esta sección
La referencia de la API está restringida. Las páginas de esta sección cubren:
- Autenticación: cómo obtener y refrescar un JWT.
- Conceptos de la API: el modelo de recursos a alto nivel.
- Solicitar acceso: solicita la referencia completa de endpoints.
La referencia completa de endpoints (rutas, parámetros, esquemas, códigos de error, límites de tasa) se proporciona a clientes y partners cualificados bajo NDA. Esto mantiene la superficie técnica predecible para los usuarios de producción a la vez que limita la exposición competitiva.