华为云用户手册

请求消息 请求参数 无。 请求示例 GET https://bss.myhuaweicloud.com/v2/accounts/partner-accounts/balances?indirect_partner_id=0977ffa9f20010790f0fc003f6900520 HTTP/1.1Content-Type: application/jsonX-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

URI GET /v2/accounts/partner-accounts/balances 参数说明请参见下表。 表1 查询参数 参数 是否必选 参数类型 取值范围 描述 indirect_partner_id 否 String 最大长度：64 云经销商ID。 获取方法请参见查询云经销商列表。 华为云总经销商（一级经销商）查询云经销商（二级经销商）余额时，需要携带该参数；除此之外，此参数不做处理。否则只能查询自己的账户余额。

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 描述 200 CBC.5001 非合作伙伴。 400 CBC.99000037 您没有操作该云经销商的权限。 403 CBC.0151 访问拒绝。 500 CBC.0999 其他错误。

请求消息 请求参数 参数 是否必选 参数类型 取值范围 描述 customer_id 是 String 最大长度：64 客户账号ID。您可以调用查询客户列表接口获取customer_id。 amount 是 BigDecimal - 回收的金额。 单位：元。取值大于0且精确到小数点后2位。 indirect_partner_id 否 String 最大长度：64 云经销商ID。获取方法请参见查询云经销商列表。 云经销商（二级经销商）回收云经销商（二级经销商）的子客户账户余额时，需携带此参数；除此之外，该参数不做处理；否则只能回收自己的子客户账户余额。

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 描述 400 CBC.0100 参数错误。 400 CBC.99000000 无对该客户的操作权限。 400 CBC.99000035 非合作伙伴子客户。 400 CBC.99000037 您没有操作该云经销商的权限。 400 CBC.99000047 可回收金额的子客户拨款账户不存在。 400 CBC.99005003 余额不足。 403 CBC.0151 访问拒绝 500 CBC.0999 其他错误。

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 描述 400 CBC.0100 参数错误。 400 CBC.99000037 您没有操作该云经销商的权限。 403 CBC.0151 访问拒绝。 500 CBC.0999 未知错误。

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 描述 200 CBC.0000 成功。 200 CBC.6001 资源ID或者预留实例ID为空。 500 CBC.0999 其他错误。 400 CBC.0100 参数错误。 403 CBC.0151 拒绝访问。

响应消息 响应参数 参数 参数类型 描述 error_code String 状态码。 具体请参见状态码。 error_msg String 错误描述信息。 ratingResult RatingResult 询价结果。 具体请参见表3 表3 RatingResult 参数 参数类型 取值范围 描述 productId String 最大长度：64 变更后的产品ID。 amount Double - 订单总额，即最终优惠后的订单金额。 discountAmount Double - 订单优惠额。 originalAmount Double - 订单原总额，即优惠前订单总额。 measureId Integer - 度量单位标识： 1：元 2：角 3：分 currency String 最大长度：10 货币单位代码（遵循ISO 4217标准）。 CNY：人民币 值为空代表人民币。 extendParams String 最大长度：1024 扩展参数。 响应示例: HTTP/1.1 200 OKContent-Type: application/json;charset=UTF-8Content-Length: lengthDate: response time { "error_code": "CBC.0000", "error_msg": "Success", "ratingResult": { "productId": "00301-279093-0--1", "amount": 60, "discountAmount": 0, "originalAmount": 60, "measureId": 1, "currency": null, "extendParams": null }}

