Abi
Logi sisse

Saada HTTP-päring

Toiming Saada HTTP-päring ühendab töövoo veebiserveri või URL-iga ja saadab HTTP-päringuid.

Pärast seda, kui Flow on HTTP-päringu saatnud, ootab see kuni 30 sekundit HTTP vastusekoodi. Kui Flow ei saa 30 sekundi jooksul vastust, sulgeb see ühenduse sinu rakendusega. Hiljem proovib see päringut uuesti.

Sellel lehel

Väljad

Toiming Saada HTTP-päring sisaldab järgmisi välju.

Toimingus Saada HTTP-päring kasutatavad väljad.
VäliKirjeldus
HTTP-meetodSaadetava HTTP-päringu meetod. Toiming Saada HTTP-päring toetab järgmisi meetodeid:
  • Get – saadab serverisse teabepäringu.
  • Delete – eemaldab serverist ressursi.
  • Head – toob serveri HTTP-vastuse päised.
  • Options – toob valikud ja funktsioonid, mida server toetab.
  • Patch – uuendab serveris ressurssi osaliselt.
  • Put – uuendab serveris olevat ressurssi.
  • Post – loob serveris ressursi või asendab selle.
URLServeri URL, kuhu HTTP-päring saadetakse.
PäisedVõtme-väärtuse paar HTTP-päringu jaoks. Sisestada saab mitu võtme-väärtuse paari.
KehaServerile saadetav sisu.
Kliendi vea korral (4XX-vastus)Saades vastusekoodi , mis viitab kliendiveale, teeb Flow järgmist:
  • Proovi uuesti – proovib uuesti kuni 24 tundi, kuni saab teistsuguse vastusekoodi või aegub.
  • Ebaõnnestu – märgib töövoo käivituse ebaõnnestunuks.
  • Eira – eirab viga ja jätkab töövoo käivitust.
Serverivea korral (5XX- või 429-vastus)Saades vastusekoodi , mis viitab serveriveale, teeb Flow järgmist:
  • Proovi uuesti – proovib uuesti kuni 24 tundi, kuni saab teistsuguse vastusekoodi või aegub.
  • Ebaõnnestu – märgib töövoo käivituse ebaõnnestunuks.
  • Eira – eirab viga ja jätkab töövoo käivitust.

Tagastatud andmed

Sellele toimingule järgnevates sammudes tagastatud andmetele juurde pääsemiseks kasuta muutujat nimega sendHttpRequest, mis sisaldab kõiki HTTP-vastuse üksikasju. Valikuliselt kasuta vastuse body sõelumiseks toimingut Käivita kood, et kasutada seda hilisemates töövoo sammudes, nagu alltoodud näites.

Kui ühes töövoos kasutatakse mitu korda toimingut Saada HTTP-päring, lisatakse muutuja nimele number. Näiteks töövoos, mis kasutab toimingut Saada HTTP-päring kaks korda, on esimene tagastatud andmete muutuja sendHttpRequest ja teine muutuja sendHttpRequest1. Seda nime ei saa kohandada.

Vastusekoodid

Järgnev tabel kirjeldab, kuidas Flow töötleb HTTP-vastuse koodi pärast vastuse saamist.

Kuidas Flow HTTP-vastuse koode töötleb.
HTTP-vastuse koodKuidas Flow vastuse koodi töötleb
2XX või 3XX edukasFlow märgib HTTP-päringu edukaks ja teeb töövoos järgnevad toimingud.
4XX vead,
5XX ja 429 vead		Olenevalt toimingu seadistamisest teeb Flow järgmist:
  • Proovi uuesti – proovib uuesti kuni 24 tundi, kuni saab teistsuguse vastusekoodi või aegub.
  • Ebaõnnestu – märgib töövoo käivituse ebaõnnestunuks.
  • Eira – eirab viga ja jätkab töövoo käivitust.
Muu vastuse koodKui vastus tagastab koodi, mida selles tabelis ei kirjeldata, või toimingute uuesti proovimisel ilmneb ajalõpp, märgib Flow HTTP-päringu ebaõnnestunuks, nurjab töövoo käivituse ega tee töövoo järgnevaid toiminguid.

Saladused

Saladusi kasutatakse tundliku teabe (nt juurdepääsutõendite või paroolide) turvaliseks salvestamiseks ja toimingus Saada HTTP-päring kasutamiseks. Saladusi luuakse ja hallatakse lehel Flow > Seaded. Saladus sisaldab identifikaatorit, väärtust ja kirjeldust. Viita saladusele kui Liquidi muutujale (nt {{secrets.handle}}) või valikust Lisa saladus, kui seadistad URL-i, päiseväärtuse või sisu välju. Saladuste väärtused pole Flow liideses kunagi nähtavad ja need on töövoo käivituse logides peidetud.

Käivitajad

Toimingut Saada HTTP-päring saab kasutada igas töövoos.

Näited

Näide 1. Saada HTTP-päring välisesse teenusesse

Selles näites kasutatakse Flow'd HTTP-päringu saatmiseks välisesse teenusesse.

