API Explorer

名称	类型	IN	必选	描述
X-Auth-Token	string	header	是	合作伙伴Token调用
indirect_partner_id	string	query	否	云经销商ID。获取方法请参见查询云经销商列表。华为云总经销商(一级经销商)查询云经销商发放给子客户的优惠券发放记录时,需要携带该参数,否则只能查询发给自己子客户的优惠券发放记录。
limit	integer	query	否	每页记录数。默认值为10。此参数不携带或携带值为空或携带值为null时,取默认值10;不支持携带值为空串。
offset	integer	query	否	偏移量,从0开始。默认值为0。此参数不携带或携带值为空或携带值为null时,取默认值0;不支持携带值为空串。说明: offset用于分页处理,如不涉及分页,请使用默认值0。offset表示相对于满足条件的第一个数据的偏移量。如offset = 1,则返回满足条件的第二个数据至最后一个数据。例如,满足查询条件的结果共10条数据,limit取值为10,offset取值为1,则返回的数据为2~10,第一条数据不返回。
result	string	query	否	操作结果。0:成功-1:失败(非0的记录)此参数不携带或携带值为非枚举值时,不作为筛选条件。
operation_time_end	string	query	否	操作时间(结束)。UTC时间,格式:yyyy-MM-dd'T'HH:mm:ss'Z',如“2019-05-06T08:05:01Z”。其中,HH范围是0~23,mm和ss范围是0~59。输入这个条件,会查询出操作时间小于这个时间的记录。此参数不携带或携带值为空时,不作为筛选条件;不支持携带值为空串和携带值为null。
operation_time_begin	string	query	否	操作时间(开始)。UTC时间,格式:yyyy-MM-dd'T'HH:mm:ss'Z',如“2019-05-06T08:05:01Z”。其中,HH范围是0~23,mm和ss范围是0~59。输入这个条件,会查询出操作时间大于这个时间的记录。此参数不携带或携带值为空时,不作为筛选条件;不支持携带值为空串和携带值为null。
customer_id	string	query	否	客户账号ID。您可以调用查询客户列表接口获取customer_id。此参数不携带或携带值为空时,不作为筛选条件;携带值为空串或携带值为null时,作为筛选条件。
coupon_ids	Array of strings	query	否	代金券ID列表。请从“发放优惠券”接口的响应参数中获取。此参数不携带时,不作为筛选条件;携带值为空列表或携带值为null时,作为筛选条件。
quota_type	integer	query	否	额度类型。0:代金券额度1:现金券额度此参数不携带或携带值为空或携带值为null时,不作为筛选条件;不支持携带值为空串。
quota_id	string	query	否	额度ID。请从“查询优惠券额度”接口的响应参数中获取。此参数不携带或携带值为空时,不作为筛选条件;携带值为空串或携带值为null时,作为筛选条件。
operation_types	Array of strings	query	否	操作类型。1:发放2:手动回收3:解绑自动回收4:过期回收5:退订回收6:退款充值撤销7:建立关联回收此参数不携带时,不作为筛选条件;携带值为空列表或携带值为null时,作为筛选条件。

名称	类型	描述
total_count	integer	查询记录总数。
records	Array of CouponRecordV2 objects	日志记录列表。具体请参见表2。

名称

类型

描述

total_count

integer

查询记录总数。

records

Array of CouponRecordV2 objects

日志记录列表。具体请参见表2。

名称	类型	描述
id	string	该记录的ID。
operation_type	string	操作类型。 1:发放2:手动回收3:解绑自动回收4:过期回收5:退订回收6:退款充值撤销7:建立关联回收
quota_id	string	额度ID。
quota_type	integer	额度类型。 0:代金券额度1:现金券额度
coupon_id	string	代金券ID。
customer_id	string	客户账号ID。
operation_amount	number	操作的面额值。单位:元。发放时,等于面额值;回收时,指每次回收的具体值。
operation_time	string	操作时间。
result	string	操作结果。 0:成功-1:失败
remark	string	操作记录中的备注。

名称

类型

描述

string

该记录的ID。

operation_type

string

操作类型。 1:发放2:手动回收3:解绑自动回收4:过期回收5:退订回收6:退款充值撤销7:建立关联回收

quota_id

string

额度ID。

quota_type

integer

额度类型。 0:代金券额度1:现金券额度

coupon_id

string

代金券ID。

customer_id

string

客户账号ID。

operation_amount

number

操作的面额值。单位:元。发放时,等于面额值;回收时,指每次回收的具体值。

operation_time

string

操作时间。

result

string

操作结果。 0:成功-1:失败

remark

string

操作记录中的备注。

"GET https://bss.myhuaweicloud.com/v2/promotions/benefits/partner-coupons/records/query?operation_types=1&quota_id=CS19040119281JMYC&quota_type=1&coupon_ids=CP180117115414HB5I&customer_id=1&operation_time_begin=2017-12-17T10:32:02Z&operation_time_end=2017-12-17T10:32:02Z&result=0&offset=0&limit=10&indirect_partner_id=5c2ec3bd80c9462aad432f5566e9feb1"

{ "total_count": 2141, "records": [ { "id": "WCw34WJX2cx9jydKBJv", "operation_type": "1", "quota_id": "2020061902124506", "quota_type": 0, "coupon_id": "CP200619021225J7JJ", "customer_id": "068a6d2762fb42288536b6ba57d1ffae", "operation_amount": 19.01, "operation_time": "2020-06-19T02:12:26Z", "result": "0", "remark": null }, { "id": "tmxlGvcbSeTKphVksVQ", "operation_type": "2", "quota_id": "20190703022342029", "quota_type": 0, "coupon_id": "CP2006150657196F0M", "customer_id": "068a6d2762fb42288536b6ba57d1ffae", "operation_amount": 0.02, "operation_time": "2020-06-15T06:57:35Z", "result": "0", "remark": null }, { "id": "PXfd0d6VVSXzeKThP7o", "operation_type": "1", "quota_id": "20190703022342029", "quota_type": 0, "coupon_id": "CP2006150657196F0M", "customer_id": "068a6d2762fb42288536b6ba57d1ffae", "operation_amount": 0.02, "operation_time": "2020-06-15T06:57:20Z", "result": "0", "remark": "" } ] }

本文导读