Αποστολή αιτήματος HTTP
Η ενέργεια «Αποστολή αιτήματος HTTP» συνδέει τη ροή εργασίας σας με έναν διακομιστή web ή ένα URL και αποστέλλει αιτήματα HTTP.
Αφού το Flow στείλει το αίτημα HTTP, περιμένει για 30 δευτερόλεπτα το πολύ για έναν κωδικό απόκρισης HTTP. Εάν το Flow δεν λάβει απόκριση μετά από 30 δευτερόλεπτα, τότε κλείνει τη σύνδεση με την εφαρμογή σας. Αργότερα, προσπαθεί ξανά να στείλει το αίτημα.
Σε αυτήν τη σελίδα
Πεδία
Η ενέργεια «Αποστολή αιτήματος HTTP» περιέχει τα ακόλουθα πεδία.
| Πεδίο | Περιγραφή |
|---|---|
| Μέθοδος HTTP | Η μέθοδος του αιτήματος HTTP που θα σταλεί. Η Αποστολή αιτήματος HTTP ενέργεια υποστηρίζει τις ακόλουθες μεθόδους:
|
| URL | Το URL του διακομιστή στον οποίο αποστέλλεται το αίτημα HTTP. |
| Επικεφαλίδες | Το ζεύγος κλειδιού και τιμής για το αίτημα HTTP. Μπορούν να εισαχθούν πολλά ζεύγη κλειδιού-τιμής. |
| Σώμα | Το περιεχόμενο που θα σταλεί στον διακομιστή. |
| Σε περίπτωση σφάλματος πελάτη (απόκριση 4XX) | Όταν λαμβάνετε έναν κωδικό απόκρισης που υποδεικνύει σφάλμα πελάτη, το Flow θα:
|
| Σε περίπτωση σφάλματος διακομιστή (απόκριση 5XX ή 429) | Όταν λαμβάνετε έναν κωδικό απόκρισης που υποδεικνύει σφάλμα διακομιστή, το Flow θα:
|
Επιστρεφόμενα δεδομένα
Για να αποκτήσετε πρόσβαση στα επιστρεφόμενα δεδομένα σε βήματα που ακολουθούν αυτήν την ενέργεια, χρησιμοποιήστε τη μεταβλητή με το όνομα sendHttpRequest, η οποία περιλαμβάνει όλες τις λεπτομέρειες της απόκρισης HTTP. Προαιρετικά, χρησιμοποιήστε μια ενέργεια «Εκτέλεση κώδικα» για να αναλύσετε το body της απόκρισης για χρήση σε επόμενα βήματα της ροής εργασίας, όπως στο παράδειγμα παρακάτω.
Εάν η ενέργεια Αποστολή αιτήματος HTTP χρησιμοποιηθεί πολλές φορές σε μία μόνο ροή εργασίας, τότε προστίθεται ένας αριθμός στο όνομα της μεταβλητής. Για παράδειγμα, σε μια ροή εργασίας που χρησιμοποιεί την ενέργεια Αποστολή αιτήματος HTTP δύο φορές, η πρώτη μεταβλητή για τα δεδομένα που επιστρέφονται είναι sendHttpRequest και η δεύτερη μεταβλητή είναι sendHttpRequest1. Αυτό το όνομα δεν μπορεί να προσαρμοστεί.
Κωδικοί απόκρισης
Ο παρακάτω πίνακας περιγράφει πώς το Flow επεξεργάζεται τον κωδικό απόκρισης HTTP αφού λάβει μια απόκριση.
| Κωδικός απόκρισης HTTP | Πώς το Flow επεξεργάζεται τον κωδικό απόκρισης |
|---|---|
| 2XX ή 3XX Επιτυχία | Το Flow επισημαίνει το αίτημα HTTP ως επιτυχές και εκτελεί τις επόμενες ενέργειες στη ροή εργασίας. |
| Σφάλματα 4XX, Σφάλματα 5XX και 429 | Ανάλογα με τον τρόπο διαμόρφωσης της ενέργειας, το Flow θα:
|
| Άλλος κωδικός απόκρισης | Εάν η απόκριση επιστρέψει έναν κωδικό που δεν περιγράφεται σε αυτόν τον πίνακα ή εάν λήξει το χρονικό όριο κατά την επανάληψη των ενεργειών, τότε το Flow επισημαίνει το αίτημα HTTP ως αποτυχημένο, προκαλεί την αποτυχία της εκτέλεσης της ροής εργασίας και δεν εκτελεί τις επόμενες ενέργειες της ροής εργασίας. |
Μυστικά
Τα μυστικά χρησιμοποιούνται για την ασφαλή αποθήκευση ευαίσθητων πληροφοριών για χρήση στην ενέργεια Αποστολή αιτήματος HTTP, όπως τα διακριτικά πρόσβασης ή οι κωδικοί πρόσβασης. Τα μυστικά δημιουργούνται και διαχειρίζονται από τη σελίδα Flow > Ρυθμίσεις. Ένα μυστικό περιέχει ένα handle (προσδιοριστικό οντότητας), μια τιμή και μια περιγραφή. Αναφερθείτε στο μυστικό ως μεταβλητή Liquid (όπως {{secrets.handle}}) ή από την επιλογή Προσθήκη μυστικού κατά τη διαμόρφωση των πεδίων URL, Τιμής επικεφαλίδας ή Σώματος. Οι τιμές των μυστικών δεν είναι ποτέ ορατές στη διεπαφή του Flow και αποκρύπτονται από τα αρχεία καταγραφής των εκτελέσεων της ροής εργασίας.
Στοιχεία ενεργοποίησης
Η ενέργεια «Αποστολή αιτήματος HTTP» μπορεί να χρησιμοποιηθεί σε οποιαδήποτε ροή εργασίας.
Παραδείγματα
Παράδειγμα 1: Αποστολή αιτήματος HTTP σε εξωτερική υπηρεσία
Σε αυτό το παράδειγμα, χρησιμοποιήστε το Flow για να στείλετε ένα αίτημα HTTP σε μια εξωτερική υπηρεσία.
Πριν ξεκινήσετε, διαμορφώστε μια υπηρεσία web που λαμβάνει αιτήματα HTTP και αποθηκεύει τα δεδομένα αυτών των αιτημάτων για δοκιμή, όπως το Request Catcher. Να θυμάστε να είστε προσεκτικοί όταν στέλνετε ευαίσθητα δεδομένα (όπως κωδικούς πρόσβασης ή κλειδιά API) σε μια υπηρεσία τρίτου.
Βήματα:
- Επιλέξτε το στοιχείο ενεργοποίησης Ενημερώθηκε η κατάσταση προϊόντος, το οποίο σας επιτρέπει να δοκιμάσετε αυτήν τη ροή εργασίας αλλάζοντας την κατάσταση σε ένα προϊόν.
- Προσθέστε μια Αποστολή αιτήματος HTTP ενέργεια στη ροή εργασίας σας και συνδέστε την με το στοιχείο ενεργοποίησης. Στη συνέχεια, ανοίξτε τον πίνακα διαμόρφωσης κάνοντας κλικ στο Αποστολή αιτήματος HTTP βήμα.
- Στο πεδίο Μέθοδος HTTP, εισαγάγετε
POST. - Στο πεδίο URL, εισαγάγετε τη διεύθυνση URL για δοκιμή, όπως
https://yourFlowTest.requestcatcher.com/test. - Στην ενότητα Επικεφαλίδες, εισαγάγετε μια επικεφαλίδα με Κλειδί
Content-Typeκαι Τιμήtext/plain. - Στην ενότητα Σώμα, εισαγάγετε
{{product.title}}και{{product.status}}για να στείλετε τον τίτλο και την ενημερωμένη κατάσταση του προϊόντος από το στοιχείο ενεργοποίησης.
- Στο πεδίο Μέθοδος HTTP, εισαγάγετε
- Ενεργοποιήστε τη ροή εργασίας.
- Δοκιμάστε την αλλάζοντας την κατάσταση σε ένα προϊόν, για παράδειγμα από Πρόχειρο σε Ενεργό.
- Παρατηρήστε τα αποτελέσματα στην εξωτερική υπηρεσία δοκιμών, όπως
https://yourFlowTest.requestcatcher.com/σε αυτό το παράδειγμα.
Παράδειγμα 2: Χρήση της ενέργειας «Εκτέλεση κώδικα» για την ανάλυση μιας απόκρισης HTTP
Σε αυτό το παράδειγμα, χρησιμοποιήστε το Flow για να στείλετε ένα αίτημα HTTP σε μια εξωτερική υπηρεσία και μια ενέργεια Εκτέλεση κώδικα για να αναλύσετε το σώμα της απόκρισης HTTP για χρήση σε επόμενα βήματα της ροής εργασίας.
Πριν ξεκινήσετε, επιλέξτε μια υπηρεσία web που λαμβάνει αιτήματα HTTP και επιστρέφει δεδομένα, όπως το Postman Echo. Να είστε προσεκτικοί όταν στέλνετε ευαίσθητα δεδομένα (όπως κωδικούς πρόσβασης ή κλειδιά API) σε υπηρεσία τρίτου.
Βήματα:
Επιλέξτε το στοιχείο ενεργοποίησης Ενημερώθηκε η κατάσταση προϊόντος, το οποίο σας επιτρέπει να δοκιμάσετε αυτήν τη ροή εργασίας αλλάζοντας την κατάσταση σε ένα προϊόν.
Προσθέστε μια ενέργεια Αποστολή αιτήματος HTTP στη ροή εργασίας σας και συνδέστε την με το στοιχείο ενεργοποίησης. Στη συνέχεια, ανοίξτε τον πίνακα διαμόρφωσης κάνοντας κλικ στο βήμα Αποστολή αιτήματος HTTP.
Στο πεδίο Μέθοδος HTTP, εισαγάγετε
POST.Στο πεδίο URL, εισαγάγετε τη διεύθυνση URL για δοκιμή, όπως
https://postman-echo.com/post.Στην ενότητα Επικεφαλίδες, εισαγάγετε μια επικεφαλίδα με Κλειδί
Content-Typeκαι Τιμήapplication/json.Στην ενότητα Σώμα, εισαγάγετε το παράδειγμα JSON που θα επιστραφεί στη ροή εργασίας, ως εξής:
{ "productTitle": "{{product.title}}", "productStatus": "{{product.status}}" }
Προσθέστε μια ενέργεια Εκτέλεση κώδικα στη ροή εργασίας σας και συνδέστε την με την ενέργεια Αποστολή αιτήματος HTTP. Στη συνέχεια, ανοίξτε τον πίνακα διαμόρφωσης κάνοντας κλικ στο βήμα Εκτέλεση κώδικα.
Στο πεδίο Ορισμός εισόδων, συμπεριλάβετε το
σώμαπου επιστρέφεται από το αντικείμενοsendHTTPrequest, ως εξής:query{ sendHttpRequest { body } }Στο πεδίο Ορισμός εξόδων, ορίστε το σχήμα εξόδου, ως εξής:
type Output { productTitle: String! productStatus: String! }Στο πεδίο Σύνταξη κώδικα, αναλύστε την απόκριση χρησιμοποιώντας τη μέθοδο
JSON.parseκαι βεβαιωθείτε ότι τα δεδομένα που επιστρέφετε ταιριάζουν με το σχήμα και τους τύπους που ορίζονται στο σχήμα εξόδου, ως εξής: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 } }
Προσθέστε μια ενέργεια Καταγραφή εξόδου στη ροή εργασίας σας και συνδέστε την με την ενέργεια Εκτέλεση κώδικα. Στη συνέχεια, ανοίξτε τον πίνακα διαμόρφωσης κάνοντας κλικ στο βήμα Εκτέλεση κώδικα.
Στο πεδίο Έξοδος, συμπεριλάβετε τις μεταβλητές που επιστρέφονται από το βήμα Εκτέλεση κώδικα, ως εξής:
Title from HTTP response: {{runCode.productTitle}} Status from HTTP response: {{runCode.productStatus}}
Ενεργοποιήστε τη ροή εργασίας.
Δοκιμάστε την αλλάζοντας την κατάσταση σε ένα προϊόν, για παράδειγμα από Πρόχειρο σε Ενεργό.
Παρατηρήστε την εκτέλεση που προκύπτει από τη σελίδα Flow / Πρόσφατες εκτελέσεις και σημειώστε ότι οι τιμές στο βήμα Καταγραφή εξόδου αντιστοιχούν στις τιμές που επιστράφηκαν από την έξοδο της ενέργειας Αποστολή αιτήματος HTTP.
Πρότυπα
Ειδοποίηση του παρόχου υπηρεσιών διεκπεραίωσης σχετικά με επερχόμενες παραγγελίες
Αποστολή αιτήματος HTTP στον πάροχο υπηρεσιών διεκπεραίωσης όταν οι παραγγελίες επισημαίνονται με την ετικέτα «Warehouse» στο Order Tagger. Προβολή προτύπου
Αποστολή νέων παραγγελιών στο Airtable
Αποστολή παραγγελιών στο Airtable όταν δημιουργείται μια παραγγελία. Προβολή προτύπου
Αποστολή όλων των υπαρχόντων και νέων προϊόντων στο Airtable
Κάθε 10 λεπτά, βρείτε προϊόντα που δεν έχουν σταλεί στο Airtable (μέσω ετικέτας) και στείλτε τα στο Airtable. Προβολή προτύπου
Ενημέρωση προϊόντων σε παρτίδες από δεδομένα προϊόντων που είναι αποθηκευμένα στο Airtable
Ενημέρωση προϊόντων σε παρτίδες από δεδομένα προϊόντων που είναι αποθηκευμένα στο Airtable. Προβολή προτύπου
Ειδοποίηση πελατών για δωροκάρτες που λήγουν χρησιμοποιώντας το SendGrid
Κάθε μέρα, γίνεται ανάκτηση όλων των δωροκαρτών που λήγουν σε 7 ημέρες και αποστολή email στους πελάτες με χρήση του SendGrid. Προβολή προτύπου
Αποστολή email με χρήση του SendGrid όταν οι πελάτες υποβάλλουν παραγγελία για ένα προσαρμοσμένο είδος
Αποστολή email συναλλαγής με χρήση του SendGrid όταν ένας πελάτης υποβάλλει παραγγελία για ένα προσαρμοσμένο είδος. Προβολή προτύπου