Notion API-tilkoblinger

Du kan administrere personlige tilgangstokener fra Notion. Slå på utviklermodus fra Innstillinger, og åpne deretter personlige tilgangstokener fra utviklerdelen i sidestolpen. Besøk vårt utviklersenter for dokumentasjon, ressurser og verktøy for tilkoblingsadministrasjon.

Leter du etter administrator-tokens? Tokenene på Denne siden fungerer i ett arbeidsområde og håndterer Innhold. Hvis du trenger å kjøre administratorarbeid for organisasjonen, som Eksporter, juridiske sperringer eller å logge ut brukere, se administrator-API-er for Enterprise-organisasjoner.

1. I venstre sidestolpe, naviger til Innstillinger og deretter fanen Tilkoblinger.

2. Kun eiere av arbeidsområdet vil kunne få tilgang til fanen Tilkoblinger og opprette integrasjoner. Hvis du ikke er administrator, må du kontakte administratoren for arbeidsområdet eller bruke et annet arbeidsområde.

3. Slå på utviklermodus, og åpne deretter personlige tilgangstokener fra utviklerdelen i sidestolpen.

4. Klikk på + Ny tilkobling.

5. Oppgi et Navn for tilkoblingen din. Du kan også velge å laste opp et bilde som skal brukes som Logo.

6. Bruk rullegardinmenyen for å angi hvilket Tilknyttet arbeidsområde du vil bruke denne tilkoblingen med.

   

   Merk: Sørg for at du er logget på Notion i nettleseren med samme konto som du brukte på skrivebordet. Ellers vil du ikke se riktig konto og arbeidsområder!

   

7. Den interne tilkoblingen din er lagt til! Du vil nå kunne se den i arbeidsområdet ditt, i menyen Innstillinger → Tilkoblinger.

8. Klikk på ••• ved siden av den interne tilkoblingen for å hente tilkoblingstokenet. Du trenger dette tokenet for alle API-baserte automatiseringer eller arbeidsflyter teamet ditt oppretter, eller for å koble arbeidsområdet ditt til enkelte partnerplattformer.

Alle nylig tillagte tilkoblinger er interne i utgangspunktet. Hvis du er en utvikler som jobber med en offentlig tilkobling, må du først bruke instruksjonene ovenfor for å opprette en intern tilkobling.

Følg deretter instruksjonene i vår utviklerveiledning for å konvertere den til en offentlig tilkobling.

Når du oppretter en offentlig tilkobling, velger du hvem som kan installere den:

• Alle arbeidsområder: hvem som helst kan installere tilkoblingen din i sitt eget Notion-arbeidsområde.

• Valgte arbeidsområder: bare arbeidsområdene du oppgir, kan installere tilkoblingen din.

Velg Valgte arbeidsområder hvis du bygger noe bare for bedriften din og ikke vil at andre organisasjoner skal kunne installere det.

Notion sjekker dette hver gang noen installerer tilkoblingen din. Hvis arbeidsområdet deres ikke står på listen, stoppes installasjonen, og de får en feilmelding.

Bare tilkoblinger som alle kan installere, kan vises i tilkoblingsgalleriet. Tilkoblinger som er begrenset til valgte arbeidsområder, vises ikke der.

En tilkobling du eier, vises i utviklerportalen for alle arbeidsområder som kan installere den, som allerede har installert den, eller der du bygde den.

Hver offentlig tilkobling har ett arbeidsområde der du bygger og tester den. Du kan bytte til et annet uten å starte på nytt.

1. Åpne tilkoblingen din i utviklerportalen.

2. Gå til innstillingene for tilkoblingen.

3. Velg arbeidsområdet du vil bygge i.

Notion kobler tilkoblingen din til arbeidsområdet du valgte. Du trenger ikke å opprette en ny tilkobling.

Under oppsettet av appen vil utviklere kunne velge hvilket tilgangsnivå som kreves fra brukeren.

• Innholdsegenskaper:

  • Kun lese innhold

  • Kun skrive innhold

  • Sett inn innhold

• Brukerfunksjoner

  • Ingen brukerinformasjon

  • Les brukerinfo (ikke inkludert brukerens e-postadresse)

  • Les brukerinfo (inkludert e-post)

Når brukere installerer tilkoblinger, vil dette tilgangsnivået vises. Det vil også vises i Del-menyen på alle sider som tilkoblingen er lagt til i. Les mer om installering av tilkoblinger i et arbeidsområde →

Webhook-tilkoblinger gjør det mulig for tilkoblinger å overvåke og svare på endringer i Notion-arbeidsområder i sanntid.

Når endringer skjer på sider eller i databaser som er delt med tilkoblingen din, sender Notion automatisk varsler til webhook-endepunktet ditt, slik at tilkoblingen din umiddelbart kan oppdatere andre verktøy, kjøre automatiserte oppgaver eller vise de nyeste endringene.

For instruksjoner, vennligst besøk våre utviklerdokumenter.

Webhook-handlinger og webhook-tilkoblinger har noen likheter – begge har utløsere og kan sende hendelser til tredjepartstjenester. Webhook-tilkoblinger tilbyr imidlertid bredere funksjonalitet:

• De kan overvåke aktivitet på tvers av flere arbeidsområder.

• De kan håndtere et ubegrenset antall handlinger.

I motsetning til dette er webhook-handlinger designet for enklere brukstilfeller og konfigureres gjennom databaseautomatiseringer med et begrenset sett med utløsere.