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 Goship API
Trước khi bắt đầu sử dụng Goship API, bạn sẽ cần phải có:
- Tài khoản goship.io: Dùng để quản lý thông tin vận chuyển trên phần mềm goship.io
- Access Token: Dùng để tương tác với hệ thống Goship API
Đăng ký tài khoản Goship
Tài khoản Goship cho phép bạn truy cập vào hệ thống quản lý đơn hàng của Goship. 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.goship.io/. Đ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 goship.io:

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 Goship 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 Goship 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 Goship API.
Bạn có thể xem cách lấy Access Token bằng tài khoản Developer tại mục Authentication.
Nên chọn cách nào? Lấy Access Token trực tiếp là đủ dùng cho hầu hết trường hợp tích hợp một chiều (server của bạn gọi thẳng Goship API). Chỉ cần tạo tài khoản developer (Client ID/Client Secret) khi hệ thống của bạn cần tự động hoá việc đăng nhập lấy token, ví dụ đăng nhập thay cho nhiều shop con hoặc cần tự làm mới token theo luồng riêng.
Môi trường phát triển tích hợp
| Môi trường | Quản lý vận đơn | API endpoint |
|---|---|---|
| Sandbox | https://dev-shop.goship.io | https://sandbox.goship.io/api/v2 |
| Production | https://shop.goship.io | https://api.goship.io/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.

