Laguntza
Hasi saioa

Bidali HTTP eskaera

Bidali HTTP eskaera ekintzak lan-fluxua web-zerbitzari edo URL batera konektatzen du, eta HTTP eskaerak bidaltzen ditu.

Flow aplikazioak HTTP eskaera bidali ondoren, gehienez 30 segundo itxaroten du HTTP erantzun-kodea jasotzeko. Flow aplikazioak 30 segundo igarota ez badu erantzunik jasotzen, aplikazioarekiko konexioa ixten du. Geroago, eskaera berriro egiten saiatuko da.

Orri honetan

Eremuak

Bidali HTTP eskaera ekintzak ondorengo eremuak ditu.

"Bidali HTTP eskaera" ekintzan erabilitako eremuak.
EremuaDeskribapena
HTTP metodoaBidali beharreko HTTP eskaeraren metodoa. Bidali HTTP eskaera ekintzak ondorengo metodoak onartzen ditu:
  • Get: Informazio-eskaera bat bidaltzen dio zerbitzariari.
  • Delete: Baliabide bat kentzen du zerbitzaritik.
  • Head: Zerbitzariaren HTTP erantzunaren goiburuak eskuratzen ditu.
  • Options: Zerbitzariak onartzen dituen aukerak eta eginbideak eskuratzen ditu.
  • Patch: Baliabide bat partzialki eguneratzen du zerbitzarian.
  • Put: Baliabide bat eguneratzen du zerbitzarian.
  • Post: Baliabide bat sortu edo ordezten du zerbitzarian.
URLHTTP eskaera bidaltzen zaion zerbitzariaren URLa.
GoiburuakHTTP eskaerako gako eta balio bikotea. Gako-balio bikote bat baino gehiago sar daitezke.
GorputzaZerbitzariari bidali beharreko edukia.
Bezero-errorea gertatzean (4XX erantzuna)Honako hau jasotzean: Erantzun-kode bat jasotzean, bezero-errorea adierazten duena, Flow aplikazioak hau egingo du:
  • Saiatu berriro: Saiatu berriro 24 orduz, erantzun-kode desberdin bat jaso edo denbora muga amaitu arte.
  • Huts egin: Lan-fluxuaren exekuzioak huts egitea.
  • Ezikusi egin: Erroreari ezikusi egin eta lan-fluxuaren exekuzioarekin jarraitzea.
Zerbitzari-errorea gertatzean (5XX edo 429 erantzuna)Honako hau jasotzean: Erantzun-kode bat jasotzean, zerbitzari-errorea adierazten duena, Flow aplikazioak hau egingo du:
  • Saiatu berriro: Saiatu berriro 24 orduz, erantzun-kode desberdin bat jaso edo denbora muga amaitu arte.
  • Huts egin: Lan-fluxuaren exekuzioak huts egitea.
  • Ezikusi egin: Erroreari ezikusi egin eta lan-fluxuaren exekuzioarekin jarraitzea.

Itzulitako datuak

Ekintza honen ondorengo urratsetan itzulitako datuak atzitzeko, erabili sendHttpRequest izeneko aldagaia, HTTP erantzunaren xehetasun guztiak baititu. Bestela, erabili Exekutatu kodea ekintza bat erantzunaren body atala analizatzeko eta lan-fluxuaren ondorengo urratsetan erabiltzeko, beheko adibidean bezala.

Bidali HTTP eskaera ekintza bat lan-fluxu bakarrean hainbat aldiz erabiltzen bada, zenbaki bat gehitzen zaio aldagaiaren izenari. Adibidez, Bidali HTTP eskaera ekintza bi aldiz erabiltzen duen lan-fluxu batean, itzulitako datuen lehen aldagaia sendHttpRequest da, eta bigarren aldagaia sendHttpRequest1. Izen hori ezin da pertsonalizatu.

Erantzun-kodeak

Erantzuna jaso ondoren Flow-k HTTP erantzun-kodea nola prozesatzen duen azaltzen du ondorengo taulak.

