用户同步接口
更新时间:2025-01-10
用户同步接口
接口说明
百度提供的用户信息同步接口,可以实现用户库、正排库批量导入。
请求示例
HTTP方法:POST
请求URL:https://airec.baidu.com/airec/api/omni/ms/batch-sync
Header如下:
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| Content-Type | - | 是 | application/json;charset=UTF-8 |
| X-Gw-Ak | string | 是 | 数据表鉴权信息 |
| Alias-Name | string | 是 | 数据表名称 |
| code | string | 是 | 数据表类型 |
| id | string | 是 | 数据表id |
请求格式
POST 方式调用
注意:要求使用由 JSON 组成的数组格式的结构体来描述一个请求的具体内容,最大支持20条。
请求参数
图文用户:
| 参数名 | 中文名 | 类型 | 是否必填 | 备注 |
|---|---|---|---|---|
| uid | 用户UID | string | 是 | 用户唯一标志 |
| uid_type | 用户注册类型 | string | 否 | 用户注册类型:1 app注册类型; 2 手机号; 3 微信号; 4 其它 |
| register_time | 用户注册时间 | long | 否 | 用户注册时间, 格式: 13位时间戳 |
| tags | 兴趣标签 | strings | 否 | 兴趣标签 |
| subscribe_author_ids | 订阅作者 | strings | 否 | 用户订阅的作者id |
商品用户:
| 参数名 | 中文名 | 类型 | 是否必填 | 备注 |
|---|---|---|---|---|
| uid | 用户UID | string | 是 | 用户唯一标志 |
| uid_type | 用户注册类型 | string | 否 | 用户注册类型(根据实际注册场景传入即可,无特殊含义,仅作为用户注册标记): 1 app注册类型; 2 手机号; 3 微信号; 4 其它 |
| register_time | 用户注册时间 | long | 否 | 用户注册时间, 格式: 13位时间戳 |
| tags | 兴趣标签 | strings | 否 | 兴趣标签 |
| age | 用户年龄 | string | 否 | 用户年龄 |
| gender | 用户性别 | string | 否 | 用户性别:男性0、女性1、未知2转 |
| subscribe_shop_ids | 订阅店铺 | strings | 否 | 用户订阅的店铺id |
媒资用户
| 参数名 | 中文名 | 类型 | 是否必填 | 备注 |
|---|---|---|---|---|
| uid | 用户UID | string | 是 | 用户唯一标志 |
| area | 地区 | string | 否 | 用户所在地区 |
| uid_type | 用户注册类型 | string | 否 | 用户注册类型:1 app注册类型; 2 手机号; 3 微信号; 4 其它 |
| register_time | 用户注册时间 | long | 否 | 用户注册时间, 格式: 13位时间戳 |
| base_tags | 兴趣标签 | strings | 否 | 兴趣标签 |
| subscribe_director_ids | 订阅的创作者 | strings | 否 | 用户订阅的媒资创作者/导演/出品方id |
| collection_list | 收藏列表 | strings | 否 | 收藏列表,例如["NID_1001", "NID_1002"] |
| watch_list | 观看列表 | strings | 否 | 观看列表,例如["NID_1001", "NID_1002"] |
请求示例
Plain Text
1[{
2 "uid": "uid_1001",
3 "uid_type": "1",
4 "register_time": 1648561924764,
5 "tags": ["标签1", "标签2"]
6}]
返回格式
JSON格式
返回参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| success | boolean | 是 | 成功标识 |
| code | string | 是 | 响应码:0正常,其他异常 |
| message | string | 是 | 响应描述 |
| result | dict | 是 | 响应数据 |
返回示例
Plain Text
1{
2 "success": true,
3 "code": "0",
4 "message": null,
5 "result": null
6}
