Chuyển tới nội dung chính

POST Search Sessions

Tìm kiếm phiên Shop Scope yêu cầu: seller.customer_service Mô tả của [POST]/customer_service/:version/sessions Phiên bản 202602

POST/customer_service/202602/sessions/search

Request

Header

PropertiesTypeDescription
content-type RequiredstringKiểu được phép: application/json
x-tts-access-token RequiredstringGiá trị access_token của seller lấy từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy seller access_token.

Query

PropertiesTypeDescription
app_key RequiredstringMỗi app sẽ có một key duy nhất. Vui lòng dùng key cụ thể được gán cho app của bạn.
sign RequiredstringChữ ký được tạo bởi thuật toán gen. Khi bạn gửi các yêu cầu API tới TTS, bạn phải ký chúng để TTS có thể nhận dạng người gửi.
timestamp RequiredintUnix timestamp GMT (UTC+00:00). Timestamp này được dùng trong tất cả các yêu cầu API. Lập trình viên có thể dùng để chuyển đổi sang giờ địa phương.
page_size RequiredintSố kết quả trả về trên mỗi trang. Phạm vi hợp lệ: [1-100]
page_tokenstringMột token mờ (opaque) được dùng để truy xuất trang tiếp theo của tập kết quả phân trang. Lấy giá trị này từ next_page_token trong kết quả của phản hồi trước đó. Không cần thiết cho trang đầu tiên.
localestringMã locale BCP-47 dùng để hiển thị lý do từ chối, phân cách bằng dấu phẩy. Mặc định: en-USTham khảo https://partner.tiktokshop.com/docv2/page/678e3a47bae28f030a8c7523 để xem danh sách các mã locale được hỗ trợ.
shop_cipher RequiredstringDùng thuộc tính này để truyền thông tin shop khi gọi API. Nếu không truyền đúng giá trị khi gọi API cho các shop xuyên biên giới sẽ trả về phản hồi không chính xác. Lấy bằng API Get Authorization Shop

Body

PropertiesTypeDescription
begin_time_ge RequiredintTrả về các phiên có begin_time lớn hơn hoặc bằng thời gian được chỉ định. Chỉ hỗ trợ dữ liệu trong 90 ngày gần nhất.
begin_time_lt RequiredintTrả về các phiên có begin_time nhỏ hơn timestamp được chỉ định.
buyer_nicknamestringBiệt danh của người mua.

Example

CurlGoNode.jsJavaEnable word wrap

Response Parameters

PropertiesTypeDescription
codeintMã trạng thái thành công hoặc thất bại trả về trong phản hồi API.
messagestringThông báo thành công hoặc thất bại trả về trong phản hồi API. Lý do thất bại sẽ được mô tả trong message.
request_idstringNhật ký request
dataobjectThông tin trả về cụ thể

Example

JSONEnable word wrap

Error Code

Xem các mã lỗi phổ biến

| Code | Message | | --- | --- | | 45101001 | Lỗi nội bộ. Vui lòng thử lại sau hoặc liên hệ đội ngũ hỗ trợ kỹ thuật để được giúp đỡ. | | 36009003 | Lỗi nội bộ. Vui lòng thử lại. Nếu sự cố vẫn tiếp diễn sau nhiều lần thử, vui lòng liên hệ bộ phận hỗ trợ nền tảng. |

Nội dung này có hữu ích không?Hữu ích

Không hữu ích

PreviousNext