获取联系人列表

测试环境

GET

/hmd-wx/api/v2/userctx/user/app/contacts/get

获取联系人列表

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Query 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET '/hmd-wx/api/v2/userctx/user/app/contacts/get?deviceId=283b1f62-a876-42c6-a560-268efc07439c' \
--header 'Authorization: Bearer <token>'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 0,
    "message": "成功",
    "data": {
        "persons": [
            {
                "deviceId": "01926a2d-875a-711e-9566-5f4d9444a850",
                "refId": "01926a2d-875a-711e-9566-5f4d9444a850",
                "avatar": "http://dummyimage.com/100x100",
                "appellation": "爸爸",
                "role": 1,
                "identityType": 1
            },
            {
                "deviceId": "01926a2d-875a-711e-9566-5f4d9444a850",
                "refId": "a74d3887-1c6e-480f-a60c-f28d63c3d060",
                "avatar": "http://dummyimage.com/100x100",
                "appellation": "妈妈",
                "role": 3,
                "identityType": 2
            }
        ],
        "applyBinds": [
            {
                "inviterUserId": "61926a2d-875a-711e-9566-5f4d9444a852",
                "applyUserId": "61926a2d-875a-711e-9566-5f4d9444a851",
                "applyName": "dd",
                "applyAvatar": "http://dummyimage.com/100x100",
                "applyIdentityType": 1
            }
        ]
    }
}

修改于 2025-09-23 06:55:39

申请绑定设备

更新联系人成员