账户模块
账户信息对象
账户信息对象定义了推广账户的属性,账户模块的多个接口均引用了其定义,请参考各个接口的使用说明。
字段名称 | 类型 | 描述 |
---|---|---|
userId | number | 账户ID |
balance | number | 账户余额。 此字段仅用于查询,updateAccountFeed接口传此字段无效。 |
budget | number | 账户预算。 默认为0,表示不限预算。 正常取值范围为[100-9999999.99] |
balancePackage | number | 资金包类型。 此字段仅用于查询,updateAccountFeed接口传此字段无效。 取值范围如下: 0:原生资金包 1:凤巢资金包 2:代理商原生资金包 |
userStat | number | 账户状态。 此字段仅用于查询,updateAccountFeed接口传此字段无效。 取值范围如下: 1:开户金未到 2:生效 3:账户余额为0零 4:被拒绝 6:审核中 7:被禁用 8:待激活 11:账户预算不足 |
uaStatus | number | 是否开通feed产品线权限。 此字段仅用于查询,updateAccountFeed接口传此字段无效。 取值范围如下: 1:已开通 2:待开通 3:不允许开通(KA客户) |
validFlows | array(number) | 可投放流量。 此字段仅用于查询,updateAccountFeed接口传此字段无效。 数组为空时表示无可投放流量。流量类型与推广单元对象的ftypes字段定义保持一致,取值范围如下: 1:手机百度 2:贴吧 4:百青藤 8:好看视频 |
RTA配置信息对象
字段名称 | 类型 | 描述 |
---|---|---|
userId | number | userid,新增无效 |
url | string | 接口地址,长度不超过1024个字符,http/https开头,不含空格,必填 |
qps | number | 请求qps,大于等于0,0表示不限制(默认),单位次/秒,选填,此字段暂不生效 |
cacheTime | number | 缓存时长,大于等于0,0表示不使用缓存(默认),单位秒,选填,此字段暂不生效 |
strategyIds | array(number) | 策略ids,大于0,上限100个,选填 |
customToken | string | 自定义token,最大256个字符,选填 |
token | string | 百度认证token,系统自动生成,新增无效 |
查询账户信息
接口描述
查询账户信息。
接口URL
http://sem.baidubce.com/v1/feed/cloud/AccountFeedService/getAccountFeed
请求参数说明
字段名称 | 类型 | 描述 |
---|---|---|
accountFeedFields | array(string) | 需要查询的账户属性。取值范围参考账户信息对象中的字段取值 |
响应参数说明
响应内容为账户信息对象,请参考其定义。
请求示例
POST /v1/feed/cloud/AccountFeedService/getAccountFeed HTTP/1.1
Accept-encoding: 'gzip, deflate'
Host: sem.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
Accept: '*/*'
// 普通权限
{
"body": {
"accountFeedFields": [
"userId",
"balance",
"budget",
"balancePackage",
"userStat"
]
},
"header": {
"opUsername":"operator_username", // 操作账户用户名(信息流账户用户名)
"opPassword":"*********" // 操作账户密码(信息流账户密码)
"tgUsername":"target_username", // 操作账户用户名(普通权限下tgUsername和opUsername传相同的用户名)
"tgPassword":"*********", // 操作账户密码(普通权限下opPassword和tgPassword传相同的密码)
"bceUser":"014df051fa131234a2a*****" // 普通权限的操作账户,对应的百度智能云ID
}
}
//账户管家权限
{
"body": {
"accountFeedFields": [
"userId",
"balance",
"budget",
"balancePackage",
"userStat"
]
},
"header": {
"opUsername":"operator_username", // 管家账户用户名
"opPassword":"*********", // 管家账户密码
"tgSubname":"target_username", // 被操作的子账户
"bceUser":"014df051fa131234a2a*****" // 账户管家权限的操作账户,对应的百度智能云ID
}
}
// 代理商权限&工具商权限
{
"body": {
"accountFeedFields": [
"userId",
"balance",
"budget",
"balancePackage",
"userStat"
]
},
"header": {
"opUsername":"operator_username", // 操作账户用户名(代理商账户用户名)
"opPassword":"*********" // 操作账户密码(代理商账户密码)
"tgUsername":"target_username", // 被操作账户名(客户信息流账户用户名)
"tgPassword":"*********", // 被操作账户密码(客户信息流账户密码)
"bceUser":"014df051fa131234a2a*****" // 代理商或工具商权限的操作账户,对应的百度智能云ID
}
}
响应示例
{
"body": {
"data": [
{
"userId": 123456,
"balance": 1234.56,
"budget": 333.44,
"balancePackage": 1,
"userStat": 2,
"uaStatus": 1,
"validFlows": [1,2,4,8]
}
]
},
"header": {
"oprs": 1,
"failures": [],
"succ": 1,
"oprtime": 0,
"desc": "success",
"status": 0
}
}
更新账户设置
接口描述
更新账户设置。
接口URL
http://sem.baidubce.com/v1/feed/cloud/AccountFeedService/updateAccountFeed
请求参数说明
字段名称 | 类型 | 描述 |
---|---|---|
budget | number | 账户预算。 默认为0,表示不限预算。 正常取值范围为[50-9999999.99] |
响应参数说明
响应内容为账户信息对象,请参考其定义。
请求示例
POST /v1/feed/cloud/AccountFeedService/updateAccountFeed HTTP/1.1
Accept-encoding: 'gzip, deflate'
Host: sem.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
Accept: '*/*'
{
"header": {
"opUsername": "example",
"tgUsername": "example",
"bceUser": "example",
"opPassword": "example",
"tgPassword": "example"
},
"body": {
"accountFeedType": {
"budget": 3333.33
}
}
}
响应示例
{
"body": {
"data": [
{
"userId": 630152,
"budget": 3333.33
}
]
},
"header": {
"oprs": 1,
"failures": [],
"succ": 1,
"oprtime": 0,
"desc": "success",
"status": 0
}
}
查询待加款项
接口描述
KA账户查询待加款项,此接口仅供KA账户使用
接口URL
http://sem.baidubce.com/v1/feed/cloud/PaymentFeedService/getPaymentRecord
请求参数说明
字段名称 | 类型 | 描述 |
---|---|---|
id | number | 记录id,第一页数据不填,第二页及往后的数据必须填,升序填当前页最大id值,降序填当前页最小id值 |
pageSize | number | 每页数量大小 |
status | number | 待查询付款记录支付状态,0:待支付,1:已付款,2:已取消 |
startTime | string | 支付时间-开始时间,选填,格式:yyyy-MM-dd HH:mm:ss |
endTime | string | 支付时间-结束时间,选填,格式:yyyy-MM-dd HH:mm:ss |
响应参数说明
字段名称 | 类型 | 描述 |
---|---|---|
id | number | 付款记录 id |
uid | number | 实际支付用户 id |
payTime | string | 付款时间 |
actTime | string | 资金到账时间 |
cash | number | 现金金额 |
bonus | number | 优惠金额 |
actflag | number | 支付状态,0:待支付,1:已付款,2:已取消 |
orderRow | number | 订单行号 |
productName | string | 资金池名称 |
accountName | string | 资金类型账号名 |
payMethodName | string | 支付方式名称 |
billStatus | string | 支付状态说明 |
cacheTypeName | string | 待加款类型 |
请求示例
POST /v1/feed/cloud/PaymentFeedService/getPaymentRecord HTTP/1.1
Accept-encoding: 'gzip, deflate'
Host: sem.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
Accept: '*/*'
{
"header": {
"opUsername": "example",
"tgUsername": "example",
"bceUser": "example",
"opPassword": "example",
"tgPassword": "example"
},
"body": {
"id":3223423,
"pageSize":50,
"status":1,
"startTime":"2018-12-01 12:12:12",
"endTime":"2019-03-01 11:11:11"
}
}
响应示例
{
"body": {
"data": [
{
"uid": "21577",
"orderRow": "2",
"productName": "推广共享资金",
"billStatus": "尚未支付",
"cacheTypeName": "加款缓存",
"payTime": "2019-04-04 14:18:44",
"actFlag": "0",
"accountName": "推广总账户",
"id": "541027",
"actTime": "2019-01-02 00:00:00",
"cash": "100.00",
"bonus": "10.00",
"payMethodName": "大客户付款"
}
]
},
"header": {
"oprs": 1,
"failures": [],
"succ": 1,
"oprtime": 0,
"desc": "success",
"status": 0
}
}
付款记录查询
接口描述
支持KA账户查询付款记录,此接口仅供KA账户使用
请求路径
http://sem.baidubce.com/v1/feed/cloud/PaymentFeedService/getPaymentHistory
请求
字段名称 | 类型 | 描述 |
---|---|---|
fundType | number | 资金类型,必填,21(ka 现金),22(ka 优惠) |
id | number | 记录id,第一页数据不填,第二页及往后的数据必须填,升序填当前页最大id值,降序填当前页最小id值,当前只支持降序 |
pageSize | number | 每页数量大小,必填,每页数量必须大于0,小于等于1000 |
startTime | string | 支付时间-开始时间,选填,格式:yyyy-MM-dd HH:mm:ss |
endTime | string | 支付时间-结束时间,选填,格式:yyyy-MM-dd HH:mm:ss |
响应
字段名称 | 类型 | 描述 |
---|---|---|
id | number | 流水号 |
userId | number | 用户id |
userName | string | 用户名 |
mainAccountId | number | 主账户id |
mainAccountName | string | 主账户名 |
fund | number | 金额,单位:元,正数表示加款,负数表示退款 |
accountName | string | 账户类型 |
fundPurpose | string | 资金用途 |
payMethodName | string | 支付方式 |
payTime | string | 加款时间,格式:yyyy-MM-dd HH:mm:ss |
orderId | number | 订单号 |
请求示例
POST /v1/feed/cloud/PaymentFeedService/getPaymentHistory HTTP/1.1
Accept-encoding: 'gzip, deflate'
Host: sem.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
Accept: '*/*'
{
"header": {
"opUsername": "example",
"tgUsername": "example",
"bceUser": "example",
"opPassword": "example",
"tgPassword": "example"
},
"body": {
"fundType": 21,
"pageSize": 50,
"startTime": "2019-01-01 00:00:00",
"endTime": "2019-06-01 00:00:00",
}
}
响应示例
{
"body": {
"data": [
{
"id": 4212131,
"userId": 3423,
"userName": "example",
"mainAccountId": 2347,
"mainAccountName": "example",
"fund": 1243.12,
"accountName": "推广总账户",
"fundPurpose": "推广共享资金",
"payMethodName": "产品转账",
"payTime": "2019-05-01 12:11:11",
"orderId": 327498237423
}
]
},
"header": {
"oprs": 1,
"failures": [],
"succ": 1,
"oprtime": 0,
"desc": "success",
"status": 0
}
}
账户管家查询下辖子账户
接口描述
账户管家查询下辖子账户,此接口仅供账户管家权限使用,查询操作账户即账户管家的下辖账户列表。header中的被操作账户可以传子账户中任意一个,对该接口功能无影响。
接口URL
http://sem.baidubce.com/v1/feed/cloud/MccFeedService/getUserListByMccid
请求参数说明
无请求内容
响应参数说明
字段名称 | 类型 | 描述 |
---|---|---|
userid | number | 用户id |
username | string | 用户名 |
mccid | number | 账户管家id |
fatname | string | 账户管家名称 |
remark | string | 备注 |
请求示例
POST /v1/feed/cloud/MccFeedService/getUserListByMccid HTTP/1.1
Accept-encoding: 'gzip, deflate'
Host: sem.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
Accept: '*/*'
{
"header": {
"opUsername": "example",
"opPassword":"example",
"tgSubname":"example",
"bceUser":"example"
},
"body": {
}
}
响应示例
{
"body": {
"data": [
{
"userid": 234,
"username": "example",
"mccid": 32423,
"fatname": "example",
"remark": "备注"
}
]
},
"header": {
"oprs": 1,
"failures": [],
"succ": 1,
"oprtime": 0,
"desc": "success",
"status": 0
}
}
账户管家查询子账户间转账记录
接口描述
账户管家查询其下辖子账户间的转账记录。header中的被操作账户可以传子账户中任意一个,对该接口功能无影响。
接口URL
http://sem.baidubce.com/v1/feed/cloud/MccHistoryService/getAccountTransferHistory
请求参数说明
字段名称 | 类型 | 描述 |
---|---|---|
startTime | string | 起始日期(包含)。格式为"YYYY-MM-DD",如"2019-01-01"。 |
endTime | string | 结束日期(不包含)。格式为"YYYY-MM-DD",如"2019-01-31"。 |
响应参数说明
字段名称 | 类型 | 描述 |
---|---|---|
optid | number | 操作者账户ID |
optName | string | 操作者账户名称 |
outUcId | number | 转出账户ID |
outUcName | string | 转出账户名称 |
inUcId | number | 转入账户ID |
inUcName | string | 转入账户名称 |
transferType | string | 转账类型 |
transferMoney | number | 转账金额(单位:元) |
uuid | string | 转账记录ID |
transferTime | string | 转账时间。格式为"YYYY-MM-DD HH-MM-SS",如"2019-01-01 15:00:00"。 |
请求示例
POST /v1/feed/cloud/MccHistoryService/getAccountTransferHistory HTTP/1.1
Accept-encoding: 'gzip, deflate'
Host: sem.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
Accept: '*/*'
{
"header": {
"opUsername": "example",
"opPassword":"example",
"tgSubname":"example",
"bceUser":"example"
},
"body": {
"startTime":"2019-11-12",
"endTime":"2019-11-13"
}
}
响应示例
{
"body": {
"data": [
{
"optid": 12345,
"optName": "管家账户A",
"outUcId": 12346,
"outUcName": "推广账户B",
"inUcId": 12347,
"inUcName": "推广账户C",
"transferType": "推广资金池",
"transferMoney": "100.00",
"uuid": "25323463-26598762-22830277-100-feed-bf4we60a-23a4-4d8b-83aa-94c",
"transferTime": "2019-11-12 18:22:31"
}
]
},
"header": {
"oprs": 1,
"failures": [],
"succ": 1,
"oprtime": 0,
"desc": "success",
"status": 0
}
}
设置RTA配置信息
接口描述
设置账户RTA配置信息。
接口URL
http://sem.baidubce.com/v1/feed/cloud/AccountFeedService/updateRtaSettingFeed
请求参数说明
请求参数为RTA配置信息对象
响应参数说明
响应内容为RTA配置信息对象
请求示例
POST /v1/feed/cloud/AccountFeedService/updateRtaSettingFeed HTTP/1.1
Accept-encoding: 'gzip, deflate'
Host: sem.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
Accept: '*/*'
{
"header": {
"opUsername": "example",
"opPassword":"example",
"tgSubname":"example",
"bceUser":"example"
},
"body": {
"url": "http://xxx.com",
"qps": 0,
"cacheTime": 0,
"strategyIds": [1,2,7],
"customToken": "123abc"
}
}
响应示例
{
"body": {
"data": [
{
"userId": 123,
"url": "http://xxx.com",
"qps": 0,
"cacheTime": 0,
"strategyIds": [1,2,7],
"customToken": "123abc",
"token": "e7f7410ced6615749fd067ab6a0ff45b"
}
]
},
"header": {
"oprs": 1,
"failures": [],
"succ": 1,
"oprtime": 0,
"desc": "success",
"status": 0
}
}
查询RTA配置信息
接口描述
查询账户RTA配置信息。
接口URL
http://sem.baidubce.com/v1/feed/cloud/AccountFeedService/getRtaSettingFeed
请求参数说明
无
响应参数说明
响应内容为RTA配置信息对象
请求示例
POST /v1/feed/cloud/AccountFeedService/getRtaSettingFeed HTTP/1.1
Accept-encoding: 'gzip, deflate'
Host: sem.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
Accept: '*/*'
{
"header": {
"opUsername": "example",
"opPassword":"example",
"tgSubname":"example",
"bceUser":"example"
},
"body": {}
}
响应示例
{
"body": {
"data": [
{
"userId": 123,
"url": "http://xxx.com",
"qps": 0,
"cacheTime": 0,
"strategyIds": [1,2,7],
"customToken": "123abc",
"token": "e7f7410ced6615749fd067ab6a0ff45b"
}
]
},
"header": {
"oprs": 1,
"failures": [],
"succ": 1,
"oprtime": 0,
"desc": "success",
"status": 0
}
}