Enne alustamist seadista veebiteenus, mis võtab vastu HTTP-päringuid ja salvestab nende päringute andmed testimiseks, näiteks Request Catcher. Pea meeles, et tundlike andmete (nt paroolide või API võtmete) saatmisel kolmanda osapoole teenusesse pead olema ettevaatlik.

Sammud:

  1. Vali käivitaja Toote olek on uuendatud, mis võimaldab sul seda töövoogu testida, muutes toote olekut.
  2. Lisa töövoogu toiming Saada HTTP-päring ja ühenda see käivitajaga. Seejärel ava seadistuspaneel, klõpsates sammul Saada HTTP-päring .
    • Sisesta väljale HTTP-meetod POST.
    • Sisesta väljale URL testitav URL, näiteks https://yourFlowTest.requestcatcher.com/test.
    • Jaotises Päised sisesta päis, mille Võti on Content-Type ja Väärtus on text/plain.
    • Jaotises Sisu sisesta {{product.title}} ja {{product.status}}, et saata käivitajast toote pealkiri ja uuendatud olek.
  3. Aktiveeri töövoog.
  4. Testi seda, muutes toote olekut, näiteks olekust Mustand olekusse Aktiivne.
  5. Vaata tulemusi välises testimisteenuses, näiteks selles näites aadressil https://yourFlowTest.requestcatcher.com/.

Näide 2. Kasuta toimingut Käivita kood HTTP-vastuse sõelumiseks

Selles näites kasutatakse Flow'd HTTP-päringu saatmiseks välisesse teenusesse ja toimingut Käivita kood, et sõeluda HTTP-vastuse sisu (body) kasutamiseks töövoo järgnevates sammudes.

Enne alustamist vali veebiteenus, mis võtab vastu HTTP-päringuid ja tagastab andmeid, näiteks Postman Echo. Pea meeles, et tundlike andmete (nt paroolide või API võtmete) saatmisel kolmanda osapoole teenusesse pead olema ettevaatlik.

Sammud:

  1. Vali käivitaja Toote olek on uuendatud, mis võimaldab sul seda töövoogu testida, muutes toote olekut.

  2. Lisa töövoogu toiming Saada HTTP-päring ja ühenda see käivitajaga. Seejärel ava seadistuspaneel, klõpsates sammul Saada HTTP-päring.

    • Sisesta väljale HTTP-meetod POST.

    • Sisesta väljale URL testitav URL, näiteks https://postman-echo.com/post.

    • Jaotises Päised sisesta päis, mille Võti on Content-Type ja Väärtus on application/json.

    • Jaotises Sisu sisesta näidis-JSON, mis tagastatakse töövoogu, näiteks:

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

  3. Lisa töövoogu toiming Käivita kood ja ühenda see toiminguga Saada HTTP-päring. Seejärel ava seadistuspaneel, klõpsates sammul Käivita kood.

    • Sisalda väljal Määratle sisendid objekti sendHTTPrequest tagastatud body, näiteks:

      query{
  sendHttpRequest {
    body
  }
}

    • Määratle väljal Määratle väljundid väljundiskeem, näiteks:

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

    • Sõelu väljal Kirjuta kood vastus, kasutades meetodit JSON.parse, ja veendu, et tagastatavad andmed vastavad väljundiskeemis määratletud kujule ja tüüpidele, näiteks:

      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. Lisa töövoogu toiming Logi väljund ja ühenda see toiminguga Käivita kood. Seejärel ava seadistuspaneel, klõpsates sammul Käivita kood.

    • Kaasa väljale Väljund sammu Käivita kood tagastatud muutujad, näiteks:

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

  5. Aktiveeri töövoog.

  6. Testi seda, muutes toote olekut, näiteks olekust Mustand olekusse Aktiivne.

  7. Vaata tulemuseks saadud käivitust lehelt Flow / Hiljutised käivitused ja pane tähele, et sammu Logi väljund väärtused vastavad toimingu Saada HTTP-päring väljundist tagastatud väärtustele.

Mallid

Teavita oma tellimuste täitmise teenusepakkujat tulevastest tellimustest

Saada oma tellimuste täitmise teenusepakkujale HTTP-päring, kui tellimustele on rakenduse Order Tagger abil lisatud silt „Warehouse“. Vaata malli

Saada uued tellimused Airtable'isse

Saada tellimused Airtable'isse, kui tellimus on loodud. Vaata malli

Saada kõik olemasolevad ja uued tooted Airtable'isse

Otsi iga 10 minuti järel (sildi järgi) tooteid, mida ei ole Airtable'isse saadetud, ja saada need Airtable'isse. Vaata malli

Uuenda tooteid partiidena Airtable'isse salvestatud tooteandmete põhjal

Uuenda tooteid partiidena Airtable'isse salvestatud tooteandmete põhjal. Vaata malli

Teavita kliente aeguvatest kinkekaartidest SendGridi abil

Leia iga päev kõik kinkekaardid, mis aeguvad 7 päeva pärast, ja saada SendGridi abil klientidele e-kirjad. Vaata malli

Saada e-kiri SendGridi abil, kui klient esitab eritellimusel üksuse tellimuse

Saada tehingupõhine e-kiri SendGridi abil, kui klient esitab eritellimusel üksuse tellimuse. Vaata malli