视觉计算服务接口调用是向视觉计算服务API的服务端地址发送HTTP GET请求,并按照接口说明在请求中加入相应请求参数,调用后系统会返回处理结果。请求及返回结果都使用UTF-8字符集进行编码。

HTTP调用

视觉计算服务的API是RPC风格,您可以通过向服务端发送HTTP GET请求调用视觉计算服务API。在使用HTTP方式进行调用时,请求结构如下:

http://Endpoint/?Action=xx&Parameters
其中:
  • Endpoint:视觉计算服务API的服务接入地址为vcs.aliyuncs.com
  • Action:要执行的操作,如调用CreateComputeTask创建一个计算任务。
  • Version:要使用的API版本,视觉计算服务的API版本是2019-04-30
  • Parameters:请求参数,每个参数之间用“&”分隔。

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

    在使用HTTP方式调用API接口时,您需要进行签名计算以保证账号安全,详细说明请参见签名机制

下面是一个调用CreateComputeTask接口创建一个计算任务的请求示例:
说明 为了便于用户查看,本文档中的示例都做了格式化处理。
https://vcs.aliyuncs.com/?Action=CreateComputeTask
&Format=xml
&Version=2019-04-30
&Signature=xxxx%xxxx%3D
&SignatureMethod=HMAC-SHA1
&SignatureNonce=15215528852396
&SignatureVersion=1.0
&AccessKeyId=key-test
&TimeStamp=2012-06-01T12:00:00Z
…