Lấy khóa API của bạn
Trước tiên, đăng ký tài khoản Zonos và định cấu hình tài khoản của bạn trong Zonos Dashboard. Sau đó, bạn sẽ có thể lấy khóa API, cho phép bạn xác thực bằng Zonos API.
Quyết định chi tiết bạn muốn truy xuất
Do cách GraphQL hoạt động, bạn có thể yêu cầu chỉ những trường bạn quan tâm từ API, hoặc bạn có thể chọn yêu cầu tất cả thông tin mà hệ thống có liên quan đến một đơn hàng—lựa chọn là của bạn. Tham khảo tài liệu tham khảo GraphQL API để xem các trường có sẵn.
Thông tin liên quan đến đơn hàng như chi tiết báo giá chi phí hạ cánh, chi tiết đánh giá lô hàng, chi tiết giỏ hàng, v.v. có thể được truy vấn thông qua đồ thị bằng cách thêm các trường từ các đối tượng đó vào truy vấn order của bạn.
Tối thiểu, bạn cần một số đơn hàng để có thể truy vấn API. Điều này được truyền trong trường orderId với các biến trong yêu cầu GraphQL của bạn.
query order($orderId: String!) { order(orderId: $orderId) { # ... other field names here }}Gửi yêu cầu của bạn
Bây giờ bạn đã xây dựng yêu cầu và định cấu hình nó, bạn có thể gửi một yêu cầu POST đến Zonos API. 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 order($orderId: String!) { order(orderId: $orderId) { accountOrderNumber amountSubtotals { duties taxes fees shipping items } landedCosts { id rootId tariffRate duties { amount currency formula item { id description } exchangeRate { rate sourceCurrencyCode targetCurrencyCode } } fees { amount currency description note formula type item { id description } exchangeRate { rate } } taxes { amount currency formula item { id description } exchangeRate { rate } } deMinimis { formula method note threshold type } shipmentRating { id amount currencyCode displayName minTransitAt maxTransitAt details amount carrierCode amountSubtotals shipping fuelSurcharge insuranceCost otherSurcharge shipmentRatingCartons chargeableWeight carton length width height weight shippingProfile id customServiceLevelCode landedCostMethod serviceLevel code
Truy xuất chi tiết đơn hàng
Truy xuất chi tiết đơn hàng của bạn bằng GraphQL.Để truy xuất chi tiết cho các đơn hàng quốc tế của bạn trong hệ thống Zonos, bạn có thể truy vấn GraphQL API. Điều này cho phép bạn truy xuất chi tiết đơn hàng và bất kỳ thông tin liên quan nào được liên kết với một đơn hàng, chẳng hạn như đánh giá lô hàng, báo giá chi phí hạ cánh, v.v.