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:
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:- Vào Trang cá nhân → API Key trên Seller Portal.
- Nhấn nút Thu hồi (Revoke) tương ứng với API Key cũ.
- 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.