请求消息 请求参数 参数 是否必选 参数类型 取值范围 描述 productInfo 是 ProductInfo - 变更后的新的云服务产品信息。 具体请参见表2。 tenantId 否 String 最大长度：128[1-128] 项目ID。 此参数预留。 可以调用“通过assume_role方式获取用户token”接口获取项目ID，参见如何获取合作伙伴ID（partner_id）进入“我的凭证”页面，在“项目列表”页签，可以查看不同所属区域对应的项目ID。 此参数不携带或携带值为null时，不作为筛选条件；不支持携带值为空串。 resourceId 是 String 最大长度：128 资源标识ID。 可以通过调用“查询客户包年/包月资源列表”接口获取。 inquiryTime 否 String 最大长度：40 询价时间。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。 为空的时候默认当前时间。 其中，HH范围是0～23，mm和ss范围是0～59。 此参数不携带或携带值为空串或携带值null时，默认当前时间。当inquiryTime不为空时用于匹配定价，作为变更操作的生效时间来计算价格。 表2 ProductInfo 参数 是否必选 参数类型 取值范围 描述 cloudServiceType 是 String 最大长度：400 云服务类型编码，例如OBS的云服务类型编码为“hws.service.type.obs”。您可以调用查询云服务类型列表接口获取。 resourceType 是 String 最大长度：400 资源类型编码，例如ECS的VM为“hws.resource.type.vm”。您可以调用查询资源类型列表接口获取。 resourceSpecCode 是 String 最大长度：400 云服务产品的资源规格。如果是VM的资源规格，则需要在规格后面添加“.win”或“.linux”，例如“s2.small.1.linux”。 resourceSize 否 Integer [1-214783647] 资源容量大小，与“resouceSizeMeasureId”配合使用。 例如购买的卷大小或带宽大小。 询价线性产品时，此参数必填。 resouceSizeMeasureId 否 Integer [1-214783647] 资源容量度量标识，枚举值如下： 15：Mbps（购买带宽时使用） 17：GB（购买云硬盘时使用） extendParams 否 String 最大长度：10240 扩展参数，可空。 此参数不携带或携带值为空串或携带值为null时，不作为筛选条件。 请求示例 POST https://bss.myhuaweicloud.com/v1.0/{domain_id}/customer/product-mgr/query-change-rating HTTP/1.1Content-Type: application/jsonX-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ{ "tenantId": "74610f3a5ad941998e91f076297ecf27", "resourceId": "49efc9fc53ad4015888035d6e65420a2", "productInfo": { "cloudServiceType": "hws.service.type.ebs", "resourceType": "hws.resource.type.volume", "resourceSpecCode": "SSD", "resourceSize": 200, "resouceSizeMeasureId": 17 }, "inquiryTime": "2017-08-23T08:00:00Z"}

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 描述 200 CBC.0000 成功。 500 CBC.0999 其他错误。 400 CBC.0100 参数错误。 403 CBC.0151 访问拒绝。 200 CBC.5004 无对该客户的操作权限。

请求消息 请求参数 无 请求示例 GET https://bss.myhuaweicloud.com/v2/accounts/partner-accounts/adjust-records?indirect_partner_id=051a8a834180d3fb0f25c006b1998800&offset=0&limit=10&operation_type=SOURCE_OPERATION_BEADJUST&customer_id=051a8a834180d3fb0f25c006b1998801&operation_time_begin=2016-03-28T14:45:38Z&operation_time_end=2016-03-28T14:45:38Z&trans_id=AD2020061504210203c128 HTTP/1.1Content-Type: application/jsonX-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

