Kết nối sàn TMĐT
Nhật ký đồng bộ sàn
Xem các thông báo sàn gửi về và kết quả Hubport xử lý
Endpoint
GET /v1/ecomplatformlogs
Quyền:
setting.sale
Mỗi thông báo sàn gửi về (đơn mới / đổi trạng thái, uỷ quyền sắp hết hạn, huỷ uỷ quyền...) được ghi một bản nhật ký, kèm hành động Hubport đã thực hiện và kết quả.
Query Parameters
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
page | int | Không | Số trang (Mặc định: 1) |
limit | int | Không | Số bản ghi mỗi trang (Mặc định và tối đa: 50) |
id | int | Không | Lọc theo ID nhật ký |
ecom_platform_id | int | Không | Lọc theo kênh sàn |
topic | string | Không | Lọc đúng chủ đề, ví dụ shopee.3 |
keyword | string | Không | Tìm gần đúng theo chủ đề |
type | int | Không | Loại nhật ký (1 = thông báo từ sàn) |
status | int | Không | Trạng thái xử lý (xem bên dưới) |
sort_by | string | Không | Mặc định: id |
sort_type | string | Không | Mặc định: DESC |
Response Schema
HTTP 200 - JSON Object
{ total, currentpage, limit, items }, mỗi item:
| Trường | Kiểu | Mô tả |
|---|---|---|
id | int | ID nhật ký |
company_id | int | ID công ty |
creator_id | int | ID người tạo (0 với thông báo từ sàn) |
ecom_platform_id | int | ID kênh sàn |
type | int | 1 = thông báo từ sàn |
topic | string | Chủ đề: shopee.<mã loại>, lazada.<loại>, tiktokshop.<loại> theo mã loại thông báo của sàn |
identifier | string | Mã định danh thông báo |
data_content_type | string | Kiểu dữ liệu của data |
data | string | Nội dung thông báo sàn gửi |
trigger_action | string | Hành động Hubport thực hiện, ví dụ shopee_sync_order, queue_lazada_sync_order, tiktokshop_sync_order, shopee_revoke_channel, shopee_mark_auth_expire_soon |
trigger_action_output | object | Kết quả hành động (ví dụ kết quả đồng bộ đơn: action, order_id, error) |
trigger_retry_count | int | Số lần thử lại |
status | int | Trạng thái xử lý |
date_created | int | Thời điểm nhận (Unix timestamp) |
date_modified | int | Thời điểm cập nhật (Unix timestamp) |
date_triggered | int | Thời điểm bắt đầu xử lý (Unix timestamp) |
Trạng thái xử lý (status)
| Giá trị | Mô tả |
|---|---|
1 | Trùng (thông báo đã nhận trước đó) |
3 | Bỏ qua |
5 | Đang chờ xử lý |
7 | Đang xử lý |
9 | Thành công |
11 | Lỗi |
Ví dụ cURL
curl -X GET "https://api.hubport.vn/v1/ecomplatformlogs?ecom_platform_id=31&status=11" \
-H "Authorization: <JWT>"