获取指定联系人的信息。指定的参数是group就表示查看群组实例联系人,参数是user就表示查看用户实例联系人。
Request
HTTP request
GET https://www.featapi.com/api/party/contact-list/get_contact/
Parameters
Query parameters
参数必须要有group或user,但不能同时提交。
Parameter name | Value | Description |
---|---|---|
group | integer | 群组 ID |
user | integer | 用户 ID |
Authorization
该请求需要授权以下scopes访问权限:
Scopes |
---|
party_contact |
For more information, see the authentication and authorization page.
Request body
无需提交请求体信息。
Response
如果请求成功,该API返回指定联系人的信息在响应体信息中。
200 Returns a user or group contact data successfully
用户实例联系人数据
{
"data": {
"id": 274,
"group": null,
"friend": 7815803339127,
"friend_fullname": "黎 明",
"friend_first_name": "明",
"friend_last_name": "黎",
"unread_count": 0,
"status": 300,
"contact_time": "2020-04-03T01:25:00.856867Z",
"expertise": "中式英语",
"timezone": "Asia/Shanghai",
"timezone_utc_offset": null,
"location": "CHN",
"avatar": "/media/7815803339127/avatar/blob_5BrnPkO"
}
}
群组实例联系人数据
{
"data": {
"id": 7730,
"group": {
"id": 6997,
"name": "老友记",
"creator": 7815769374283,
"creator_fullname": "WenWei Yang",
"create_time": "2020-04-03T01:18:44.850013Z",
"status": 0,
"is_valid": true,
"bundle_id": null
},
"friend": null,
"friend_fullname": null,
"friend_first_name": null,
"friend_last_name": null,
"unread_count": 0,
"status": 300,
"contact_time": "2020-06-22T12:02:37.692466Z",
"expertise": null,
"timezone": null,
"timezone_utc_offset": null,
"location": null,
"avatar": null
}
}
404 Not found
示例返回数据可参考 API Common – Resource Not Found