URI GET /v2/accounts/partner-accounts/adjust-records 表1 查询参数 参数 是否必选 参数类型 取值范围 描述 customer_id 否 String 最大长度：64 客户账号ID。您可以调用查询客户列表接口获取customer_id。 为空表示查询所有的调账记录。 不为空表示仅查询与该客户相关的调账记录。 默认查询所有客户的调账记录。 此参数不携带或携带值为空时，不作为筛选条件。 说明： 此处的客户包含伙伴的子客户，以及华为云总经销商关联的云经销商（二级经销商）。 operation_type 否 String 最大长度：50 操作类型。 SOURCE_OPERATION_BEADJUST：拨款 SOURCE_OPERATION_BERETRIEVE：回收 SOURCE_OPERATION_BEUNBIND：解绑回收 不传递默认查询所有类型。 此参数不携带或携带值为空时，不作为筛选条件。 operation_time_begin 否 String 最大长度：20 调账起始时间。 UTC时间，格式为：2016-03-28T14:45:38Z。 此参数不携带或携带值为空时，不作为筛选条件。 operation_time_end 否 String 最大长度：20 调账截止时间。 UTC时间，格式为：2016-03-28T14:45:38Z。 此参数不携带或携带值为空时，不作为筛选条件。 trans_id 否 String 最大长度：128 事务ID。 此参数不携带或携带值为空时，不作为筛选条件。 offset 否 Integer [0-最大整数] 页码，从0开始，默认为0，如果要查询第一页，请输入0，后面依次类推。 当传入的页码数大于实际页码的最大值时，返回第一页数据。 limit 否 Integer [1-100] 每页的显示条数。默认值为10。 indirect_partner_id 否 String 最大长度：64 云经销商ID。获取方法请参见查询云经销商列表。 华为云总经销商（一级经销商）查询云经销商（二级经销商）的子客户调账记录时，需携带此参数；否则只能查询自己的子客户调账记录。除此之外，此参数不做处理。

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 描述 400 CBC.0100 参数错误。 400 CBC.99000037 您没有操作该云经销商的权限。 403 CBC.0151 访问拒绝。 500 CBC.0999 其他错误。

响应消息 响应参数 参数 参数类型 取值范围 描述 error_code String 最大长度：16 状态码。具体请参考状态码。 error_msg String 最大长度：1024 错误描述信息。 status String 最大长度：16 0：该登录名称/手机号/邮箱不存在。 1：该登录名称/手机号/邮箱存在。 uplimit String 最大长度：1 是否达到上限。 0：没有达到上限 1：达到上限 响应示例 HTTP/1.1 200 OKContent-Type: application/json;charset=UTF-8Content-Length: lengthDate: response time { "error_code": "CBC.0000", "error_msg": "success", "status": "0", "uplimit"："0"}

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 描述 200 CBC.0000 成功。 200 CBC.0100 参数错误。 400 CBC.5001 非合作伙伴。 500 CBC.0999 其他错误。 403 CBC.0151 访问拒绝。

请求消息 请求参数 参数 是否必选 参数类型 取值范围 描述 searchType 是 String [email|mobile|name] 该字段内容可填为：“email”、“mobile”或“name”。 searchKey 是 String 最大长度：64 手机号、邮箱或登录名称。 手机号需符合正则表达式 ^\d{4}-\d+$；包括国家码，以00开头，格式：00XX-XXXXXXXX。目前手机号仅支持以86开头的国家码。 name：符合正则表达式^([a-zA-Z-]([a-zA-Z0-9_-]){4,31})$，长度5-32；不能以“op_”或“shadow_”开头且不能全为数字，且只能以字母（不区分大小写）或者-开头。 请求示例 POST https://bss.myhuaweicloud.com/v1.0/{partner_id}/partner/customer-mgr/check-user HTTP/1.1Content-Type: application/jsonX-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ{ "searchType": "mobile", "searchKey": "0086-xxxxxxxxxxx"}

