Pošalji HTTP zahtjev

Radnja Pošalji HTTP zahtjev povezuje tijek rada s web-poslužiteljem ili URL-om te šalje HTTP zahtjeve.

Nakon što Flow pošalje HTTP zahtjev, čeka najviše 30 sekundi na kôd HTTP odgovora. Ako Flow ne primi odgovor nakon 30 sekundi, zatvara vezu s aplikacijom. Poslije će ponovno pokušati poslati zahtjev.

Polja

Radnja Pošalji HTTP zahtjev sadrži sljedeća polja.

Polja koja se upotrebljavaju u radnji Pošalji HTTP zahtjev.
PoljeOpis
HTTP metodaMetoda HTTP zahtjeva za slanje. Radnja Pošalji HTTP zahtjev podržava sljedeće metode:
  • Get – šalje zahtjev za informacije s poslužitelja.
  • Delete – uklanja resurs s poslužitelja.
  • Head – dohvaća zaglavlja HTTP odgovora s poslužitelja.
  • Options – dohvaća opcije i značajke koje podržava poslužitelj.
  • Patch – djelomično ažurira resurs na poslužitelju.
  • Put – ažurira resurs na poslužitelju.
  • Post – izrađuje ili zamjenjuje resurs na poslužitelju.
URLURL poslužitelja kojem se šalje HTTP zahtjev.
ZaglavljaPar ključa i vrijednosti za HTTP zahtjev. Moguće je unijeti više parova ključa i vrijednosti.
TijeloSadržaj koji se šalje poslužitelju.
U slučaju pogreške klijenta (odgovor 4XX)Kada primi kôd odgovora koji ukazuje na pogrešku klijenta, Flow će:
  • Pokušaj ponovno – pokušavat će ponovno do 24 sata dok ne primi drugi kôd odgovora ili dok ne istekne vrijeme.
  • Neuspješno – prekida pokretanje tijeka rada zbog pogreške.
  • Zanemari – zanemaruje pogrešku i nastavlja pokretanje tijeka rada.
U slučaju pogreške poslužitelja (odgovor 5XX ili 429)Kada primi kôd odgovora koji ukazuje na pogrešku poslužitelja, Flow će:
  • Pokušaj ponovno – pokušavat će ponovno do 24 sata dok ne primi drugi kôd odgovora ili dok ne istekne vrijeme.
  • Neuspješno – prekida pokretanje tijeka rada zbog pogreške.
  • Zanemari – zanemaruje pogrešku i nastavlja pokretanje tijeka rada.

Vraćeni podaci

Da biste pristupili vraćenim podacima u koracima nakon te radnje, upotrijebite varijablu sendHttpRequest, koja sadrži sve informacije o HTTP odgovoru. Prema potrebi upotrijebite radnju Pokreni kod da biste raščlanili body odgovora i upotrijebili ga u kasnijim koracima tijeka rada, kao u primjeru u nastavku.

Ako se radnja Pošalji HTTP zahtjev upotrebljava više puta u jednom tijeku rada, nazivu varijable dodaje se broj. Na primjer, u tijeku rada koji dvaput upotrebljava radnju Pošalji HTTP zahtjev, prva varijabla za vraćene podatke je sendHttpRequest, a druga je sendHttpRequest1. Taj se naziv ne može prilagoditi.

Kodovi odgovora

U sljedećoj je tablici opisano kako Flow obrađuje kod HTTP odgovora nakon primitka odgovora.

Kako Flow obrađuje kodove HTTP odgovora.
Kod HTTP odgovoraKako Flow obrađuje kod odgovora
2XX ili 3XX – uspješnoFlow označava HTTP zahtjev kao uspješan i izvršava sljedeće radnje u tijeku rada.
Pogreške 4XX,
pogreške 5XX i 429
Ovisno o konfiguraciji radnje, Flow će učiniti sljedeće:
  • Pokušaj ponovno – pokušavat će ponovno do 24 sata dok ne primi drugi kôd odgovora ili dok ne istekne vrijeme.
  • Neuspješno – prekida pokretanje tijeka rada zbog pogreške.
  • Zanemari – zanemaruje pogrešku i nastavlja pokretanje tijeka rada.
Ostali kodovi odgovoraAko odgovor vrati kod koji nije opisan u ovoj tablici ili ako dođe do isteka vremena pri ponovnom pokušaju izvođenja radnji, Flow označava HTTP zahtjev kao neuspješan, zaustavlja pokretanje tijeka rada uz pogrešku i ne izvršava sljedeće radnje u tijeku rada.

Tajne

Tajne se upotrebljavaju za sigurno pohranjivanje osjetljivih informacija za upotrebu u radnji Pošalji HTTP zahtjev, kao što su pristupni tokeni ili lozinke. Tajne se izrađuju i njima se upravlja na stranici Flow > Postavke. Tajna sadrži identifikator, vrijednost i opis. Referencirajte tajnu kao varijablu Liquid (npr. {{secrets.handle}}) ili putem opcije Dodaj tajnu pri konfiguraciji polja URL, Vrijednost zaglavlja ili Tijelo. Vrijednosti tajni nikad nisu vidljive u sučelju aplikacije Flow i izostavljene su iz dnevnika pokretanja tijeka rada.

Pokretači

Radnja Pošalji HTTP zahtjev može se upotrijebiti u bilo kojem tijeku rada.

Primjeri

1. primjer: Slanje HTTP zahtjeva vanjskoj usluzi

U ovom primjeru upotrijebite Flow za slanje HTTP zahtjeva vanjskoj usluzi.

Prije početka konfigurirajte web-uslugu koja prima HTTP zahtjeve i pohranjuje podatke iz tih zahtjeva radi testiranja, kao što je Request Catcher. Imajte na umu da trebate biti oprezni pri slanju osjetljivih podataka (kao što su lozinke ili API ključevi) usluzi treće strane.

