Integraciones
Autoriza conexiones y ejecuta operaciones de proveedores.
Consulta el catálogo de integraciones y crea una conexión. Para OAuth, POST /integrations/authorizations inicia la autorización. Abre la authorization_url recibida en un navegador. El callback existente completa el proceso; después consulta /integrations/authorizations/{session_id}.
Los grants limitan el uso de una conexión. Los scopes de la API no sustituyen estos permisos. Las respuestas solo contienen metadatos seguros, nunca credenciales guardadas del proveedor.
Las llamadas a proveedores usan /integrations/connections/{connection_id}/providers/{provider}/{resource}/{operation}. El proveedor, el recurso y la acción son segmentos literales de ruta indicados en la referencia. La conexión debe pertenecer a ese proveedor.
Las llamadas de lectura a proveedores pueden usar POST. Los metadatos de la operación determinan la idempotencia y los scopes. x-effect identifica efectos externos; x-execution-mode identifica la ejecución en cola. Las operaciones en cola devuelven 202 y un recurso de invocación para consultar su estado.