状态码 HTTP响应状态码如表1所示。 表1 HTTP响应状态码 状态码 编码 状态说明 100 Continue 继续请求。 这个临时响应用来通知客户端，它的部分请求已经被服务器接收，且仍未被拒绝。 101 Switching Protocols 切换协议。只能切换到更高级的协议。 例如，切换到HTTP的新版本协议。 201 Created 创建类的请求完全成功。 202 Accepted 已经接受请求，但未处理完成。 203 Non-Authoritative Information 非授权信息，请求成功。 204 NoContent 请求完全成功，同时HTTP响应不包含响应体。 在响应OPTIONS方法的HTTP请求时返回此状态码。 205 Reset Content 重置内容，服务器处理成功。 206 Partial Content 服务器成功处理了部分GET请求。 300 Multiple Choices 多种选择。请求的资源可包括多个位置，相应可返回一个资源特征与地址的列表用于客户终端（例如：浏览器）选择。 301 Moved Permanently 永久移动，请求的资源已被永久的移动到新的URI，返回信息会包括新的URI。 302 Found 资源被临时移动。 303 See Other 查看其它地址。 使用GET和POST请求查看。 304 Not Modified 所请求的资源未修改，服务器返回此状态码时，不会返回任何资源。 305 Use Proxy 所请求的资源必须通过代理访问。 306 Unused 已经被废弃的HTTP状态码。 400 BadRequest 非法请求。 建议直接修改该请求，不要重试该请求。 401 Unauthorized 在客户端提供认证信息后，返回该状态码，表明服务端指出客户端所提供的认证信息不正确或非法。 402 Payment Required 保留请求。 403 Forbidden 请求被拒绝访问。 返回该状态码，表明请求能够到达服务端，且服务端能够理解客户请求，但是拒绝做更多的事情，因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。 404 NotFound 所请求的资源不存在。 建议直接修改该请求，不要重试该请求。 405 MethodNotAllowed 请求中带有该资源不支持的方法。 建议直接修改该请求，不要重试该请求。 406 Not Acceptable 服务器无法根据客户端请求的内容特性完成请求。 407 Proxy Authentication Required 请求要求代理的身份认证，与401类似，但请求者应当使用代理进行授权。 408 Request Time-out 服务器等候请求时发生超时。 客户端可以随时再次提交该请求而无需进行任何更改。 409 Conflict 服务器在完成请求时发生冲突。 返回该状态码，表明客户端尝试创建的资源已经存在，或者由于冲突请求的更新操作不能被完成。 410 Gone 客户端请求的资源已经不存在。 返回该状态码，表明请求的资源已被永久删除。 411 Length Required 服务器无法处理客户端发送的不带Content-Length的请求信息。 412 Precondition Failed 未满足前提条件，服务器未满足请求者在请求中设置的其中一个前提条件。 413 Request Entity Too Large 由于请求的实体过大，服务器无法处理，因此拒绝请求。为防止客户端的连续请求，服务器可能会关闭连接。如果只是服务器暂时无法处理，则会包含一个Retry-After的响应信息。 414 Request-URI Too Large 请求的URI过长（URI通常为网址），服务器无法处理。 415 Unsupported Media Type 服务器无法处理请求附带的媒体格式。 416 Requested range not satisfiable 客户端请求的范围无效。 417 Expectation Failed 服务器无法满足Expect的请求头信息。 422 UnprocessableEntity 请求格式正确，但是由于含有语义错误，无法响应。 429 TooManyRequests 表明请求超出了客户端访问频率的限制或者服务端接收到多于它能处理的请求。建议客户端读取相应的Retry-After首部，然后等待该首部指出的时间后再重试。 500 InternalServerError 表明服务端能被请求访问到，但是不能理解客户的请求。 501 Not Implemented 服务器不支持请求的功能，无法完成请求。 502 Bad Gateway 充当网关或代理的服务器，从远端服务器接收到了一个无效的请求。 503 ServiceUnavailable 被请求的服务无效。 建议直接修改该请求，不要重试该请求。 504 ServerTimeout 请求在给定的时间内无法完成。客户端仅在为请求指定超时（Timeout）参数时会得到该响应。 505 HTTP Version not supported 服务器不支持请求的HTTP协议的版本，无法完成处理。 父主题： 附录

Token认证 Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。具体Token有效期说明请参见获取用户Token。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。 在构造请求中以调用获取用户Token接口为例说明了如何调用API。获取伙伴或客户Token后，再调用其他接口时，您需要在请求消息头中添加“X-Auth-Token”，其值即为Token。例如Token值为“ABCDEFJ....”，则调用接口时将“X-Auth-Token: ABCDEFJ....”加到请求消息头即可，如下所示。 Content-Type: application/jsonX-Auth-Token: ABCDEFJ.... 获取伙伴Token请参见获取用户Token。 获取客户Token请参见通过assume_role方式获取用户token。

