Hệ thống Hogotopod Partner API sử dụng cơ chế xác thực thông qua API Key kết hợp với Tenant Identifier gửi trong HTTP Headers.

Headers bắt buộc

Mọi yêu cầu gửi tới các endpoint đối tác (/v1/partner/*) đều bắt buộc phải đính kèm các trường Header sau:
Bảo mật API Key: Tuyệt đối không nhúng API Key vào mã nguồn phía client (trình duyệt, ứng dụng di động công khai) hoặc đẩy lên kho lưu trữ mã nguồn mở (GitHub, GitLab công khai). Mọi yêu cầu gọi API phải được thực hiện từ máy chủ backend của bạn.

Cách lấy API Key

Để tạo mới API Key cho hệ thống của bạn, thực hiện theo các bước sau:
1

Đăng nhập Seller Portal

Truy cập vào seller.hogotopod.com và đăng nhập bằng tài khoản Seller của bạn.
2

Truy cập Trang cá nhân → API Key

Nhấn vào biểu tượng tài khoản ở góc trên bên phải màn hình, chọn Trang cá nhân, sau đó chuyển sang tab API Key.
3

Tạo mới API Key

Nhấn nút Tạo API Key, nhập tên gợi nhớ (ví dụ: Production Backend, Shopify Webhook, ERP App) và xác nhận tạo.
4

Lưu trữ mã bí mật

Hệ thống sẽ hiển thị API Key đầy đủ.
Mã API Key chỉ hiển thị duy nhất một lần sau khi tạo. Hãy sao chép và lưu vào tệp cấu hình bí mật (.env hoặc Secrets Manager) của bạn ngay lập tức.

Ví dụ cấu hình Headers theo ngôn ngữ


Thu hồi và đổi khóa (Key Rotation)

Nếu bạn nghi ngờ API Key bị lộ hoặc cần nâng cấp hệ thống:
  1. Vào Trang cá nhân → API Key trên Seller Portal.
  2. Nhấn nút Thu hồi (Revoke) tương ứng với API Key cũ.
  3. Tạo mới một API Key khác và cập nhật lại vào cấu hình hệ thống của bạn.