Notion API -yhteydet

Vieraile kehittäjäkeskuksessamme nähdäksesi dokumentaation, resurssit ja yhteyksien hallintatyökalut.

1. Siirry vasemmassa sivuvalikossa kohtaan Asetukset ja sitten Yhteydet -välilehteen.

2. Vain työtilan omistajat voivat käyttää Yhteydet -välilehteä ja luoda integraatioita. Jos et ole ylläpitäjä, ota yhteyttä työtilasi ylläpitäjään tai käytä toista työtilaa.

3. Napsauta alareunassa olevaa Kehitä omia yhteyksiäsi -linkkiä.

4. Omat yhteydet avautuvat oletusselaimessasi. Napsauta + Uusi yhteys -painiketta.

5. Anna yhteydellesi nimi. Voit halutessasi ladata myös kuvan, jota käytetään logona.

6. Määritä avattavasta valikosta, missä liitetyssä työtilassa haluat käyttää tätä yhteyttä.

   

   Huomio: Varmista, että olet kirjautunut Notionin verkkoversioon samalla tilillä, jota käytit työpöytäversiossa. Muussa tapauksessa et näe oikeaa tiliä ja työtiloja!

   

7. Sisäinen yhteys on lisätty onnistuneesti! Näet sen nyt työtilassasi kohdassa Asetukset → Yhteydet.

8. Napsauta sisäisen yhteyden vieressä olevaa •••-kuvaketta hakeaksesi sisäisen yhteyden tunnisteen. Tarvitset tätä tunnistetta kaikissa tiimisi luomissa API-pohjaisissa automaatioissa tai työnkuluissa, tai yhdistääksesi työtilasi joihinkin kumppanialustoihin.

Kaikki lisätyt yhteydet ovat aluksi sisäisiä. Jos olet kehittäjä ja luot julkista yhteyttä, käytä ensin yllä olevia ohjeita sisäisen yhteyden luomiseen.

Seuraa sitten kehittäjäoppaamme ohjeita muuntaaksesi sen julkiseksi yhteydeksi.

Sovelluksen määritysprosessin aikana kehittäjät voivat valita käyttäjältä vaadittavan käyttöoikeustason.

• Sisältöominaisuudet:

  • Vain lue sisältöä

  • Vain kirjoita sisältöä

  • Syötä sisältöä

• Käyttäjäominaisuudet

  • Ei käyttäjätietoja

  • Lue käyttäjätiedot (ei sisällä käyttäjän sähköpostiosoitetta)

  • Lue käyttäjätiedot (sisältää sähköpostin)

Kun käyttäjät asentavat yhteyksiä, tämä käyttöoikeustaso näytetään. Se näkyy myös niiden sivujen Jaa-valikossa, joihin yhteys on lisätty. Lue lisää yhteyksien asentamisesta työtilaan →

Yhteys-webhookien avulla yhteydet voivat seurata Notion-työtilojen muutoksia ja reagoida niihin reaaliajassa.

Kun yhteytesi kanssa jaetuilla sivuilla tai tietokannoissa tapahtuu muutoksia, Notion lähettää automaattisesti ilmoitukset webhook-päätepisteeseesi, jolloin yhteys voi päivittää muut työkalut välittömästi, suorittaa automatisoituja tehtäviä tai näyttää uusimmat muutokset.

Katso ohjeet kehittäjädokumentaatiostamme.

Webhook-toiminnot ja yhteys-webhookit muistuttavat toisiaan – molemmissa on käynnistimiä ja ne voivat lähettää tapahtumia kolmannen osapuolen palveluihin. Yhteys-webhookit tarjoavat kuitenkin laajemmat ominaisuudet:

• Ne voivat seurata toimintaa useissa työtiloissa.

• Ne voivat käsitellä rajoittamattoman määrän toimintoja.

Webhook-toiminnot on sen sijaan suunniteltu yksinkertaisempiin käyttötapauksiin, ja ne määritetään tietokanta-automaatioiden kautta, joissa on rajoitettu määrä käynnistimiä.