AK/SK认证 AK/SK签名认证方式仅支持消息体大小在12MB以内，12MB以上的请求请使用Token认证。 AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。 AK（Access Key ID）：访问密钥ID。与私有访问密钥关联的唯一标识符；访问密钥ID和私有访问密钥一起使用，对请求进行加密签名。 SK（Secret Access Key）：私有访问密钥。与访问密钥ID结合使用，对请求进行加密签名，可标识发送方，并防止请求被修改。 使用AK/SK认证时，您可以基于签名算法使用AK/SK对请求进行签名，也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见API签名指南。 签名SDK只提供签名功能，与服务提供的SDK不同，使用时请注意。

请求消息 请求参数 无。 请求示例 GET https://bss.myhuaweicloud.com/v1.0/{domain_id}/common/order-mgr/resources/detail?resource_ids=b38*****62e,249*****c07&only_main_resource=1&page_no=1&page_size=100 HTTP/1.1Content-Type: application/jsonX-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

功能介绍 客户在伙伴销售平台查询某个或所有的包年/包月资源。 注意事项： 该接口允许使用客户AK/SK或者Token调用；使用合作伙伴AK/SK或者Token调用时接口不会报错，但查询不到数据。 该接口只能查询开通成功的资源。 成功调用本接口后，如果您需要对已生效状态的资源进行续订，您可以调用“查询包年/包月产品价格”接口对查询到的包年/包月资源进行续订询价，然后再调用“续订包年/包月资源”接口进行续订。 该接口即将下线，“查询客户包年/包月资源列表”接口请参考查询客户包年/包月资源列表。

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 描述 200 CBC.0000 成功。 400 CBC.0100 参数错误。 403 CBC.0151 访问拒绝。 500 CBC.0999 其他错误。

URI GET /v1.0/{domain_id}/common/order-mgr/resources/detail 参数说明请参见下表。 表1 路径参数 参数 是否必选 取值范围 描述 domain_id 是 最大长度：64 客户账号ID。获取方法请参见如何获取客户的customer_id/domain_id。 表2 查询参数 参数 是否必选 参数类型 取值范围 描述 resource_ids 否 String 最大长度： 4096 资源ID列表。 查询指定资源ID的资源（当only_main_resource=0时，查询指定资源及其附属资源）。最大支持50个ID同时作为条件查询，多个ID以英文逗号分隔。 此参数不携带、携带空时不参与过滤；携带值为空串、null参与过滤。 说明： 资源ID是指开通资源以后，云服务针对该资源分配的标志，譬如云主机ECS的server_id。 order_id 否 String 最大长度：64 订单号。 查询指定订单下的资源。 此参数不携带、携带为空时不参与过滤；携带值为空串、携带为null参与过滤。 only_main_resource 否 Integer [0|1] 是否只查询主资源，该参数对于请求参数是子资源ID的时候无效，如果resource_ids是子资源ID，只能查询自己。 0：查询主资源及附属资源。 1：只查询主资源。 默认值为0。 此参数不携带、携带值为空、携带为null取默认值0；不支持携带为空串。 说明： 主资源是指有关联的几个资源中，处于主导位置的资源。 对于ECS而言，虚拟机VM是主资源，磁盘EVS是辅资源。 对于VPC而言，共享带宽的情况下，带宽为主资源，对应的从资源为弹性IP（可能包含多个IP）；独享带宽的情况下，弹性IP为主资源，对应的从资源为带宽。 status_list 否 String - 资源状态。 查询指定状态的资源。多个状态以英文逗号分隔。 2：使用中 4：已冻结 5：已过期 此参数不携带、携带为空时返回所有状态的资源数据；不支持携带值为空串、携带为null。 page_no 否 Integer 大于等于1的整数 页码。 默认值是1。 此参数不携带、携带值为空、携带为null时取默认值1；不支持携带值为空串。 page_size 否 Integer [1-500] 每页条数。 默认值是10。最大值是500。 此参数不携带、携带值为空、携带为null时取默认值10；不支持携带值为空串。

