Lấy danh sách thành viên nhóm

Lưu ý

Ứng dụng cần được cấp quyền quản lý thông tin nhóm.

HTTP request

• URL: https://openapi.zalo.me/v3.0/oa/group/listmember
• Method: GET
• Response Type: text/json

Example request

curl --request GET 'https://openapi.zalo.me/v3.0/oa/group/listmember?group_id=f414c8f76fa586fbdfb4&offset=0&count=5' \
--header 'access_token: <your_access_token>'

Tham số header

Tham số	Kiểu dữ liệu	Tính bắt buộc	Mô tả
access_token	string	yes	Token cho phép ứng dụng đại diện OA gọi API. Xem chi tiết cách lấy access token tại đây.

Tham số

Tham số	Kiểu dữ liệu	Tính bắt buộc	Mô tả
group_id	string	yes	ID của nhóm
offset	integer	optional	Offset muốn query. Mặc định: 0
count	integer	optional	Số lượng mong muốn query. Mặc định: 5

Example respond

{
    "data": {
        "offset": 0,
        "count": 5,
        "total": 2,
        "member_count": 2,
        "members": [
            {
                "oa_id": "607812198688816074",
                "name": "Chủ Trại Mèo",
                "avatar": "https://s120-ava-talk.zadn.vn/d/e/f/d/7/120/380ffb601008ba5c58852a80cb635b79.jpg"
            },
            {
                "user_id": "8756287263669629130",
                "name": "Hoàng Trường Phước",
                "avatar": "https://s120-ava-talk.zadn.vn/8/0/d/7/2/120/59fc092d056c759a71fd16d3bc508458.jpg"
            }
        ]
    },
    "error": 0,
    "message": "Success"
}

Cấu trúc thuộc tính data

Tham số	Kiểu dữ liệu	Mô tả
offset	integer	offset muốn query
count	integer	Số lượng muốn query
total	integer	Tổng số lượng các thành viên trong nhóm
members	array	Thông tin các thành viên trong nhóm
member_count	integer	Số lượng các thành viên được trả về

Cấu trúc thuộc tính members

Tham số	Kiểu dữ liệu	Mô tả
name	string	Tên thành viên trong nhóm
user_id	string	ID thành viên chờ trong nhóm
oa_id	string	ID của OA
avatar	string	Hình đại diện của thành viên trong nhóm