Notion API-anslutningar

Du kan hantera personliga åtkomsttokens från Notion. Aktivera utvecklarläget från Inställningar och öppna sedan personliga åtkomsttokens från utvecklaravsnittet i sidofältet. Besök vår utvecklarhubb för dokumentation, resurser och verktyg för anslutningshantering.

Letar du efter administratörstoken? Token på Den här sidan fungerar inom en arbetsyta och hanterar sidans innehåll. Om du behöver köra administratörsarbete för organisationen, såsom export, arkiveringsskyldighet eller att logga ut användare, se Administratörs-API:er för Enterprise-organisationer.

1. I det vänstra sidofältet navigerar du till Settings och sedan fliken Anslutningar.

2. 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.

3. Aktivera utvecklarläget och öppna sedan personliga åtkomsttokens från utvecklaravsnittet i sidofältet.

4. Klicka på + Ny anslutning.

5. Ange ett Namn för din anslutning. Valfritt kan du även ladda upp en bild att använda som Logo.

6. 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!

   

7. Din interna anslutning har lagts till! Du kan nu se den i din arbetsyta under menyn Inställningar → Anslutningar.

8. 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.

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.

När du skapar en offentlig anslutning väljer du vem som kan installera den:

• Valfri arbetsyta: vem som helst kan installera anslutningen i sin egen Notion-arbetsyta.

• Valda arbetsytor: anslutningen kan bara installeras på de arbetsytor du anger.

Välj Valda arbetsytor när du bygger något bara för ditt eget företag och du inte vill att andra organisationer ska kunna installera det.

Notion kontrollerar detta varje gång någon installerar anslutningen. Om arbetsytan inte finns med på listan avbryts installationen och ett felmeddelande visas.

Endast anslutningar som vem som helst kan installera kan listas i anslutningsgalleriet. En anslutning som är begränsad till valda arbetsytor visas inte där.

En anslutning som du äger visas i utvecklarportalen för varje arbetsyta där den får installeras, där den redan är installerad eller där du byggde den.

Varje offentlig anslutning har en arbetsyta där du bygger och testar den. Du kan byta till en annan utan att börja om.

1. Öppna anslutningen i utvecklarportalen.

2. Gå till anslutningens inställningar.

3. Välj den arbetsyta du vill bygga i.

Notion kopplar anslutningen till den arbetsyta du valde. Du behöver inte skapa en ny anslutning.

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 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.

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

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.