向云经销商发放代金券额度
接口约束
该接口只允许使用华为云总经销商的AK/SK或者Token调用。
调试
您可以在API Explorer中调试该接口。
URI
POST /v2/partners/coupon-quotas/indirect-partner-adjust
请求消息
|
参数 |
是否必选 |
参数类型 |
取值范围 |
描述 |
|---|---|---|---|---|
|
indirect_partner_ids |
是 |
List<String> |
最大个数：100 |
云经销商ID列表。 |
|
quota_amount |
是 |
BigDecimal |
- |
华为云总经销商向云经销商发放的代金券额度值。 单位：元。取值大于0且精确到小数点后2位。 |
|
quota_id |
是 |
String |
最大长度：64 |
华为云总经销商发放的代金券额度的ID。获取方法请参见查询优惠券额度。 |
请求示例
POST https://bss.myhuaweicloud.com/v2/partners/coupon-quotas/indirect-partner-adjust HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ { "quota_id": "2018011615520150", "indirect_partner_ids": ["62a*****d30"], "quota_amount": "1.11" }
响应消息
响应参数
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
状态码。具体请参考状态码。只有失败才返回该字段。 |
|
error_msg |
String |
错误描述信息。只有失败才返回该字段。 |
|
error_details |
List<ErrorDetail> |
发放失败的云经销商额度信息，具体参见表1，只有HTTP STATUS 200的时候才有这个结构体。 |
|
simple_quota_infos |
List<SimpleQuotaInfo> |
发放成功的云经销商额度信息，具体参见表2，只有HTTP STATUS 200的时候才有这个结构体。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
云经销商ID。 |
|
error_code |
String |
状态码。具体请参考状态码。只有失败才返回该字段。 |
|
error_msg |
String |
错误描述信息。只有失败才返回该字段。 |
响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time
{
"error_details": [],
"simple_quota_infos": [
{
"id": "096725aa7800d4530f96c011b19aeca0",
"quota_id": "2024051602054802"
}
]
}
状态码
- 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。
- 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。
|
HTTP状态码 |
错误码 |
错误描述 |
|---|---|---|
|
400 |
CBC.0100 |
参数错误。 |
|
403 |
CBC.0150 |
非法操作。 |
|
400 |
CBC.50000045 |
不能对同一个代金券额度进行频繁操作。上一次的代金券额度划拨正在进行中，不允许并行划拨，待结束后再进行下一次操作。 |
|
200 |
CBC.50010105 |
无法给退出中的云经销商发放代金券额度。 |
|
400 |
CBC.99000013 |
优惠券额度不足。 |
|
400 |
CBC.99000015 |
此状态的额度不支持发放。 |
|
400 |
CBC.99000017 |
额度未生效或者已过期。 |
|
400 |
CBC.99000037 |
您没有操作该云经销商的权限。 |
|
400 |
CBC.50000021 |
该代金券额度指定客户非云经销商子客户，不支持发放给云经销商。 |
|
403 |
CBC.0151 |
访问拒绝。 |
|
500 |
CBC.0999 |
其他错误。 |
