直达内容

分享机器人

用户和机器人都可以在个人页面配置最多 3 个分享的机器人,同时会展示在聊天界面左下角的 + 菜单中。借助该功能可以通过口口相传提升机器人传播效率。

获取分享列表

GET /users/:user_id/apps/favorite

查询用户分享的机器人列表。

API 端点 URL

 https://api.mixin.one/users/:user_id/apps/favorite

授权和其他选项

授权
Authorized
限制No limitation

参数

user_id
*必须
用户 ID

请求示例

curl -i -X GET -H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" https://api.mixin.one/users/06aed1e3-bd77-4a59-991a-5bb5ae6fbb09/apps/favorite
Response
{
"data": [
{
"type": "favorite_app",
"user_id": "06aed1e3-bd77-4a59-991a-5bb5ae6fbb09",
"app_id": "c94ac88f-4671-3976-b60a-09064f1811e8",
"created_at": "2017-12-23T18:23:26.996149Z"
}
...
]
}

添加分享

POST /apps/:client_id/favorite

API 端点 URL

 https://api.mixin.one/apps/:client_id/favorite

授权和其他选项

授权
Authorized
限制No limitation

参数

client_id
*必须
要添加到分享列表的应用 client_id

请求示例

curl -i -X POST -H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" https://api.mixin.one/apps/06aed1e3-bd77-4a59-991a-5bb5ae6fbb09/favorite
Response
{
"data": [
{
"type": "favorite_app",
"user_id": "06aed1e3-bd77-4a59-991a-5bb5ae6fbb09",
"app_id": "c94ac88f-4671-3976-b60a-09064f1811e8",
"created_at": "2017-12-23T18:23:26.996149Z"
}
...
]
}

移除分享

POST /apps/:client_id/unfavorite

API 端点 URL

 https://api.mixin.one/apps/:client_id/unfavorite

授权和其他选项

授权
Authorized
限制No limitation

参数

client_id
*必须
要从分享列表移除的应用 client_id

请求示例

curl -i -X POST -H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" https://api.mixin.one/apps/06aed1e3-bd77-4a59-991a-5bb5ae6fbb09/unfavorite

成功返回空 JSON。