本文适用基于API URL发起HTTP/HTTPS GET请求的用户,如果您使用的是SDK可以跳过此环节。

请求结构

云游戏的API是RPC风格,您可以通过发送HTTP GET请求调用云游戏API。

其请求结构如下:
http://Endpoint/?Action=xx&Parameters
其中:
  • Endpoint: 云游戏API的服务接入地址为cloudgame.aliyuncs.com,cloudgame.[RegionId.]aliyuncs.com,其中,RegionId是指服务区域,用户根据自己所在区域调用指定区域的API。 目前已开通服务的区域如下:
    开通区域 RegionId 服务接入地址
    上海 cn-shanghai cloudgame.cn-shanghai.aliyuncs.com
  • Action:要执行的操作,如调用ListGames查询游戏列表。
  • Version:要使用的API版本,云游戏的API版本是2020-04-29
  • Parameters:请求参数,每个参数之间用“&”分隔。

    请求参数由公共请求参数和API自定义参数组成。公共参数中包含API版本号、身份验证等信息,详情请参见 。

下面是一个调用ListGames接口查询游戏列表的示例:
说明 为了便于用户查看,本文档中的示例都做了格式化处理。
https://cloudgame.cn-shanghai.aliyuncs.com/?Action=ListGames
&Format=xml
&Version=2020-04-29
&Signature=xxxx%xxxx%3D
&SignatureMethod=HMAC-SHA1
&SignatureNonce=15215528852396
&SignatureVersion=1.0
&AccessKeyId=key-test
&TimeStamp=2012-06-01T12:00:00Z
…