Notion-API-Verbindungen

In diesem Hilfedokument

Mit der Notion-API kannst du eigene interne Verbindungen erstellen. Einige unserer Partner benötigen ggf. ein API-Token, um ihre Plattform mit deinem Notion-Workspace zu verknüpfen – unten zeigen wir dir, wie du das einrichtest.


Du kannst persönliche Zugriffstoken von Notion verwalten. Aktiviere den Entwicklermodus unter Einstellungen und öffne anschließend die persönlichen Zugriffstoken im Entwicklerbereich in deiner Seitenleiste. Besuche unser Entwickler-Hub für Dokumentation, Ressourcen und Verbindungsmanagement-Tools.

Hinweis: Jede Verbindung hat eine Besitzerin oder einen Besitzer, manchmal auch mehrere. Alle Besitzer/-innen können die Verbindung verwalten und das zugehörige API-Token abrufen. Wer eine Verbindung erstellen kann, hängt von deinem Plan und den Einstellungen deines Workspaces ab. Mehr über Enterprise-Verbindungseinstellungen → erfahren

Suchst du nach Admin-Tokens? Die Tokens auf dieser Seite funktionieren innerhalb eines Workspace und verwalten den Inhalt. Wenn du Admin-Aufgaben für die Organisation ausführen musst, wie zum Beispiel Exportieren, Rechtliche Sperre oder das Abmelden von Benutzern, schau dir Admin APIs für Enterprise-Organisationen an.

Welches Token brauche ich? Notion verwendet mehrere verschiedene Token. Das Token, das du für eine interne Verbindung kopierst, ist das API-Token. Darum geht es in diesem Artikel. Persönliche Zugriffstoken sind mit deinem Konto verknüpft. OAuth kommt bei Apps zum Einsatz, bei denen du dich anmeldest. Wenn eine Partnerplattform nach einem Token für eine Verbindung fragt, die du erstellt hast, verwende das API-Token.

  1. Gehe in der linken Seitenleiste auf Einstellungen und dann auf den Tab Verbindungen.

  2. Wer eine Verbindung erstellen kann, hängt von deinem Workspace ab. Im Free Plan und im Plus Plan können nur Workspace-Besitzer/-innen Verbindungen erstellen. Im Business Plan und im Enterprise Plan können Workspace-Besitzer/-innen dies auch Mitgliedern oder Mitgliedern bestimmter Gruppen erlauben. Wenn du keine Verbindung erstellen kannst, frage eine/-n Workspace-Besitzer/-in.

  3. Aktiviere den Entwicklermodus und öffne anschließend die persönlichen Zugriffstoken im Entwicklerbereich in deiner Seitenleiste.

  4. Klicke auf + Neu Verbindung.

  5. Gib der Verbindung einen Namen. Du kannst auch ein Bild als Logo hochladen.

  6. Lege über das Dropdown-Menü fest, in welchem verknüpften Workspace du die Verbindung verwenden möchtest.

    Hinweis: Vergewissere dich, dass du in deiner Web-Session bei Notion mit demselben Konto angemeldet bist wie auf dem Desktop. Ansonsten werden falsche Konten und Workspaces angezeigt.

    Einbindungsdaten
  7. Deine interne Verbindung wurde erfolgreich hinzugefügt! Du kannst sie jetzt in deinem Workspace im Einstellungsmenü → Integrationen und Konnektoren sehen.

  8. Klicke neben der internen Verbindung auf das •••-Icon, um das API-Token zu kopieren. Du brauchst dieses Token für API-basierte Automatisierungen, für Workflows deines Teams und um deinen Workspace mit bestimmten Partnerplattformen zu verknüpfen.

Einbindungsdaten

Hinweis: Interne Verbindungen sind Workspace-spezifisch. Um den zugehörigen Workspace zu ändern, musst du also eine neue Verbindung erstellen.

Integrationsmenü – Erstellen

Jede interne Verbindung hat mindestens eine/-n Besitzer/-in. Besitzer/-innen können die Einstellungen der Verbindung ändern und das API-Token abrufen. Du kannst den Besitz teilen, damit mehrere Personen dieselbe Verbindung verwalten können. So kommt die Arbeit nicht zum Stillstand, wenn jemand die Rolle wechselt oder das Unternehmen verlässt.

Besitzer/-in hinzufügen oder entfernen:

  1. Öffne das Entwicklerportal und wähle deine Verbindung aus.

  2. Öffne den Tab Besitzer/-innen der Verbindung.

  3. Füge ein Mitglied oder eine Gruppe zu den Besitzer/-innen hinzu oder entferne es bzw. sie.

Bitte beachte Folgendes zu den Besitzer/-innen von Verbindungen:

  • Nur Vollmitglieder und Workspace-Besitzer/-innen können Besitzer/-innen einer Verbindung sein. Gäste und Mitglieder mit eingeschränktem Zugriff können dies nicht.

  • Wer als Besitzer/-in hinzugefügt werden kann, richtet sich ebenfalls nach der Workspace-Einstellung dazu, wer Verbindungen erstellen darf.

  • Eine Verbindung hat immer mindestens eine Person mit Besitzrechten. Deshalb kannst du die letzte Person nicht entfernen.

  • Wenn du Workspace-Besitzer/-in bist und eine Verbindung übernehmen musst, füge dich zuerst selbst als Besitzer/-in hinzu.

  • Wenn die letzte Person mit Besitzrechten den Workspace verlässt, funktioniert das API-Token der Verbindung sofort nicht mehr.

