Bài viết này cung cấp hướng dẫn toàn diện để tích hợp cửa hàng tùy chỉnh của bạn với API của Gelato, giúp trải nghiệm liền mạch và hiệu quả.
Tài liệu kỹ thuật cho việc tích hợp API
Trước khi bắt đầu quy trình tích hợp, điều quan trọng là đội ngũ kỹ thuật của bạn cần nắm vững tài liệu kỹ thuật của chúng tôi. Bạn có thể truy cập tại đây.
Tài liệu này là nguồn tham khảo đầy đủ, trình bày mọi chi tiết và yêu cầu cần thiết. Hãy xem lại định kỳ vì có thể sẽ có cập nhật và tính năng mới được bổ sung.
Trang quản lý Gelato
Hãy xem Trang quản lý Gelato như trung tâm điều khiển cho mọi thứ liên quan đến tích hợp Gelato API của bạn. Trang này cung cấp:
Thông tin chi tiết về sản phẩm do mạng lưới toàn cầu của chúng tôi cung cấp, bao gồm cả giá.
Toàn quyền kiểm soát các đơn hàng được tạo qua Gelato API.
Yêu cầu thiết kế và ánh xạ sản phẩm cho tích hợp API
Để đảm bảo chất lượng in tối ưu, bạn nên làm quen với yêu cầu thiết kế của chúng tôi. Hãy đảm bảo tệp gửi lên tuân theo các hướng dẫn này.
Ngoài ra, việc hiểu rõ UID sản phẩm và cách ánh xạ sản phẩm của bạn theo tiêu chuẩn của Gelato là điều cần thiết để tích hợp trơn tru.
Sản phẩm, giá và vận chuyển cho tích hợp API
Để biết thông tin chi tiết về các sản phẩm chúng tôi cung cấp, thông số kỹ thuật, giới hạn theo khu vực, và giá theo quốc gia và số lượng, hãy xem Danh mục sản phẩm đầy đủ có sẵn trên Trang quản lý của chúng tôi. Bạn có thể tìm hiểu thêm về sản phẩm và thiết kế tại đây.
Vì giá vận chuyển luôn thay đổi theo tình trạng và phương thức thực tế ở từng quốc gia, nên chúng không được hiển thị trên Trang quản lý. Để hiểu rõ cách xác định giá vận chuyển, vui lòng xem thông tin được cung cấp tại đây.
Kiểm thử tích hợp API của bạn
Khi đã sẵn sàng kiểm thử việc tích hợp, bạn có thể tạo một khóa và thêm nó vào phần header X-API-KEY của các yêu cầu HTTP. Việc này cho phép bạn:
Tạo đơn hàng thử (những đơn hàng này sẽ tự động bị hủy và không được giao).
Lấy trạng thái đơn hàng (trong môi trường Sandbox, lệnh gọi này sẽ luôn trả về trạng thái "Đã hủy").
Các tính năng kiểm thử bổ sung có sẵn, cho phép bạn khám phá và hiểu sâu hơn về khả năng của API. Bạn cũng có thể sử dụng Cổng API để yêu cầu báo giá và tạo đơn hàng thử ngay cả trước khi quá trình tích hợp hoàn tất. Điều này giúp bạn có cơ hội nắm sơ bộ thông tin cần thiết, cách ghép tệp đúng với UID sản phẩm phù hợp, và các phản hồi bạn có thể nhận được.
Khi bạn dùng khóa trong môi trường Live, bạn có thể trải nghiệm đầy đủ quy trình Xử lý đơn hàng, bao gồm vận chuyển và giao đến địa chỉ đã cung cấp, giúp bạn kiểm thử toàn trình.
Thông tin bổ sung
Chúng tôi đã tổng hợp thêm vài tài nguyên có thể hữu ích cho bạn:
Vận chuyển: Thông tin quan trọng về quy trình vận chuyển của chúng tôi.
Dịch vụ khách hàng: Giải thích chi tiết về quy trình dịch vụ khách hàng của chúng tôi và thông tin chúng tôi cần từ bạn.
Điều khoản sử dụng: Điều khoản sử dụng chung của chúng tôi cho dịch vụ.