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

请求结构

基因分析平台的的API是RPC风格,您可以通过发送HTTP GET请求调用基因分析平台API。其请求结构如下:
http://Endpoint/?Action=xx&Parameters
其中:
  • Endpoint: 基因分析平台的API的服务接入地址为easygene.[regionId].aliyuncs.com
    说明 不同产品使用地域,服务接入地址不同。如北京地域的工作空间,API的服务接入地址为 easygene.cn-beijing.aliyuncs.com
  • Action:要执行的操作,如调用ListWorkspace查询已创建的工作空间。
  • Version:要使用的API版本,负载均衡的API版本是2021-03-15
  • Parameters:请求参数,每个参数之间用“&”分隔。

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

下面是一个调用ListWorkspace接口查询已创建的工作空间的示例:
说明 为了便于用户查看,本文档中的示例都做了格式化处理。
http(s)://easygene.cn-beijing.aliyuncs.com/?Action=ListWorkspaces
&Name=TestName
&OrderBy=createtime
&IsReversed=true
&NextToken=TestToken
&MaxResults=5
&LabelSelector=env=test
&公共请求参数