通过 POST http://127.0.0.1:3000/share_peer(请求体为 JSON 参数)或 WebSocket 调用。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
user_id |
uint | – | ||
group_id |
uint | – | ||
phone_number |
string | – | "" |
{ arkMsg }:服务端生成的推荐联系人 Ark 卡片 JSON 字符串。
所有响应都包裹在标准信封中:{ "status": "ok", "retcode": 0, "data": ... }。下表描述 data 字段。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
arkMsg |
string | ✓ | Ark 卡片 JSON 字符串 |
支持 MCP 的客户端可直接发现并调用本动作,无需手写 HTTP。见 MCP 接入。