华为云API符合RESTful API设计理论。
REST从资源的角度观察整个网络,分布在各处的资源由URI(Uniform Resource Identifier)确定,客户端的应用通过URL(Unified Resource Locator)获取资源。
URL的一般格式为:https://Endpoint/uri。
URL中的参数说明如
表1所示。
表1 URL中的参数说明参数
|
描述
|
Endpoint
|
Web服务入口点的URL,云市场的Endpoint为“mkt.myhuaweicloud.com”。
|
uri
|
资源路径,也即API访问路径。从具体接口的URI模块获取,例如“v1.0/{partner_id}/billing/bill-mgr/push-usage-data”。
其中,uri中的用户标识参数说明如下:
使用“partner_id”标识,表示该接口只能使用合作伙伴(ISV)自身的AK/SK或者Token调用。
|
华为云接口采用HTTP传输协议,有如下约束条件:
- 请求/响应报文使用JSON报文UTF-8字符集编码。
- 媒体类型表示为Application/json。
- 可选参数在消息体中可以不编码。
- 接口请求参数和响应参数中时间格式统一为UTC时间(包括时区),格式为yyyyMMdd'T'HHmmss'Z'。
其中,HH范围是0~23,mm和ss范围是0~59。