Kết nối sàn TMĐT
Ngắt kết nối kênh sàn
Xoá kênh sàn khỏi Hubport hoặc ngắt kết nối TikTok Shop
Có ba cách dừng một gian hàng sàn trên Hubport:
| Cách | Endpoint | Kết quả |
|---|---|---|
| Tạm dừng | PUT /v1/ecomplatforms/:id với status = 3 | Giữ kênh và liên kết, ngừng đồng bộ. Bật lại bằng status = 1 |
| Ngắt kết nối (TikTok Shop) | POST /v1/ecomtiktokshop/disconnect/:channelid | Xoá token, tắt kênh; giữ lịch sử |
| Xoá kênh | DELETE /v1/ecomplatforms/:id | Xoá kênh khỏi Hubport |
Thu hồi uỷ quyền trên sàn
Các thao tác trên chỉ ngắt phía Hubport. Muốn thu hồi hẳn quyền của ứng dụng Hubport trên gian hàng, chủ shop vào trang quản trị người bán của sàn (Shopee Seller Centre / Lazada Seller Center / TikTok Shop Seller Center) để huỷ uỷ quyền. Khi Shopee hoặc TikTok Shop báo uỷ quyền bị huỷ, Hubport tự xoá token, tắt kênh và đánh dấu mất kết nối (connected = 0).
Xoá kênh
DELETE /v1/ecomplatforms/:id
Quyền:
setting.sale
Path Parameters
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
id | int | Có | ID kênh |
Response
HTTP 204 - No Content: xoá thành công.
Ngắt kết nối TikTok Shop
POST /v1/ecomtiktokshop/disconnect/:channelid
Quyền:
setting.sale
Xoá token TikTok Shop của kênh và tắt kênh (gọi được cả khi kênh đã tắt). Kết nối lại bằng luồng OAuth.
Response (HTTP 200)
{ "id": 45, "status": 3 }Error Codes
| 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_role_not_available | Không có quyền setting.sale (HTTP 403) |
error_delete | Lỗi hệ thống khi xoá (HTTP 500) |
error_tiktokshop_not_configured | Kết nối TikTok Shop chưa khả dụng trên máy chủ này (HTTP 503) |