Notion-API-Verbindungen

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.

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.

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

2. Nur Workspace-Besitzer/-innen können auf den Integrationen und Konnektoren Tab zugreifen und Integrationen erstellen. Wenn du kein Admin bist, wende dich bitte an den zuständigen Admin oder benutze einen anderen Workspace.

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.

   

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

8. Um das interne Verbindungstoken abzurufen, klicke neben der internen Verbindung auf das •••-Icon. Den Token brauchst du für API-basierte Automatisierungen, für Workflows deines Teams und um deinen Workspace mit bestimmten Partnerplattformen zu verknüpfen.

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, wählst du aus, wer sie installieren darf:

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

• Ausgewählte Workspaces: Nur die aufgeführten Workspaces 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 prüft das jedes Mal, wenn jemand die Verbindung installiert. Steht der Workspace nicht auf der Liste, wird die Installation abgebrochen und die Person sieht eine Fehlermeldung.

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, erscheint dort nicht.

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

Für jede öffentliche Verbindung gibt es 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 verbindet 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.

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.