Lấy danh sách cuộc hội thoại

Lấy danh sách cuộc hội thoại

HTTP Request

GET https://{app_id}.api.piscale.com/open-api/v1.0/chat/threads

Request header

Bảng mô tả tham số của request header:

Tên	Kiểu dữ liệu	Mô tả	Bắt buộc
X-Api-Key	string	API Key của ứng dụng	✓
X-Tenant-Id	string	Chỉ định tenant	✗

Query

Tên	Kiểu dữ liệu	Mô tả	Bắt buộc	Mặc định
last_thread_id	string	Mã cuộc hội thoại	✓	0
limit	number	Giới hạn số lượng cuộc hội thoại mỗi lần. Tối đa 100 cuộc hội thoại	✗	30
only_public_thread	boolean	Chỉ lấy cuộc hội thoại công khai	✗	false

note

Dữ liệu trả về sẽ là những cuộc hội thoại có id > last_thread_id.
Để lấy dữ liệu của trang tiếp theo vui lòng truyền last_thread_id bằng id của phần tử cuối cùng trong mảng dữ liệu trả về.

Response

Nếu thành công, bạn sẽ nhận được phản hồi.

Ví dụ

{
    "message_code": "M200",
    "message": "Thành công",
    "data": [
        {
            "id": "10552119685046",
            "name": "Cộng đồng PC Việt Nam",
            "type" : "group",
            "description": "Trao đổi, tư vấn mua bán link kiện PC",
            "avatar_url": "https://avatar-api.communi.io/a05b8b2d-a657-4f1c-965b-8ba94b91c20b/1b00a38d-cf83-41d4-9d59-e651836d21ff.png",
            "link_count": 10,
            "image_count": 10,
            "file_count": 10,
            "video_count": 10,
            "member_count": 10,
            "message_count": 10,
            "pin_message_count": 10
        },
        {
            "id": "10552119685050",
            "name": "Cộng đồng Macbook Việt Nam",
            "type" : "group",
            "description": "Trao đổi, tư vấn mua bán Macbook",
            "avatar_url": "https://avatar-api.communi.io/a05b8b2d-a657-4f1c-965b-8ba94b91c20b/1b00a38d-cf83-41d4-9d59-e651836d21ff.png",
            "link_count": 10,
            "image_count": 10,
            "file_count": 10,
            "video_count": 10,
            "member_count": 10,
            "message_count": 10,
            "pin_message_count": 10
        }
    ],
}

Tên	Kiểu dữ liệu	Mô tả
message_code	string	Mã thông điệp. Xem chi tiết
message	string	Nội dung mã thông điệp
data[i].id	string	Mã cuộc hội thoại
data[i].name	string	Tên cuộc hội thoại
data[i].description	string	Mô tả cuộc hội thoại
data[i].type	string	Loại cuộc hội thoại direct hoặc group
data[i].link_count	number	Số lượng đường dẫn trong cuộc hội thoại
data[i].image_count	number	Số lượng hình ảnh trong cuộc hội thoại
data[i].file_count	number	Số lượng tệp đính kèm trong cuộc hội thoại
data[i].video_count	number	Số lượng video trong cuộc hội thoại
data[i].member_count	number	Số lượng thành viên trong cuộc hội thoại
data[i].message_count	number	Số lượng tin nhắn trong cuộc hội thoại
data[i].created_at	number	Thời gian cuộc hội thoại được tạo

note

Với cuộc hội thoại loại là direct thì name và description sẽ có giá trị là rỗng.