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.

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.

goship register

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:

Tài khoản developer Goship API

1. Lấy Access Token trực tiếp:

Tài khoản developer Goship API

Đâ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 IDClient 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ườngQuản lý vận đơnAPI endpoint
Sandboxhttps://dev-shop.goship.iohttps://sandbox.goship.io/api/v2
Productionhttps://shop.goship.iohttps://api.goship.io/api/v2