查询好友信息 - 即时通信

请求参数

Path 参数

account_id

string

必需

示例值:

{% mock 'string' %}

Query 参数

friend_account_id

string

可选

需要查询的好友账号 ID。

Header 参数

AppKey

string

必需

默认值:

X-custom-traceid

string

可选

默认值:

{% mock 'uuid' %}

Nonce

string

必需

默认值:

CurTime

string

必需

默认值:

CheckSum

string

必需

默认值:

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location -g --request GET 'https://open.yunxinapi.com/im/v2/friends/{% mock '\''string'\'' %}?friend_account_id' \
--header 'AppKey;' \
--header 'X-custom-traceid: {% mock '\''uuid'\'' %}' \
--header 'Nonce;' \
--header 'CurTime;' \
--header 'CheckSum;'

返回响应

🟢200成功

application/json

Body

code

integer

状态码

必需

200 表示请求成功。

msg

string

提示信息

必需

请求失败时返回错误信息，请求成功时返回 "success"。

data

object

返回数据

必需

返回的 JSON 数据对象，请求失败则返回空对象。

friend_account_id

string

好友的云信账号。

可选

alias

string

好友的备注名。

可选

extension

string

扩展字段

可选

客户端和服务端均可读写。

server_extension

string

服务端扩展字段

可选

客户端只读，仅服务器可修改预留给开发者的扩展字段，建议封装成 JSON 格式。

示例

{
    "code": 200,
    "msg": "success",
    "data": {
        "friend_account_id": "accid1",
        "alias": "name",
        "extension": "string",
        "server_extension": "string"
    }
}

🟢200成功

🟢200请求参数错误

🟢200服务器错误