Gửi yêu cầu HTTP
Thao tác Gửi yêu cầu HTTP sẽ kết nối quy trình làm việc với máy chủ web hoặc URL và gửi yêu cầu HTTP.
Sau khi gửi yêu cầu HTTP, Flow sẽ chờ mã phản hồi HTTP trong tối đa 30 giây. Nếu không nhận được phản hồi sau 30 giây, Flow sẽ đóng kết nối với ứng dụng và gửi lại yêu cầu.
Trên trang này
Trường
Thao tác Gửi yêu cầu HTTP bao gồm các trường sau.
Trường | Mô tả |
---|---|
Phương thức HTTP | Phương thức gửi yêu cầu HTTP. Thao tác Gửi yêu cầu HTTP hỗ trợ các phương thức sau:
|
URL | URL của máy chủ nhận yêu cầu HTTP. |
Đầu trang | Cặp khóa và giá trị cho yêu cầu HTTP. Có thể nhập nhiều cặp khóa-giá trị. |
Nội dung | Nội dung được gửi đến máy chủ. |
Yếu tố kích hoạt
Bạn có thể sử dụng thao tác Gửi yêu cầu HTTP trong bất kỳ quy trình làm việc nào.
Ví dụ
Gọi Admin API Shopify GraphQL
Trong ví dụ này, bạn sẽ sử dụng Flow để chỉnh sửa tiêu đề sản phẩm bằng cách gọi API productUpdate.
Trước khi bắt đầu, thực hiện việc sau:
-
Thiết lập và cài đặt Ứng dụng tùy chỉnh có phạm vi
write_products
. Bạn sẽ sử dụng API Khóa bí mật để gọi API trong ví dụ này.
Sau đó, làm theo các bước sau trong Flow:
- Chọn yếu tố kích hoạt Đã cập nhật trạng thái sản phẩm cho phép bạn kiểm tra quy trình làm việc này bằng cách thay đổi trạng thái của sản phẩm.
- Thêm Gửi Yêu cầu HTTP vào quy trình làm việc và kết nối với yếu tố kích hoạt.
- Mở bảng cấu hình bằng cách nhấp vào bước Gửi Yêu cầu HTTP.
- Trong trường Phương thức HTTP, nhập
POST
. - Trong trường URL, nhập
https://YOUR-SHOP-DOMAIN.myshopify.com/admin/api/2023-01/graphql.json
thay thế miền cửa hàng và Phiên bản API mong muốn. - Trong mục Tiêu đề, nhập Khóa của
X-Shopify-Access-Token
và Giá trị củaYOUR_API_SECRET_KEY
bạn thu được ở bước đầu tiên. - Trong mục Tiêu đề, nhập tiêu đề thứ hai có Khóa của
Content-Type
và Giá trị củaapplication/json
. - Trong mục Nội dung, nhập vào như sau:
json
{"query": "mutation { productUpdate(input: {id: \"{{ product.id }}\", title: \"{{product.title}}-edited\"}) { product { id } } }"}
- Mã này thêm
-edited
vào cuối tiêu đề - Khoảng cách và dòng mới có ý nghĩa cụ thể trong trình biên tập Liquid, nên hãy tránh thêm hoặc xóa khoảng cách. Ngoài ra, ngoại trừ việc xuất Liquid, tránh sử dụng dấu ngoặc chồng chéo như
{{
và}}
vì dấu ngoặc được giữ lại cho biến Liquid.
- Định cấu hình phần còn lại của quy trình làm việc rồi kích hoạt.
- Kiểm tra bằng cách thay đổi trạng thái của Sản phẩm từ Bản nháp thành Đang hoạt động hoặc ngược lại.
Gọi API bên ngoài
Trong ví dụ về quy trình làm việc này, yêu cầu HTTP POST được gửi đến máy chủ khi đơn hàng được thanh toán.
Mã phản hồi
Bảng sau mô tả cách Flow xử lý mã phản hồi HTTP sau khi nhận được phản hồi.
Mã phản hồi HTTP | Cách Flow xử lý mã phản hồi |
---|---|
Thành công 2XX hoặc 3XX | Flow đánh dấu yêu cầu HTTP là thành công và thực hiện các thao tác tiếp theo trong quy trình làm việc. |
Lỗi 429 hoặc 5XX | Flow tự động thử lại thao tác trong tối đa 24 giờ cho đến khi nhận được mã phản hồi khác hoặc hết thời gian chờ. | Mã phản hồi khác | Nếu ứng dụng trả về mã không có mô tả trong bảng này hoặc hết thời gian chờ khi thử lại thao tác, Flow sẽ đánh dấu yêu cầu HTTP là không thành công. Các thao tác tiếp theo trong quy trình làm việc sẽ không được thực hiện. |