更新时间:2022-04-25 GMT+08:00
分享

新增邮寄地址

功能介绍

伙伴可以新增自己的邮寄地址信息。

伙伴登录伙伴中心新增邮寄地址请参见向华为云索取发票,进入索取发票页面,选择纸质发票,即可设置邮件地址。

接口约束

该接口可以使用合作伙伴AK/SK或者Token调用。

调试

您可以在API Explorer中调试该接口。

URI

POST /v2/customers/postal-addresses

请求消息

表1 Header参数

参数

是否必选

取值范围

描述

X-Language

最大长度:8

语言。

中文:zh_CN

缺省为zh_CN。

请求参数

参数

是否必选

参数类型

取值范围

描述

recipient

String

最大长度:256

收件人姓名。

province

String

最大长度:64

省、自治区或直辖市。例如:江苏省。

city

String

最大长度:64

市/区。例如:南京市。

district

String

最大长度:64

区。例如:雨花台区。

address

String

最大长度:200

邮寄详细地址。

zipcode

String

最大长度:32

邮寄地址所在邮编。

mobile_phone

String

最大长度:32

手机号码,不带国家码。

is_default

Integer

-

是否默认地址,默认为0。

  • 1:默认地址
  • 0:非默认地址

请求示例

POST https://bss.myhuaweicloud.com/v2/customers/postal-addresses HTTP/1.1
Content-Type: application/json
X-Auth-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
{
    "recipient": "王**",
    "province": "**省",
    "city": "**市",
    "district": "**区",
    "address": "*******",
    "zipcode": "11****",
    "mobile_phone": "188****8888",
    "is_default": 0
}

响应消息

响应参数

参数

参数类型

取值范围

描述

error_code

String

最大长度:20

状态码。具体请参考状态码。只有失败才返回该字段。

error_msg

String

最大长度:1000

错误描述信息。只有失败才返回该字段。

address_id

String

最大长度:64

邮寄地址ID。

响应示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time 
{
    "address_id": "e613*****21b"
}

状态码

  • 状态码4xx:由于明显的客户端错误(例如,格式错误的请求语法、参数错误等),华为云会返回4xx错误码,请及时检查请求消息的正确性,重新发起请求。
  • 状态码5xx:由于华为云系统原因,导致无法完成明显有效请求的处理,可及时联系华为云客服处理。

HTTP状态码

错误码

错误描述

403

CBC.0151

访问拒绝。

500

CBC.0999

其他错误。

分享:

    相关文档

    相关产品

关闭导读