Lấy khóa API của bạn
Lấy tài khoản Zonos: Để sử dụng API Zonos, bạn sẽ cần một khóa API. Để lấy khóa của bạn, bạn sẽ cần hoàn thành biểu mẫu đăng ký của chúng tôi. Onboarding sẽ bắt đầu sau khi bạn có thỏa thuận tài khoản. Trong quá trình onboarding, một đại diện sẽ giúp bạn thiết lập tài khoản một cách chính xác để bạn nhận được những phản hồi API chính xác nhất.
Truy cập khóa API của bạn tại đây nếu bạn có tài khoản Zonos. Điều này sẽ cho phép bạn xác thực với API Zonos. Nếu bạn không có tài khoản, hãy xem ghi chú ở trên.
Quyết định những chi tiết nào để truy xuất
Bạn có thể truy vấn danh sách đơn hàng dựa trên các accountOrderId tương tự hoặc bằng cách cung cấp một phạm vi ngày giữa các đơn hàng đã xuất bản. Để xem danh sách đầy đủ các trường có sẵn, hãy tham khảo tài liệu tham khảo API GraphQL.
Trên mỗi đơn hàng riêng lẻ bạn truy vấn, tất cả các trường Order bình thường đều có sẵn, ví dụ, quốc gia, thông tin vận chuyển, tổng landed cost, v.v.. Tất cả các trường có thể được liệt kê trong tài liệu tham khảo API GraphQL.
query orders($ordersFilter: OrdersFilter, $first: Int) { orders(filter: $ordersFilter, first: $first) { edges { node { id # ... field names here } } }}Gửi các trang để lấy
Tất cả các truy vấn truy xuất danh sách đều hỗ trợ phân trang theo kiểu Relay. Biến first cho phép bạn chỉ định có bao nhiêu đối tượng được trả về.
query orders($ordersFilter: OrdersFilter, $first: Int) { orders(filter: $ordersFilter, first: $first) { edges { node { id } } pageInfo { hasNextPage endCursor } }}Gửi yêu cầu của bạn
Bây giờ bạn đã xây dựng yêu cầu của mình và định cấu hình nó, bạn có thể gửi yêu cầu POST đến API Zonos. Hãy chắc chắn xác thực bằng khóa API của bạn và cung cấp tiêu đề phiên bản chính xác trong yêu cầu của bạn.
POST https://api.zonos.com/graphql
query orders($ordersFilter: OrdersFilter, $first: Int) { orders(filter: $ordersFilter, first: $first) { edges { node { id items { description hsCode quantity } } } }}
Tìm kiếm và lọc đơn hàng
Truy xuất danh sách đơn hàng bằng GraphQL.Sử dụng truy vấn
orderstrong GraphQL, bạn có thể truy xuất danh sách đơn hàng được phân trang với các tiêu chí khác nhau. Điều này hữu ích khi bạn cần danh sách đơn hàng theo quốc gia, trong một khoảng thời gian cụ thể, để tạo tìm kiếm, v.v.