Loo API-võtmed ja veebihaagid

API-võtmed võimaldavad skriptil või automaatikal lugeda ja kirjutada sinu andmeid REST API kaudu. Veebihaagid saadavad sündmusi sinu serverisse, kui midagi juhtub. Mõlemad asuvad lehel Seaded → Integratsioonid.

#Loo API-võti

1. Ava Seaded → Integratsioonid ja keri jaotiseni API-võtmed.
2. Jaotises Uus võti anna võtmele Nimi, mis näitab, kus seda kasutatakse, näiteks „n8n töövoog“.
3. Märgi Õigused, mida võti vajab. Vali vähemalt üks.
4. Klõpsa Loo.
5. Kopeeri võti kohe rohelisest kastist. See algab prefiksiga nola_live_ ja seda kuvatakse ainult üks kord.

Saada see iga päringuga päises Authorization: Bearer nola_live_…. Enne 2026. aasta oktoobrit loodud võtmed algavad prefiksiga oh_live_ ja töötavad edasi; sa ei pea neid välja vahetama. Lõpp-punktid, päringute sisud ja näited leiad lehelt REST API viide.

Sama võti toimib ka bearer-tokenina tehisintellekti agentidele, mis ühenduvad Nolaga MCP kaudu, kuid ei saa sisse logida (näiteks Grok API). Vaata Ühenda tehisintellekti agendid MCP-ga.

Iga võti saab teha kuni 600 päringut minutis. Sellest rohkemate päringute korral vastab API staatusega 429.

#Halda võtmeid

Võtmete tabelis näed iga võtme nime, esimesi märke, õigusi, väärtust Viimati kasutatud ja staatust. Nupp Tühista ligipääs lülitab võtme lõplikult välja. Õiguste muutmiseks loo uus võti ja tühista vana.

#Lisa veebihaagi lõpp-punkt

1. Ava lehel Seaded → Integratsioonid jaotis Veebihaagid ja otsi üles Uus lõpp-punkt.
2. Kleebi oma URL. See peab olema täielik avalik https://-aadress, näiteks https://your-n8n.example.com/webhook/nola. Privaatvõrgu aadresse (nagu localhost või 192.168.x.x) ja tavalist http://-aadressi vastu ei võeta. Nola ei järgi ümbersuunamisi ning ootab vastust kuni 10 sekundit.
3. Märgi Sündmused, mida soovid vastu võtta. Vali vähemalt üks.
4. Klõpsa Lisa.

Nola saadab praegu neid sündmusi:

Nimekirjas on ka extension.offered ja extension.accepted. Saad neid tellida, kuid Nola ei saada neid veel välja.

#Kuidas kohaletoimetamine töötab

Iga sündmus saadetakse POST-päringuna JSON-kehaga: event, createdAt ja data. Päised sisaldavad välja X-Nola-Event sündmuse nimega ja X-Nola-Signature kujul t=<timestamp>,v1=<signature>. Allkiri on HMAC-SHA256 väärtusest <timestamp>.<body>, mis on loodud lõpp-punkti salavõtmega. Kontrollimiskoodi näite leiad lehelt REST API viide. Rakendus veel salavõtit ei kuva, seega kui vajad seda allkirjade kontrollimiseks, võta ühendust toega.

Sinu lõpp-punkt peaks vastama staatusega 2xx. Kõik muud vastused loetakse ebaõnnestumiseks:

• Nola proovib uuesti kasvavate intervallidega (kuni tunnise vahega), kuni 8 katset iga sündmuse kohta.
• Pärast 20 järjestikust ebaõnnestunud katset lülitatakse lõpp-punkt välja ja selle staatus on Väljas koos ebaõnnestumiste arvuga. Tee oma server korda ja klõpsa seejärel Lülita sisse. Edukas kohaletoimetamine lähtestab loenduri.
• Sündmused, mis ootavad uut katset, kui lõpp-punkt lülitatakse välja või kustutatakse, jäävad saatmata. Saatmislogis on need ebaõnnestunud.

#Testimine ja tõrkeotsing

Igal lõpp-punkti real on järgmised toimingud:

• Saada test: kuvab teate „Test event sent“, kuid testsündmus (test.ping) ei jõua praegu lõpp-punktideni. Testimiseks tee oma broneerimislehel broneering ja jälgi vaadet Saatmislogi.
• Lülita sisse või Lülita välja: pane kohaletoimetamine pausile ilma lõpp-punkti kustutamata.
• Saatmislogi: iga kohaletoimetamine koos sündmuse, staatuse, vastusekoodi, katsete arvu ja ajaga. Kui kõik katsed on ära kasutatud, on kohaletoimetamisel nupp Proovi uuesti.
• Eemalda: kustutab lõpp-punkti.

#Vana webhooki URL

Lõpp-punktide all asub Vana webhooki URL, mis on varasem ühe URL-iga seadistus. See võtab allkirjastamata broneeringusündmusi vastu sinu lõpp-punktidest eraldi. See vajab samasugust paketti nagu lõpp-punktid ja avalikku https://-aadressi. Kui kasutad seda endiselt, mine üle allkirjastatud lõpp-punktile ja tühjenda see väli.

#Seotud teemad

• REST API viide
• Integratsioonide keskus
• Tehisintellekti agendid ja MCP
• Lingid ja manuskood