功能介绍 客户在伙伴销售平台查询某次退订订单或者降配订单的退款金额来自哪些资源和对应订单。 注意事项： 该接口可以使用客户AK/SK或者Token调用。 可以在调用完“退订包年/包月资源”接口生成退订订单ID后，调用该接口查询退订订单对应的金额所属资源和订单。例如，调用“退订包年/包月资源”接口退订资源及其已续费周期后，您可以调用本小节的接口查询到退订金额归属的原开通订单ID和原续费订单ID。 2018年5月份之后退订的订单才能查询到归属的原订单ID。 该接口即将下线，“查询退款订单的金额详情”接口请参考查询退款订单的金额详情。

URI GET /v1.0/{domain_id}/common/order-mgr/orders/refund-order 参数说明请参见下表。 表1 路径参数 参数 是否必选 取值范围 描述 domain_id 是 最大长度：64 如果使用客户AK/SK或者Token，此处为客户账号ID，获取方法请参见如何获取客户的customer_id/domain_id。 表2 查询参数 参数 是否必选 参数类型 取值范围 描述 order_id 是 String 最大长度：64 退订订单或者降配订单ID。

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 描述 200 CBC.0000 成功。 500 CBC.0999 其他错误。 400 CBC.0100 参数错误。 403 CBC.0151 访问拒绝。 200 CBC.5026 该订单不是降配或者退订订单。

请求消息 请求参数 无。 请求示例 GET https://bss.myhuaweicloud.com/v1.0/{domain_id}/common/order-mgr/orders/refund-order?order_id=CS1*****GT HTTP/1.1Content-Type: application/jsonX-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

响应消息 响应参数 参数 参数类型 取值范围 描述 error_code String 最大长度：16 状态码。具体请参考状态码。只有失败才会返回这个参数。 error_msg String 最大长度：1024 错误描述信息。只有失败才会返回这个参数。 响应示例 HTTP/1.1 204 No ContentContent-Type: application/json;charset=UTF-8Content-Length: lengthDate: response time

请求消息 请求参数 参数 是否必选 参数类型 取值范围 描述 receiverType 是 Integer [1] 发送类型： 1：发送短信验证码。 timeout 否 Integer [0-最大整数] 验证码超时时间。 此参数不携带或携带值为空串或携带值为null时，采用系统默认超时时间10分钟。 此参数值超过60分钟时，取值固定为5分钟。 单位：分钟 mobilePhone 是 String 最大长度：32 手机号。 目前系统只支持中国手机，必须全部是数字。 示例：13XXXXXXXXX countryCode 否 String [0086] 手机国家码，目前只支持0086。 不填写系统默认是0086。 此参数不携带或携带值为空串或携带值为null时，默认是0086。 lang 否 String 最大长度：128 根据语言如果查询不到对应模板信息，就取系统默认语言对应的模板信息。 zh-cn：中文； en-us：英文。 此参数不携带或携带值为空串或携带值为null时，取默认语言。 scene 否 String - 场景，目前支持如下场景： 29：注册场景； 18：个人银行卡实名认证场景。 不填写默认为29。 此参数不携带或携带值为null时，默认为29；不支持携带值为空串。 customerId 否 String 最大长度：64 客户ID，如果scene=18的时候必填。 scene不为18时，此参数不携带或携带值为空串或携带值为null时，不做处理。 请求示例 POST https://bss.myhuaweicloud.com/v1.0/{partner_id}/partner/common-mgr/verificationcode HTTP/1.1Content-Type: application/jsonX-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ{ "receiverType":1, "mobilePhone":"xxxxxxxxxxx", "countryCode":"0086", "lang":"xxx"}

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 错误描述 400 CBC.0100 参数错误。 401 CBC.0154 token非法/过期。 403 CBC.0151 访问拒绝。 500 CBC.0999 其他错误。 500 CBC.4002 生成验证码失败。 500 CBC.4003 验证码生成成功但发送失败。 500 CBC.4005 手机号为空/格式不合法。 500 CBC.4015 发送验证码次数已达到上限（15次/小时，60次/天）。