Flow-k HTTP erantzun-kodeak nola prozesatzen dituen.
HTTP erantzun-kodeaFlow-k erantzun-kodea prozesatzeko modua
2XX edo 3XX ondo bideratutaFlow-k arrakastatsu gisa markatzen du HTTP eskaera, eta lan-fluxuaren ondorengo ekintzak exekutatzen ditu.
4XX erroreak,
5XX eta 429 erroreak		Ekintza nola konfiguratuta dagoen kontuan hartuta, Flow-k hau egingo du:
  • Saiatu berriro: Saiatu berriro 24 orduz, erantzun-kode desberdin bat jaso edo denbora muga amaitu arte.
  • Huts egin: Lan-fluxuaren exekuzioak huts egitea.
  • Ezikusi egin: Erroreari ezikusi egin eta lan-fluxuaren exekuzioarekin jarraitzea.
Beste erantzun-kode batErantzunak taula honetan deskribatu gabeko kode bat itzultzen badu edo ekintzak berriro exekutatzen saiatzean denbora-muga gainditzen bada, Flow-k hutsegite gisa markatuko du HTTP eskaera. Lan-fluxuaren exekuzioak huts egingo du eta ez dira lan-fluxuaren hurrengo ekintzak exekutatuko.

Sekretuak

Sekretuak Bidali HTTP eskaera ekintzan erabiltzeko kontuzko informazioa (hala nola sarbide-tokenak edo pasahitzak) modu seguruan gordetzeko erabiltzen dira. Sekretuak Flow > Ezarpenak orrian sortzen eta kudeatzen dira. Sekretu batek identifikatzaile, balio eta deskribapen bana ditu. Egin erreferentzia sekretuari Liquid aldagai gisa (adibidez, {{secrets.handle}}), edo Gehitu sekretua aukeratik URL, goiburu-balio edo gorputz-eremuak konfiguratzean. Sekretuen balioak ez dira inoiz bistaratzen Flow-ren interfazean, eta lan-fluxuaren exekuzioen erregistroetatik ezkutatu egiten dira.

Abiarazleak

Bidali HTTP eskaera ekintza edozein lan-fluxutan erabil daiteke.

Adibideak

1. adibidea: Bidali HTTP eskaera bat kanpoko zerbitzu bati

Adibide honetan, erabili Flow kanpoko zerbitzu bati HTTP eskaera bat bidaltzeko.

Hasi aurretik, konfiguratu web-zerbitzu bat HTTP eskaerak jasotzeko eta probetarako eskaera horien datuak gordetzeko (adibidez, Request Catcher). Gogoratu kontuz ibili behar duzula hirugarrenen zerbitzu bati kontuzko informazioa (hala nola pasahitzak edo API gakoak) bidaltzean.

