用户同步接口
更新时间:2024-06-07
用户同步接口
接口说明
百度提供的用户信息同步接口,可以实现用户库、正排库批量导入。
请求示例
HTTP方法:POST
请求URL:https://airec.baidu.com/airec/api/omni/ums/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"] |
请求示例
[{
"uid": "uid_1001",
"uid_type": "1",
"register_time": 1648561924764,
"tags": ["标签1", "标签2"]
}]
返回格式
JSON格式
返回参数
参数名 | 类型 | 是否必填 | 说明 |
---|---|---|---|
success | boolean | 是 | 成功标识 |
code | string | 是 | 响应码:0正常,其他异常 |
message | string | 是 | 响应描述 |
result | dict | 是 | 响应数据 |
返回示例
{
"success": true,
"code": "0",
"message": null,
"result": null
}