Notion API-forbindelser

Du kan administrere personlige adgangstokens fra Notion. Slå Developer Mode til fra Indstillinger, og åbn derefter personlige adgangstokens fra udviklersektionen i din sidemenu. Besøg vores developer Hub for dokumentation, ressourcer og værktøjer til styring af forbindelser.

Leder du efter administrator-tokens? Tokens på denne side fungerer i ét arbejdsområde og håndterer indholdet på siden. Hvis du har brug for at køre organisationens administratorarbejde som Eksporter, lagringspligt eller log brugere ud, kan du se Administrator API'er til Enterprise-organisationer.

1. I din venstre sidemenu skal du navigere til Indstillinger og derefter fanen Forbindelser.

2. Kun ejere af arbejdsområdet kan få adgang til fanen Forbindelser og oprette integrationer. Hvis du ikke er administrator, bedes du kontakte administratoren af dit arbejdsområde eller bruge et andet arbejdsområde.

3. Slå Developer Mode til, og åbn derefter personlige adgangstokens fra udviklersektionen i din sidemenu.

4. Klik på + Ny forbindelse.

5. Angiv et Navn til din forbindelse. Du kan eventuelt også uploade et billede, der skal bruges som Logo.

6. Brug rullemenuen til at angive, hvilket Tilknyttet arbejdsområde du vil bruge denne forbindelse med.

   

   Bemærk: Sørg for, at du er logget ind på Notion i din websession med den samme konto, som du brugte på computeren. Ellers vil du ikke se den korrekte konto og de korrekte arbejdsområder!

   

7. Din interne forbindelse er blevet tilføjet! Du kan nu se den i dit arbejdsområde under menuen Indstillinger → Forbindelser.

8. Klik på ••• ud for den interne forbindelse for at hente tokenet til den interne forbindelse. Du skal bruge dette token til alle API-baserede automatiseringer eller arbejdsgange, som dit team opretter, eller til at linke dit arbejdsområde til visse partnerplatforme.

Alle nyligt tilføjede forbindelser er som udgangspunkt interne. Hvis du er udvikler og arbejder på en offentlig forbindelse, skal du først bruge ovenstående instruktioner til at oprette en intern forbindelse.

Følg derefter instruktionerne i vores udviklervejledning for at konvertere den til en offentlig forbindelse.

Når du opretter en offentlig forbindelse, vælger du hvem der kan installere den:

• Ethvert arbejdsområde: alle kan installere din forbindelse i deres eget Notion-arbejdsområde.

• Valgte arbejdsområder: kun de arbejdsområder du angiver, kan installere din forbindelse.

Vælg Valgte arbejdsområder når du bygger noget kun til din egen virksomhed og ikke vil have at andre organisationer kan installere det.

Notion tjekker dette hver gang nogen installerer din forbindelse. Hvis deres arbejdsområde ikke er på din liste, stopper installationen, og de ser en fejlmeddelelse.

Kun forbindelser som alle kan installere, kan blive vist i forbindelsesgalleriet. En forbindelse der er begrænset til valgte arbejdsområder, vil ikke blive vist der.

En forbindelse du ejer, vises i udviklerportalen for hvert arbejdsområde der må installere den, allerede har den installeret eller er det arbejdsområde hvor du byggede den.

Hver offentlig forbindelse har ét arbejdsområde hvor du bygger og tester den. Du kan skifte til et andet uden at starte forfra.

1. Åbn din forbindelse i udviklerportalen.

2. Gå til forbindelsens indstillinger.

3. Vælg det arbejdsområde du vil bygge i.

Notion knytter din forbindelse til det arbejdsområde du valgte. Du behøver ikke at oprette en ny forbindelse.

Under app-opsætningsprocessen kan udviklere vælge det adgangsniveau, der kræves fra brugeren.

• Indholdsfunktioner:

  • Læs kun indhold

  • Skriv kun indhold

  • Indsæt indhold

• Brugerfunktioner

  • Ingen brugeroplysninger

  • Læs brugerinfo (eksklusive brugerens e-mailadresse)

  • Læs brugerinfo (inklusive e-mail)

Når brugere installerer forbindelser, vil dette adgangsniveau blive vist. Det vil også blive vist i menuen Del på alle sider, som forbindelsen er blevet tilføjet til. Lær mere om installation af forbindelser i et arbejdsområde →

Forbindelses-webhooks gør det muligt for forbindelser at overvåge og reagere på ændringer i Notion-arbejdsområder i realtid.

Når der sker ændringer på sider eller i databaser, der er delt med din forbindelse, sender Notion automatisk meddelelser til dit webhook-endepunkt, hvilket gør det muligt for din forbindelse øjeblikkeligt at opdatere andre værktøjer, køre automatiserede opgaver eller vise de seneste ændringer.

For instruktioner, besøg venligst vores udviklerdokumentation.

Webhook-handlinger og forbindelses-webhooks har visse ligheder – begge har Udløsere og kan sende begivenheder til tredjepartstjenester. Forbindelses-webhooks tilbyder dog bredere muligheder:

• De kan overvåge aktivitet på tværs af flere arbejdsområder.

• De kan håndtere et ubegrænset antal handlinger.

I modsætning hertil er webhook-handlinger designet til enklere anvendelsesscenarier og konfigureres via databaseautomatiseringer med et begrænset sæt Udløsere.