Integrationen
Verbindungen autorisieren und Provider-Operationen ausführen.
Rufe den Integrationskatalog auf und erstelle eine Verbindung. Für OAuth beginnt POST /integrations/authorizations den Autorisierungsprozess. Öffne die zurückgegebene authorization_url im Browser. Der bestehende Callback schließt den Prozess ab; frage danach /integrations/authorizations/{session_id} ab.
Grants begrenzen die Nutzung einer Verbindung. API-Scopes ersetzen diese fachlichen Berechtigungen nicht. Antworten enthalten ausschließlich sichere Metadaten, keine gespeicherten Provider-Credentials.
Provider-Aufrufe verwenden /integrations/connections/{connection_id}/providers/{provider}/{resource}/{operation}. Provider, Ressource und Aktion sind konkrete Pfadbestandteile aus der Referenz. Die Verbindung muss dem angegebenen Provider gehören.
Lesende Provider-Aufrufe können POST verwenden. Maßgeblich für Idempotenz und Scope sind die Metadaten der Operation. x-effect kennzeichnet externe Auswirkungen; x-execution-mode kennzeichnet eingereihte Ausführung. Letztere liefert 202 und eine Invocation-Ressource zum Polling.