全部产品

财务管理API

更新时间:2018-08-08 16:39:35

提供用户账户充值以及账单查询功能。

具体域名请联系阿里云营销引擎技术支持获取。

账户详单(GetAdvertiserQueryRequest)

请求方式

GET

请求结构

http://xxxxxx.aliyuncs.com/advertiser/query/amount

参数列表

HEAD 类型 说明
ORG-ADID long 推广主ID
参数 类型 必填 描述

请求样例

http://xxxxxx.aliyuncs.com/advertiser/query/amount

返回字段

字段名 说明
result 返回执行结果,取值:SUCCESS/FAILURE
data 返回true/false
errorCode 错误码
message 错误提示信息
recharge 总充值金额
consume 总消费金额
refund 总退款金额
adv_status 广告主状态
id 广告主id

返回样例

JSON格式

  1. {
  2. "result": "SUCCESS",
  3. "data": {
  4. "recharge": 1000.00,
  5. "consume": 100.00,
  6. "refund": 10.00,
  7. "id": 1,
  8. "adv_status": 1
  9. }
  10. }

账户充值(RechargeForAdvRequest)

请求方式

POST

请求结构

http://xxxxxx.aliyuncs.com/account/recharge/

参数列表

参数 类型 必填 描述
adv_id long Y 推广主id
money long Y 充值金额
order_id String Y 订单id

请求样例

示例
{ “adv_id”: 1000006, “money”: 100, “order_id”:”123” }

返回字段

字段名 说明
result 返回执行结果,取值:SUCCESS/FAILURE
data 返回true/false
errorCode 错误码
message 错误提示信息

返回样例

JSON格式

  1. { "result": "SUCCESS", "data": true }

账户退款(RefundForAdvRequest)

请求方式

POST

请求结构

http://xxxxxx.aliyuncs.com/account/refund/

参数列表

参数 类型 必填 描述
adv_id long Y 推广主id
money long Y 充值金额
order_id String Y 订单id

请求样例

示例
{ “adv_id”: 1000006, “money”: 100, “order_id”:”123”}

返回字段

字段名 说明
result 返回执行结果,取值:SUCCESS/FAILURE
data 返回true/false
errorCode 错误码
message 错误提示信息

返回样例

JSON格式

  1. { "result": "SUCCESS", "data": true }

天粒度账单查询(GetAdvStatementRequest)

请求方式

GET

请求结构

http://xxxxxx.aliyuncs.com/advstatement/query/adv_consumption_statement/${start_time}/${end_time}?page=${page}&size=${size}

参数列表

参数 类型 必填 描述
start_time string Y 开始时间(yyyy-mm-dd)
end_time string Y 结束时间(yyyy-mm-dd)
page int N 当前页码,默认1
size int N 一页展现条数,默认10

请求样例

http://xxxxxx.aliyuncs.com/advstatement/query/adv_consumption_statement/2017-01-01/2017-01-07?page=1&size=10

返回字段

字段名 说明
result 返回执行结果,取值:SUCCESS/FAILURE
data 返回账单信息
errorCode 错误码
message 错误提示信息
date 账单日期
amount 账单金额
type 账单类型1:充值,3:退款

返回样例

JSON格式

  1. {
  2. "data": {
  3. "total": 1,
  4. "list": [{
  5. "date": "2017-01-04 00:00:00",
  6. "amount": 100,
  7. "type": 1
  8. }]
  9. },
  10. "result": "SUCCESS"
  11. }

账单详情查询(GetAdvStatementRequest)

请求方式

GET

请求结构

http://xxxxxx.aliyuncs.com/advstatement/query/adv_consumption_statement_detail/${start_time}/${end_time}?page=${page}&size=${size}&type=${type}

参数列表

参数 类型 必填 描述
start_time string Y 开始时间(yyyy-mm-dd)
end_time string Y 结束时间(yyyy-mm-dd)
page int N 当前页码,默认1
size int N 一页展现条数,默认10
type int Y 操作类型(1:充值;2:消费;3:退款)

请求样例

http://xxxxxx.aliyuncs.com/advstatement/query/adv_consumption_statement/2017-01-01/2017-01-07?page=1&size=10

返回字段

字段名 说明
result 返回执行结果,取值:SUCCESS/FAILURE
data 返回账单信息
errorCode 错误码
message 错误提示信息
date 账单日期
amount 账单金额
type 账单类型

返回样例

JSON格式

  1. {
  2. "data": {
  3. "total": 1,
  4. "list": [{
  5. "date": "2017-01-04 17:50:09",
  6. "amount": 100,
  7. "type": 1
  8. }]
  9. },
  10. "result": "SUCCESS"
  11. }