账户模块

账户信息对象

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

字段名称 类型 描述
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:好看视频

查询账户信息

接口描述

查询账户信息。

接口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",         // 操作账户用户名(信息流账户用户名)
    "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,第一页数据不填或填0,第二页及往后的数据必须填,升序填当前页最大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
    }
}

账户管家查询下辖子账户

接口描述

账户管家查询下辖子账户,此接口仅供账户管家权限使用,查询操作账户即账户管家的下辖账户列表,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
    }
}