请求结构

最近更新时间:2018-08-03 18:07:14

请求结构

客户调用金山云云服务器服务的openAPI接口是通过向指定服务地址发送请求,并按照openAPI文档说明在请求中添加相应的公共参数和接口参数来完成的。

云服务器openAPI的请求结构组成如下:

  1. 服务地址

    云服务器的服务接入地址为:kec.region.api.ksyun.com

  2. 通信协议

    支持通过 HTTP 或 HTTPS 两种方式进行请求通信,推荐使用安全性更高的 HTTPS方式发送请求。

  3. 请求方法

    云服务器的openAPI同时支持GET和POST请求,推荐使用GET请求方式。

    注意

    • 不能混合使用两种请求方式。如果使用 GET 方式,参数均从 querystring 取得;如果使用 POST 方式,参数均从 请求Body中取得
    • 如果请求方式是GET,需要对所有请求参数做URL编码;如果请求方式是POST,需要使用x-www-form-urlencoded方式进行编码。
  4. 请求参数

    金山云openAPI请求包含两类参数:公共请求参数接口请求参数。其中,公共请求参数是每个接口都要用到的请求参数,具体可参见公共参数小节;接口请求参数是各个接口所特有的,具体见各个接口的“请求参数”描述。

  5. 字符编码

    请求及返回结果都使用UTF-8字符集进行编码。

金山云,开启您的云计算之旅

立即注册