Du kannst den Besitz im Plus Plan, Business Plan und Enterprise Plan teilen, wenn du Notion im Browser oder in der Desktop-App nutzt.

Alle neu hinzugefügten Verbindungen sind zunächst intern. Wenn du als Entwickler/-in an einer öffentlichen Verbindung arbeitest, benutze zuerst die obigen Anweisungen, um eine interne Verbindung zu erstellen.

Dann kannst du diese mithilfe unseres Developer Guides in eine öffentliche Verbindung umwandeln.

Wenn du eine öffentliche Verbindung erstellst, legst du fest, wer sie installieren darf:

  • Jeder Workspace: Alle können die Verbindung in ihrem eigenen Notion-Workspace installieren.

  • Ausgewählte Workspaces: Nur die Workspaces auf deiner Liste können die Verbindung installieren.

Wähle Ausgewählte Workspaces, wenn du etwas nur für dein Unternehmen erstellst und nicht möchtest, dass andere Organisationen es installieren.

Notion überprüft das jedes Mal, wenn jemand deine Verbindung installiert. Steht der Workspace nicht auf deiner Liste, wird die Installation abgebrochen und eine Fehlermeldung angezeigt.

Nur Verbindungen, die alle installieren können, können in der Galerie für Integrationen und Konnektoren aufgeführt werden. Eine Verbindung, die auf ausgewählte Workspaces beschränkt ist, wird dort nicht angezeigt.

Hinweis: Das legst du fest, wenn du die Verbindung erstellst. Wenn du später eine andere Einstellung brauchst, erstelle eine neue Verbindung.

Eine Verbindung, die dir gehört, erscheint im Entwicklerportal für jeden Workspace, der sie installieren darf, in dem sie bereits installiert ist oder in dem du sie erstellt hast.

Jede öffentliche Verbindung hat einen Workspace, in dem du sie erstellst und testest. Du kannst zu einem anderen wechseln, ohne von vorn anfangen zu müssen.

  1. Öffne die Verbindung im Entwicklerportal.

  2. Öffne die Einstellungen der Verbindung.

  3. Wähle den Workspace aus, in dem du die Verbindung erstellen möchtest.

Notion verknüpft die Verbindung mit dem ausgewählten Workspace. Du musst keine neue Verbindung erstellen.

Bei der Anwendungseinrichtung können die für die Benutzer/-innen erforderlichen Zugriffsberechtigungen von den Entwickler/-innen festgelegt werden.

  • Inhaltliche Berechtigungen:

    • Lesezugriff

    • Schreibzugriff

    • Inhalte hinzufügen

  • Nutzungsberechtigungen:

    • Keine Benutzerdaten

    • Benutzerdaten-Lesezugriff (gilt nicht für E-Mail-Adressen)

    • Benutzerdaten-Lesezugriff (gilt auch für E-Mail-Adressen)

Wenn Nutzer Verbindungen installieren, wird diese Zugriffsebene angezeigt. Sie erscheint auch im Teilen-Menü aller Seiten, zu denen die Verbindung hinzugefügt wurde. Mehr erfahren über das Installieren von Verbindungen in einem Workspace →

Integrations-Webhooks ermöglichen es Verbindungen, Änderungen in Notion-Workspaces in Echtzeit zu überwachen und darauf zu reagieren.

Wenn Änderungen an Seiten oder Datenbanken vorgenommen werden, die mit deiner Verbindung geteilt werden, sendet Notion automatisch Benachrichtigungen an deinen Webhook-Endpunkt, sodass deine Verbindung andere Tools sofort aktualisieren, automatisierte Aufgaben ausführen oder die neuesten Änderungen anzeigen kann.

Eine Anleitung findest du in unseren Dokumenten für Entwickler/-innen.

Integrations-Webhooks unterstützen derzeit keine Benachrichtigungen für:

  • Änderungen bei Usern (einschließlich Änderungen der Workspace-Mitgliedschaft, E-Mail-/Namensaktualisierungen und Änderungen von Berechtigungen).

  • Änderungen der Workspace- und Teamspace-Einstellungen.

Verwende für diese Art von Benachrichtigungen stattdessen das Audit-Protokoll.

Webhook-Aktionen und Integrations-Webhooks haben einige Gemeinsamkeiten – beide verfügen über Auslöser und können Ereignisse an Drittanbieterdienste senden. Integrations-Webhooks bieten jedoch umfassendere Funktionen:

  • Sie können Aktivitäten über mehrere Workspaces hinweg überwachen.

  • Sie können eine unbegrenzte Anzahl von Aktionen ausführen.

Im Gegensatz dazu sind Webhook-Aktionen für einfachere Anwendungsfälle konzipiert und werden durch Datenbankautomatisierungen mit einer begrenzten Anzahl von Auslösern konfiguriert.


Feedback geben

War diese Ressource hilfreich?


Powered by Fruition