华为云API符合RESTful API的设计理论。
REST从资源的角度来观察整个网络,分布在各处的资源由URI(Uniform Resource Identifier)确定,而客户端的应用通过URL(Unified Resource Locator)来获取资源。
调用接口的格式:
URL的一般格式为:https://Endpoint/uri
URL中的参数说明如表1-1所示。
表1-1 URL中的参数说明参数描述EndpointWeb服务入口点的URL,从地区和终端节点中获取。
uri资源路径,也即API访问路径。从具体接口的URI模块获取,例如“v3/auth/tokens”。
在HTTP协议中,请求可以使用多种请求方法例如GET、 PUT、 POST、 DELETE、PATCH,用于指明以何种方式来访问指定的资源,目前提供的REST接口支持的请求方法如下表1-2所示。
调用接口的方法
表1-2请求方法一览表方法说明GET请求服务器返回指定资源。
PUT请求服务器更新指定资源。
POST请求服务器新增资源或执行特殊操作。
DELETE请求服务器删除指定资源,如删除对象等。
PATCH请求服务器更新资源的部分内容。
当资源不存在的时候,PATCH可能会去创建一个新的资源。
调用接口的认证方式
·调用接口有如下两种认证方式,您可以任选其中一种进行认证鉴权。
·Token认证:通过Token认证调用请求。
·AK/SK认证:通过AK(Access Key ID)/SK(Secret Access Key)加密调用请求。
本文主要介绍,如何使用p