GET Lấy Danh Sách Cuộc Trò Chuyện
Lấy Danh Sách Cuộc Trò Chuyện Shop Scope bắt buộc: seller.affiliate_messages.write Lấy danh sách cuộc trò chuyện của người dùng. Version 202412
GET/affiliate_seller/202412/conversations
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Kiểu được phép: application/json |
| x-tts-access-token Required | string | Giá trị seller access_token từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy seller access_token. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Mỗi app sẽ có một key duy nhất. Vui lòng sử dụng key cụ thể được gán cho app của bạn. |
| sign Required | string | Chữ 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 diện người gửi. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). Timestamp này được sử dụng trên 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 Required | int | Số lượng truy vấn tối đa. Số tối đa là 50. |
| page_token | string | Độ lệch phân trang xác định nơi bạn bắt đầu truy vấn. Nó để trống khi bạn gửi yêu cầu đầu tiên. |
| only_need_conversation_id | bool | - Nếu true, chỉ conversation_id trong conversation được trả về. - Nếu false, tất cả các trường trong conversation` được trả về.true theo mặc định. |
| conversation_status | string | Lọc danh sách cuộc trò chuyện IM được trả về dựa trên trạng thái. Các giá trị có thể: - ALL: Lấy tất cả cuộc trò chuyện bất kể trạng thái.- UNREAD: Lấy tất cả cuộc trò chuyện có tin nhắn mà seller chưa đọc. Các tin nhắn vẫn ở trạng thái chưa đọc cho đến khi được đánh dấu là đã đọc một cách rõ ràng bằng cách gọi Mark Conversation Read. Việc trả lời một tin nhắn không làm thay đổi trạng thái đã đọc / chưa đọc.- UNREPLIED: Lấy tất cả cuộc trò chuyện trong đó seller không phải là người gửi tin nhắn cuối cùng.Bộ lọc này giúp bạn quản lý và ưu tiên các cuộc trò chuyện một cách hiệu quả. |
| shop_cipher | string | Sử dụng thuộc tính này để truyền thông tin shop khi gọi API. Việc 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
| Properties | Type | Description |
|---|---|---|
| only_need_conversation_id | bool | - Nếu true, chỉ conversation_id trong data.conversation được trả về. - Nếu false, tất cả các trường trong data.conversation được trả về.true theo mặc định. |
Example
CurlGoNode.jsJavaEnable word wrap
Response Parameters
| Properties | Type | Description |
|---|---|---|
| code | int | Mã trạng thái thành công hoặc thất bại được trả về trong phản hồi API. |
| message | string | Thông báo thành công hoặc thất bại được trả về trong phản hồi API. Lý do thất bại sẽ được mô tả trong message. |
| request_id | string | Nhật ký yêu cầu |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
Error Code
Xem các mã lỗi thường gặp
| Code | Message | | --- | --- | | 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