Notion API-anslutningar

I det här hjälpdokumentet

Med Notions API kan du skapa anpassade interna anslutningar. Några av våra partners kan dessutom kräva en intern anslutningstoken för att länka sin plattform till din Notion arbetsyta – nedan visar vi hur du ställer in detta.

Besök vår utvecklarhubb för dokumentation, resurser och verktyg för anslutningshantering.

Obs: Arbetsytans ägare hanterar alla anslutningar i en arbetsyta. Läs mer här →

Skapa en intern anslutning

I det vänstra sidofältet navigerar du till Settings och sedan fliken Anslutningar.
Endast arbetsytans ägare kan komma åt fliken Anslutningar och skapa integrationer. Om du inte är administratör, vänligen kontakta din arbetsytans administratör eller använd en annan arbetsyta.
Klicka på länken Utveckla dina egna anslutningar längst ner.
Mina anslutningar öppnas i din standardwebbläsare. Klicka på knappen + Ny anslutning.
Ange ett Namn för din anslutning. Valfritt kan du även ladda upp en bild att använda som Logo.
Använd rullgardinsmenyn för att ange vilken associerad arbetsyta du vill använda den här anslutningen med.
Obs: Se till att du är inloggad på Notion i din webbsession med samma konto som du använde på datorn. Annars kommer du inte att se rätt konto och arbetsytor!
Din interna anslutning har lagts till! Du kan nu se den i din arbetsyta under menyn Inställningar → Anslutningar.
Klicka på ••• bredvid din interna anslutning för att hämta anslutningstoken. Du behöver denna token för alla API-baserade automatiseringar eller arbetsflöden som ditt team skapar, eller för att länka din arbetsyta till vissa partnerplattformar.

Obs: Interna anslutningar är arbetsytespecifika, så för att ändra den tillhörande arbetsytan måste du skapa en ny anslutning.

Skapa en offentlig anslutning

Alla nyligen tillagda anslutningar är initialt interna. Om du är en utvecklare som arbetar på en offentlig anslutning, använd först instruktionerna ovan för att skapa en intern anslutning.

Följ sedan instruktionerna i vår developer guide för att konvertera den till en offentlig anslutning.

Granulära anslutningsbehörigheter

Under appens konfigurationsprocess kommer utvecklare att kunna välja vilken åtkomstnivå som krävs från användaren.

Innehållsfunktioner:
- Endast läsa innehåll
- Endast skriva innehåll
- Infoga innehåll
Användarfunktioner
- Ingen användarinformation
- Läs användarinformation (utan användarens e-postadress)
- Läs användarinformation (inklusive e-postadress)

När användare installerar anslutningar visas denna åtkomstnivå. Den visas även i menyn Dela på alla sidor som anslutningen har lagts till i. Läs mer om att installera anslutningar i en arbetsyta →

Webhooks för anslutning

Webhooks för anslutning gör det möjligt för anslutningar att övervaka och svara på ändringar i Notion-arbetsytor i realtid.

När ändringar sker på sidor eller i databaser som delas med din anslutning, skickar Notion automatiskt meddelanden till din webhook-slutpunkt, vilket gör att din anslutning omedelbart kan uppdatera andra verktyg, köra automatiserade uppgifter eller visa de senaste ändringarna.

Konfigurera webhooks för anslutning

För instruktioner, besök vår utvecklardokumentation.

Webhooks för anslutning stöder för närvarande inte aviseringar för:

Användarändringar (inklusive ändringar av medlemskap i arbetsyta, uppdateringar av e-post/namn och ändringar av behörigheter).
Ändringar av inställningar för arbetsyta och Teamutrymme.

För dessa typer av aviseringar, använd istället revisionsloggen.

Webhook-åtgärder kontra webhooks för anslutning

Webhook-åtgärder och webhooks för anslutning har vissa likheter – båda har utlösare och kan skicka händelser till tredjepartstjänster. Webhooks för anslutning erbjuder dock bredare funktioner:

De kan övervaka aktivitet i flera arbetsytor.
De kan hantera ett obegränsat antal åtgärder.

Webhook-åtgärder är däremot utformade för enklare användningsfall och konfigureras via databasautomatiseringar med en begränsad uppsättning utlösare.

Läs mer