Conceptos de la plataforma
Tenants, autenticación machine-to-machine y convenciones comunes a todas las APIs de OpenSolvex.
Todos los productos de OpenSolvex comparten el mismo modelo base. Entenderlo una vez te sirve para integrarte con cualquiera de ellos.
Tenants
Tu cuenta en OpenSolvex es una organización: todos los recursos que creas (canales, suscripciones, agentes…) pertenecen a tu organización y están aislados de las demás. Toda petición autenticada opera en el contexto de un tenant.
Autenticación machine-to-machine
Los servicios se consumen con API keys con scopes (permisos mínimos por operación).
Las keys se crean y rotan desde el panel de cada producto y se envían en el header
Authorization:
curl https://api.opensolvex.co/v1/... \
-H "Authorization: Bearer osx_sk_xxx"Manejo de credenciales
Nunca publiques una API key ni la escribas en tu repositorio. Usa variables de entorno, asigna a cada key los scopes mínimos que necesite y rótala si sospechas que se filtró.
Modo sandbox
Cada API key puede ser de sandbox: opera sobre datos aislados de producción para que pruebes tu integración de punta a punta sin riesgo. Los ejemplos de esta documentación asumen sandbox.
Convenciones de las APIs
- REST versionada bajo
/v1; los cambios incompatibles solo llegan en versiones nuevas. - Errores con cuerpo JSON estructurado (código, mensaje y detalles).
- Operaciones de escritura idempotentes vía idempotency keys donde aplica.