Thông tin gian hàng và token
Xem thông tin gian hàng trên sàn, làm mới token, đăng ký lại webhook TikTok Shop
Các endpoint trong nhóm này dùng :channelid là id của kênh sàn và yêu cầu quyền setting.sale.
Thông tin gian hàng
| Sàn | Endpoint |
|---|---|
| Shopee | GET /v1/ecomshopee/shopinfo/:channelid |
| Lazada | GET /v1/ecomlazada/sellerinfo/:channelid |
| TikTok Shop | GET /v1/ecomtiktokshop/shopinfo/:channelid |
- Shopee / Lazada: trả thông tin shop / seller do sàn cung cấp (tên shop, khu vực, trạng thái...).
- TikTok Shop: đọc lại danh sách shop đã uỷ quyền, cập nhật tên / mã shop cho kênh và trả:
{ "id": "<TIKTOK_SHOP_ID>", "name": "Shop Demo", "code": "<SHOP_CODE>", "region": "VN", "seller_type": "LOCAL" }Lỗi riêng TikTok Shop: error_tiktokshop_shop_not_in_authorization (HTTP 422) — shop không còn trong danh sách uỷ quyền, cần kết nối lại.
Làm mới token
| Sàn | Endpoint |
|---|---|
| Shopee | POST /v1/ecomshopee/refreshtoken/:channelid |
| Lazada | POST /v1/ecomlazada/refreshtoken/:channelid |
| TikTok Shop | POST /v1/ecomtiktokshop/refreshtoken/:channelid |
Hubport tự làm mới token định kỳ; endpoint này để làm mới chủ động (ví dụ khi kiểm tra kết nối). Response không chứa token:
{ "id": 31, "access_expire_at": 1760014400, "refresh_expire_at": 1762592000 }Lazada trả thêm refreshed (1/0) và auth_mode. Thất bại: HTTP 422 với error_shopee_refresh_failed / error_lazada_refresh_failed / error_tiktokshop_refresh_failed kèm mã lỗi của sàn; khi đó cần kết nối lại.
Đăng ký lại webhook (TikTok Shop)
POST /v1/ecomtiktokshop/webhooks/:channelid
Hubport tự đăng ký webhook cho shop TikTok khi kết nối. Gọi endpoint này nếu trường settings.tiktok_webhook_error của kênh báo lỗi. HTTP 200 khi đăng ký đủ; HTTP 422 kèm error mô tả các loại thông báo chưa đăng ký được.
Error Codes chung
| Mã lỗi | Mô tả |
|---|---|
error_not_found | Kênh không tồn tại, sai loại sàn hoặc không thuộc công ty của bạn (HTTP 404) |
error_channel_disabled | Kênh đang tắt (HTTP 422) |
error_feature_requires_plan | Gói chưa có tính năng kết nối sàn (HTTP 402) |
error_shopee_not_configured, error_lazada_not_configured, error_tiktokshop_not_configured | Kết nối sàn này chưa khả dụng trên máy chủ (HTTP 503) |
error_role_not_available | Không có quyền setting.sale (HTTP 403) |
error_shopee_api / error_lazada_api / error_tiktokshop_api | Lỗi do sàn trả về; mảng error gồm mã này, mã lỗi của sàn và thông báo (HTTP 422) |