Urratsak:

  1. Aukeratu Produktuaren egoera eguneratu da abiarazlea; horrek lan-fluxu hau probatzeko aukera ematen dizu produktu baten egoera aldatuz.
  2. Gehitu Bidali HTTP eskaera ekintza lan-fluxuan, eta konektatu abiarazlearekin. Gero, ireki konfigurazio-panela, klik eginez Bidali HTTP eskaera urratsean.
    • HTTP metodoa eremuan, idatzi POST.
    • URL eremuan, sartu proba egiteko URLa, hala nola https://yourFlowTest.requestcatcher.com/test.
    • Goiburuak atalean, idatzi goiburu bat: Gakoa eremuan Content-Type eta Balioa eremuan text/plain.
    • Gorputza atalean, idatzi {{product.title}} eta {{product.status}} abiarazlearen produktuaren izenburua eta egoera eguneratua bidaltzeko.
  3. Aktibatu lan-fluxua.
  4. Probatu produktu baten egoera aldatuz, adibidez, Zirriborroa egoeratik Aktibo egoerara.
  5. Egiaztatu emaitzak kanpoko proba-zerbitzuan (adibide honetan, https://yourFlowTest.requestcatcher.com/).

2. adibidea: Erabili "Exekutatu kodea" HTTP erantzun bat analizatzeko

Adibide honetan, erabili Flow kanpoko zerbitzu bati HTTP eskaera bat bidaltzeko eta Exekutatu kodea ekintza HTTP erantzunaren body (gorputza) analizatzeko, lan-fluxuaren hurrengo urratsetan erabiltzeko.

Hasi aurretik, aukeratu HTTP eskaerak jaso eta datuak itzultzen dituen web-zerbitzu bat, hala nola Postman Echo. Gogoratu kontuz ibili behar duzula hirugarrenen zerbitzu bati datu sentikorrak (hala nola pasahitzak edo API gakoak) bidaltzean.

Urratsak:

  1. Aukeratu Produktuaren egoera eguneratu da abiarazlea; horrek lan-fluxu hau probatzeko aukera ematen dizu produktu baten egoera aldatuz.

  2. Gehitu Bidali HTTP eskaera ekintza lan-fluxuan, eta konektatu abiarazlearekin. Gero, ireki konfigurazio-panela, klik eginez Bidali HTTP eskaera urratsean.

    • HTTP metodoa eremuan, idatzi POST.

    • URL eremuan, idatzi probak egiteko URLa, hala nola https://postman-echo.com/post.

    • Goiburuak atalean, idatzi goiburu bat: Gakoa eremuan Content-Type eta Balioa eremuan application/json.

    • Gorputza atalean, idatzi lan-fluxura itzuli beharreko JSON adibidea, hala nola:

      {
    "productTitle": "{{product.title}}",
    "productStatus": "{{product.status}}"
}

  3. Gehitu Exekutatu kodea ekintza lan-fluxuan, eta konektatu Bidali HTTP eskaera ekintzarekin. Gero, ireki konfigurazio-panela, klik eginez Exekutatu kodea urratsean.

    • Zehaztu sarrerak eremuan, sartu sendHTTPrequest objektuak itzulitako body-a, adibidez:

      query{
  sendHttpRequest {
    body
  }
}

    • Zehaztu irteerak eremuan, irteera-eskeman definitutakoa, adibidez:

      type Output {
  productTitle: String!
  productStatus: String!
}

    • Idatzi kodea eremuan, analizatu erantzuna JSON.parse metodoa erabiliz, eta ziurtatu itzultzen dituzun datuak irteera-eskeman definitutako forma eta motekin bat datozela, adibidez:

      export default function main(input) {
  const body = JSON.parse(input.sendHttpRequest.body);
  console.log("body is", body);
  return {
    productTitle: body.data.productTitle,
    productStatus: body.data.productStatus
  }
}

  4. Gehitu Erregistratu irteera ekintza lan-fluxuan, eta konektatu Exekutatu kodea ekintzarekin. Gero, ireki konfigurazio-panela, klik eginez Exekutatu kodea urratsean.

    • Irteera eremuan, sartu Exekutatu kodea urratsak itzulitako aldagaiak, adibidez:

      Title from HTTP response: {{runCode.productTitle}}
Status from HTTP response: {{runCode.productStatus}}

  5. Aktibatu lan-fluxua.

  6. Probatu produktu baten egoera aldatuz, adibidez, Zirriborroa egoeratik Aktibo egoerara.

  7. Egiaztatu exekuzioaren emaitza Flow / Azken exekuzioak orrian, eta ziurtatu Erregistratu irteera urratseko balioak bat datozela Bidali HTTP eskaera ekintzaren irteerak itzulitakoekin.

Txantiloiak

Jakinarazi eskaerak osatzeko hornitzaileari hurrengo eskaeren berri

Eskaerak Order Tagger-en "Warehouse" etiketarekin markatzean, bidali HTTP eskaera bat eskaerak osatzeko hornitzaileari. Ikusi txantiloia

Bidali eskaera berriak Airtable-ra

Bidali eskaerak Airtable-ra eskaera bat sortzen denean. Ikusi txantiloia

Bidali lehendik dauden zein produktu berriak Airtable-ra

10 minutuz behin, bilatu Airtable-ra bidali ez diren produktuak (etiketaren arabera) eta bidali Airtable-ra. Ikusi txantiloia

Eguneratu produktuak sortaka, Airtable-n gordetako produktuen datuetatik abiatuta

Eguneratu produktuak sortaka, Airtable-n gordetako produktuen datuetatik abiatuta. Ikusi txantiloia

Jakinarazi bezeroei iraungitzen ari diren opari-txartelen berri, SendGrid erabiliz

Egunero, bildu 7 egun barru iraungiko diren opari-txartel guztiak, eta bidali mezu elektronikoak bezeroei, SendGrid erabilita. Ikusi txantiloia

Bidali mezu elektronikoa SendGrid erabiliz bezeroek produktu pertsonalizatu baten eskaera egiten dutenean

Bidali mezu elektroniko transakzionala SendGrid erabiliz bezero batek produktu pertsonalizatu baten eskaera egiten duenean. Ikusi txantiloia