账户模块

更新时间：2020-04-07

账户信息对象

账户信息对象定义了推广账户的属性，账户模块的多个接口均引用了其定义，请参考各个接口的使用说明。

字段名称	类型	描述
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
	}
}

示例代码

推广计划模块

百度信息流推广API

百度信息流推广API

账户模块

账户信息对象

RTA配置信息对象

查询账户信息

更新账户设置

查询待加款项

付款记录查询

账户管家查询下辖子账户

账户管家查询子账户间转账记录

设置RTA配置信息

查询RTA配置信息