Autenticación y scopes

Claves API bearer

GET /v1/environments/{environmentId}/customers
Authorization: Bearer <environment-api-key>
Accept: application/json

La API valida la credencial, resuelve su entorno y organización, y aplica el scope requerido y los filtros de tenant para cada operación. El contrato OpenAPI indica el scope exigido por operación pública.

Gestión de credenciales

• Guarda las claves solo en almacenamiento de secretos del servidor.

• Usa credenciales diferentes y permisos mínimos para cada límite de integración.

• Rota y revoca claves desde el portal autenticado.

• No incluyas claves API en el servidor Scalar, JSON de configuración pública, aplicaciones móviles ni bundles del navegador.

• Los errores de autenticación y de scope usan respuestas Problem Details tipadas con identificadores de correlación.

• Aislamiento de entornos

• Scopes por operación en OpenAPI