Get specified group member information

This API retrieves information for specified members in a group.

Enabling the Service

Before using this feature, you must enable the profile hosting service by submitting a ticket.

Request method

POST: https://data center domain/entrust/group/member/specific/query.json

Rate limit: 100 requests per second

Signature rules: All server API requests require signature verification. See API request signature.

Request parameters

The HTTP request body uses application/x-www-form-urlencoded format and supports these parameters:

Parameter	Type	Required	Description
groupId	String	Yes	Group ID
userIds	Array	Yes	User ID array (supports querying multiple user IDs, maximum 100)

Request example

POST /entrust/group/member/specific/query.json HTTP/1.1
Host: api.rong-api.com
App-Key: uwd1c0sxdlx2
Nonce: 14314
Timestamp: 1408710653491
Signature: 45beb7cc7307889a8e711219a47b7cf6a5b000e8
Content-Type: application/x-www-form-urlencoded

groupId=groupId1&userIds=u01&userIds=u02

Response

The HTTP response body contains a JSON object with this structure:

Field	Type	Description
code	Number	Status code (200 indicates success)
members	JSONArray	Member information list
members structure
members[i].userId	String	Member user ID
members[i].nickname	String	Member group nickname
members[i].role	String	Member role (1: regular member, 2: administrator, 3: group owner)
members[i].time	String	Join timestamp
members[i].extra	String	Additional member information

Response example

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    "code": 200,
    "members": [
        {
            "userId": "u01",
            "role":1,
            "nickname": "nickname1",
            "time":12343433499942
        },
        {
            "userId": "u02",
            "nickname": "nickname2",
            "time":12343433499943,
            "role":3,
            "extra": "xxxx"
        }
    ]
}