Webhookit ja HTTP-tietovirta

Työnkulut eivät voi käsitellä mitään, ennen kuin dataa on olemassa suorituksessa, ja tämä data tulee työnkulkuun kahdella pääasiallisella tavalla: joko työnkulku ottaa yhteyttä toiseen palveluun HTTP-pyynnön kautta, tai toinen palvelu ottaa yhteyttä työnkulkuun Webhookin avulla.

Kun jompikumpi näistä on käytössä, kaikilla datan käsittelysolmuilla on jotain, mitä käsitellä.

HTTP-pyyntö

HTTP-pyyntösolmu on solmu, joka lähettää pyynnön API-osoitteeseen ja tuo vastauksen (yleensä JSON-muodossa) työnkulkuun.

• Kutsuu päätepistettä, kuten https://api.rainforestapi.com/request;
• Lähettää parametreja, kuten type, domain, seller_id ja search_term;
• Vastaanottaa jäsenneltyä dataa, joka voidaan välittää seuraaville solmuille.

Käytä tätä, kun API:lla on hyvä dokumentaatio, kun työnkulun täytyy hakea dataa aikataulun mukaan, tai kun yhden API:n tuotos tulee syötteeksi toiseen API:iin ketjutetussa kutsussa. Rakenne seuraa oppitunnin esimerkkiä, jossa perus-URL on api.rainforestapi.com/request, API-avain tunnistaa kutsujan ja parametrit kertovat API:lle, mitä palauttaa.

Parametrit:

• type=seller_products;
• domain=amazon.com;
• (ja muita tarpeen mukaan).

Aloittelijat ajattelevat usein, että tämä osa on taikuutta, mutta näin ei ole. Parametrit tulevat suoraan API-dokumentaatiosta. Avaa dokumentaatio, etsi oikea osio, kirjaa vaaditut ja valinnaiset parametrit kuvauksineen, kopioi parametrien nimet HTTP-pyyntösolmuun, aseta arvot ja suorita solmu. Tämä on vakioprosessi kaikille API:lle: lue dokumentaatio, kopioi parametrit, liitä ne pyyntöön ja testaa.

Webhook

Webhook on n8n:n tarjoama URL-osoite, jonka avulla muut järjestelmät voivat lähettää dataa suoraan työnkulkuun reaaliajassa.

• Toimii räätälöitynä sisääntulopisteenä saapuvalle datalle;
• Ihanteellinen välittömiin suorituksiin ajoitetun haun sijaan;
• Hyödyllinen räätälöidyille työkaluille tai sisäisille sovelluksille, joilla ei ole virallisia integraatioita.

Käytä tätä, kun työkalua ei voi helposti hakea aikataulun mukaan, kun työnkulun täytyy reagoida välittömästi, tai kun data tulee räätälöidystä lähteestä. Webhookit ovat HTTP-pyyntöjen peilikuva — sen sijaan, että n8n kutsuisi ulkoista palvelua, ulkoinen palvelu kutsuu n8n:ää.

Ero HTTP-pyyntöön verrattuna:

• HTTP-pyyntö: n8n → ulkoinen palvelu;
• Webhook: ulkoinen palvelu → n8n Webhook sopii paremmin reaaliaikaisiin työnkulkuihin, kun taas HTTP-pyyntö sopii paremmin ennustettavaan hakuun.