有关此资源的方法列表，请参阅本页结尾。
资源表现形式
ContactList是联系人列表。联系人列表包含两种实例数据，分别为用户和群组。如果是用户实例，返回数据字段”friend”表示对应用户的ID。如果是群组实例，返回数据字段”group”表示对应群组的数据 ，包含群组ID、群组名称、群主信息。
{
"id": integer,
"group": nested object,
"friend": string,
"friend_fullname": string,
"friend_first_name": string,
"friend_last_name": string,
"unread_count": integer,
"status": enum,
"contact_time": datetime,
"expertise": string,
"timezone": string,
"timezone_utc_offset": string,
"location": string,
"avatar": string
}| Property name | Value | Description | Notes |
|---|---|---|---|
| id | integer | 联系人 ID | |
| group | nested object | 群组数据。如果是用户实例，则为null | Party.Group |
| friend | string | Party用户 ID。如果是群组实例，则为null | |
| friend_fullname | string | Party用户全名 | |
| friend_first_name | string | Party用户名字 | |
| friend_last_name | string | Party用户姓氏 | |
| unread_count | integer | 联系人的未读消息数量 | |
| status | enum | 联系人的状态 | Contact List.Status |
| contact_time | string | 最近一次联系的时间 | 日期时间格式：YYYY-MM-DDThh:mm:ss |
| expertise | string | 联系人的主专长的名字 | |
| timezone | string | 联系人最近登录地点的时区名字 | |
| timezone_utc_offset | string | 最近登录地点的时区偏移量 | 比如，Asia/Shanghai 的时区偏移量为”+08:00″ |
| location | string | 最近登录地点 | |
| avatar | string | 联系人的头像 | 如果对象是好友实例，则是返回用户头像。如果对象是群组实例，则返回群组头像。 |
Methods
Archive
获取当前登录用户的归档区域的联系人列表。
Inbox
获取当前登录用户的会话区域的联系人列表。
Get Contact
获取指定联系人的信息。
Update Relation
更改用户联系人的关系。
Black List
返回当前登录用户的黑名单列表。