Giới thiệu
Chào mừng bạn đến với Hubport API. Với sự mở rộng tính năng cũng như tập khách hàng của mình, Hubport không ngừng cải tiến dịch vụ và việc cung cấp các Web Service cho đối tác tích hợp là một trong những tiện ích mà đội ngũ kỹ sư Hubport mang đến.
Hầu hết (trên 95%) tính năng mà bạn đang sử dụng trên Hubport đều có web service để kết nối, có nghĩa là bạn hoàn toàn có thể chủ động tích hợp với dữ liệu trên Hubport và hệ thống đang vận hành của mình. Sử dụng mô hình Restful API, việc kết nối đến web service của Hubport rất dễ dàng và nhanh chóng.
Đường dẫn API
Các API đều kết nối tới 1 url gọi là BASE_URL:
- Hubport SaaS (cửa hàng dùng chung hạ tầng Hubport):
BASE_URLlàhttps://api.hubport.vn. - Bản cài đặt riêng (cửa hàng chạy trên máy chủ riêng): mỗi khách hàng có một tên miền API riêng (thường có dạng
https://api.mydomain.com). Liên hệ bộ phận hỗ trợ của Hubport để lấyBASE_URLcủa công ty bạn.
Ví dụ: GET https://api.hubport.vn/v1/products.
Cách xác thực khi kết nối
Hệ thống "Admin API" sử dụng 2 cách để xác thực (Authorization) khi kết nối:
- User Login Token (JWT Token khi nhân viên đăng nhập vào hệ thống)
- API Key (Cặp API Key và API Secret)
Cả hai cách đều gửi thông tin xác thực qua header Authorization.
Chỉ gọi Admin API từ server
API Key và User Login Token cho phép quản lý dữ liệu của công ty, không được đưa vào mã chạy trên trình duyệt. Admin API chỉ phản hồi CORS cho ứng dụng của Hubport, request từ trang web trên tên miền khác sẽ bị trình duyệt chặn. Hãy gọi Admin API từ backend của bạn.
Chỉ các API ở mục "Admin API" mới cần API Key / User Login Token để phục vụ mục đích quản lý dữ liệu. Các API ở mục "Store-front API" không cần API Key.
Một tài khoản nhiều công ty
Trên Hubport, một tài khoản (email) có thể là nhân viên của nhiều công ty (cửa hàng). Mỗi User Login Token chỉ gắn với một công ty đang làm việc. Xem Đăng nhập và Đổi công ty đang làm việc.