Koraci:

  1. Odaberite pokretač Ažuriran status proizvoda koji vam omogućuje testiranje tog tijeka rada promjenom statusa na proizvodu.
  2. Dodajte radnju Pošalji HTTP zahtjev u tijek rada i povežite je s pokretačem. Zatim otvorite konfiguracijsku ploču klikom na korak Pošalji HTTP zahtjev .
    • U polje HTTP metoda unesite POST.
    • U polje URL unesite URL za testiranje, kao što je https://yourFlowTest.requestcatcher.com/test.
    • U odjeljku Zaglavlja unesite zaglavlje tako da postavite Ključ na Content-Type, a Vrijednost na text/plain.
    • U odjeljak Tijelo unesite {{product.title}} i {{product.status}} kako biste poslali naziv i ažurirani status proizvoda iz pokretača.
  3. Aktivirajte tijek rada.
  4. Testirajte ga mijenjanjem statusa proizvoda, na primjer iz Skica u Aktivno.
  5. Provjerite rezultate na vanjskoj usluzi za testiranje, kao što je https://yourFlowTest.requestcatcher.com/ u ovom primjeru.

2. primjer: Upotreba radnje Pokreni kod za raščlanjivanje HTTP odgovora

U ovom primjeru upotrijebite Flow za slanje HTTP zahtjeva vanjskoj usluzi i radnju Pokreni kod za raščlanjivanje elementa body iz HTTP odgovora za upotrebu u kasnijim koracima tijeka rada.

Prije početka odaberite web-uslugu koja prima HTTP zahtjeve i vraća podatke, kao što je Postman Echo. Imajte na umu da trebate biti oprezni pri slanju osjetljivih podataka (kao što su lozinke ili API ključevi) usluzi treće strane.

Koraci:

  1. Odaberite pokretač Ažuriran status proizvoda koji vam omogućuje testiranje tog tijeka rada promjenom statusa na proizvodu.

  2. Dodajte radnju Pošalji HTTP zahtjev u tijek rada i povežite je s pokretačem. Zatim otvorite konfiguracijsku ploču klikom na korak Pošalji HTTP zahtjev.

    • U polje HTTP metoda unesite POST.

    • U polje URL unesite URL za testiranje, kao što je https://postman-echo.com/post.

    • U odjeljku Zaglavlja unesite zaglavlje tako da postavite Ključ na Content-Type, a Vrijednost na application/json.

    • U odjeljak Tijelo unesite ogledni JSON za vraćanje tijeku rada, na primjer:

      {
          "productTitle": "{{product.title}}",
          "productStatus": "{{product.status}}"
      }
  3. Dodajte radnju Pokreni kod u tijek rada i povežite je s radnjom Pošalji HTTP zahtjev. Zatim otvorite konfiguracijsku ploču klikom na korak Pokreni kod.

    • U polje Definiranje unosa uključite body koji vraća objekt sendHTTPrequest, na primjer:

      query{
        sendHttpRequest {
          body
        }
      }
    • U polje Definiranje izlaza unesite podatke definirane u shemi izlaza, na primjer:

      type Output {
        productTitle: String!
        productStatus: String!
      }
    • U polju Napiši kod raščlanite odgovor s pomoću metode JSON.parse i provjerite odgovaraju li vraćeni podaci obliku i vrstama definiranim u shemi izlaza, na primjer:

      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. Dodajte radnju Zabilježi izlaz u tijek rada i povežite je s radnjom Pokreni kod. Zatim otvorite konfiguracijsku ploču klikom na korak Pokreni kod.

    • U polje Izlaz uključite varijable koje je vratio korak Pokreni kod, na primjer:

      Title from HTTP response: {{runCode.productTitle}}
      Status from HTTP response: {{runCode.productStatus}}
  5. Aktivirajte tijek rada.

  6. Testirajte ga mijenjanjem statusa proizvoda, na primjer iz Skica u Aktivno.

  7. Provjerite dobiveno pokretanje na stranici Flow / Nedavna pokretanja i uvjerite se da se vrijednosti u koraku Zabilježi izlaz podudaraju s vrijednostima vraćenim iz izlaza radnje Pošalji HTTP zahtjev.

Predlošci

Obavijestite pružatelja usluga obrade narudžbi o nadolazećim narudžbama

Pošaljite HTTP zahtjev pružatelju usluga obrade narudžbi kada su narudžbe označene oznakom „Warehouse” u aplikaciji Order Tagger. Prikaži predložak

Slanje novih narudžbi u Airtable

Pošaljite narudžbe u Airtable pri izradi narudžbe. Prikaži predložak

Pošaljite sve postojeće i nove proizvode u sustav Airtable

Svakih 10 minuta pronađite proizvode koji nisu poslani u sustav Airtable (prema oznaci) i pošaljite ih u sustav Airtable. Prikaži predložak

Ažurirajte proizvode u serijama na temelju podataka o proizvodima pohranjenih u sustavu Airtable

Ažurirajte proizvode u serijama na temelju podataka o proizvodima pohranjenih u sustavu Airtable. Prikaži predložak

Obavijestite korisnike o poklon karticama koje istječu putem usluge SendGrid

Svaki dan dohvatite sve poklon kartice koje istječu za 7 dana i pošaljite e-poruke korisnicima putem usluge SendGrid. Prikaži predložak

Pošaljite e-poruku putem usluge SendGrid kada korisnik izvrši narudžbu za prilagođenu stavku

Pošaljite transakcijsku e-poruku putem usluge SendGrid kada korisnik izvrši narudžbu za prilagođenu stavku. Prikaži predložak