Thiết lập cơ bản
Hướng dẫn thiết lập cơ bản để bắt đầu tích hợp hệ thống API vận chuyển Zogo API
Trước khi bắt đầu sử dụng Zogo API, bạn sẽ cần phải có:
- Tài khoản zogo.vn: Dùng để quản lý thông tin vận chuyển trên phần mềm zogo.vn
- Access Token: Dùng để tương tác với hệ thống Zogo API
Đăng ký tài khoản Zogo
Tài khoản Zogo cho phép bạn truy cập vào hệ thống quản lý đơn hàng của Zogo. Chúng ta cũng sử dụng hệ thống này cho mục đích testing khi thực hiện kết nối đẩy đơn hàng.
Tất cả các thông tin được đề cập trong tài liệu này đều là môi trường Sandbox.
Link đăng ký tài khoản: https://dev-shop.zogo.vn/. Điền đẩy đủ các thông tin trên form đăng ký và submit.
Access Token
Có 2 cách để lấy được access token. Đầu tiên, hãy truy cập menu Cài đặt > Kết nối API trên phần mềm quản lý vận đơn zogo.vn:
1. Lấy Access Token trực tiếp:
Đây là cách nhanh nhất để lấy access token và sử dụng hệ thống Zogo API. Thời gian được cấp phép sử dụng token này là 10 năm.
2. Sử dụng tài khoản developer:
Để tạo tài khoản developer, tại mục Zogo API Account click nút Generate. Hệ thống sẽ tự động sinh thông tin Client ID và Client Secret. Đây là 2 trường thông tin mà bạn cần để login vào hệ thống Zogo API.
Bạn có thể xem cách lấy Access Token bằng tài khoản Developer tại mục Authentication.
Môi trường phát triển tích hợp
Sandbox:
- Quản lý vận đơn:
https://dev-shop.zogo.vn - API endpoint:
https://sandbox.zogo.vn/api/v2
Production:
- Quản lý vận đơn:
https://shop.zogo.vn - API endpoint:
https://api.zogo.vn/api/v2
- Tất cả API đều sử dụng giao thức
https. - Tài khoản developer trên môi trường production sẽ không được mặc định kích hoạt. Vui lòng liên hệ email [email protected] để được hỗ trợ thêm.