调用API

调用API即应用调用生产环境中的API。在为企业建立API生态场景中,您需要调用API进行二次开发或开放API给合作伙伴等,帮助企业实现数据的资产化和价值化。本文为您介绍如何调用API。

前提条件

步骤一:查询并申请API

  1. 在Dataphin首页,在顶部菜单栏选择服务 > 市场

  2. 单击左侧导航栏的API服务,在API服务页面的API列表中,单击目标文档说明列下的API文档,进入API文档页面。

  3. API文档页面,查看基本信息排序设置(仅服务单元API-向导模式支持)、业务请求参数列表公共请求参数列表返回参数列表JSON返回示例,是否符合您的业务场景。

  4. 确认当前API符合您业务场景的后,单击申请状态列下的立即申请

  5. API权限申请页面,申请API的权限。具体操作,请参见申请API权限

    说明

    需申请该API的所属应用权限才能使用该API。

步骤二:调试API

  1. 完成API权限申请后,您可以在已授权API服务页面查看到该API。随后,您可以进行调试该API是否可以正常使用。您可以根据如下路径进入API调试页面。

    单击顶部菜单栏调用 > 选择服务项目 > 单击左侧导航栏已授权API服务 > 单击目标API的image图标。

  2. API调试页面,配置调试输入值。调试参数配置与测试API是否一致,详情请参见步骤一:测试API

    在API调试页面的顶部可以查看域名,该域名仅用于内部测试,实际调用域名,请参见查看域名

步骤三:下载文档

您可以下载API文档分享给其他开发人员,提高使用灵活性。支持下载Word格式的文档,便于修改;也可以下载为OpenAPI规范的YAML文档,用于百炼大模型的插件注册。

下载OpenAPI YAML文件

  1. 在Dataphin首页,单击顶部菜单栏的服务 > 市场

  2. 单击左侧导航栏的API服务,选中目标API单击文档说明列下的API文档

  3. API文档页面,单击右上角的下载OpenAPI YAML文件

    image

  4. 下载OpenAPI YAML文件对话框中,配置参数。

    参数

    描述

    格式

    支持百炼大模型平台OpenAPI规范2种格式下载文件。

    operationID

    接口操作ID,用于接口操作的唯一标识。仅支持输入英文、下划线(_),不超过200个字符。

    summary

    接口描述。支持输入不超过200个字符。

    代码预览

    设置完成后,即可实时预览代码(JSON格式)。代码中各参数释义请参见OpenAPI 规范

    openapi: 3.0.1
    info:
      title: sq_test_mysql
      description: ""
      version: V1.4
    servers:
    - url: http://528fdcdcc62d4f4eb8f10ad99cdda9f3-cn-shanghai.alicloudapi.com
    paths:
      /list/10172:
        post:
          summary: ""
          operationId: ""
          parameters:
          - name: appKey
            in: query
            description: 访问API所绑定的应用Key
            required: true
            schema:
              type: string
              example: "2000001"
          - name: env
            in: query
            description: API所在的环境
            required: true
            schema:
              type: string
              example: "prod:生产环境, pre:预发环境"
          requestBody:
            content:
              application/json:
                schema:
                  required:
                  - returnFields
                  type: object
                  properties:
                    useModelCache:
                      type: boolean
                      description: "是否开启SQL翻译缓存, 有利于查询性能提升"
                      default: false
                    pageStart:
                      type: integer
                      description: 分页查询的第几条开始
                      format: int32
                    pageSize:
                      type: integer
                      description: 分页查询返回条数
                      format: int32
                    returnFields:
                      type: array
                      items:
                        type: string
                        example: "[id, name, sexo]"
                    conditions:
                      required:
                      - sex
                      type: object
                      properties:
                        namee:
                          type: string
                          example: null
                        sex:
                          type: string
                          example: null
                        idd:
                          type: string
                          example: null
                      description: 入参条件
                    useResultCache:
                      type: boolean
                      description: "是否开启API查询结果的缓存, 有利于查询性能提升"
                      default: false
                    orderBys:
                      type: array
                      description: 排序字段
                      items:
                        type: object
                        properties:
                          field:
                            type: string
                            description: 排序类型,枚举值(注意大写),只有ASC或者DESC
                          order:
                            type: string
                            description: 排序类型,枚举值(注意大写),只有ASC或者DESC
                            example: ASC或者DESC
            required: true
    
  5. 配置完成后,单击下载,将文件下载至本地。

下载API文档

  1. 在Dataphin首页,单击顶部菜单栏的服务 > 市场

  2. 单击左侧导航栏的API服务,单击目标API文档说明列下的API文档

  3. API文档页面,单击右上角的下载API文档,下载单个API文档;您也可以在API服务页面,选中多个API,单击底部的下载API文档,批量下载API文档。

    image

    说明
    • 下载的API文档中会根据该API生成具体的调用示例,方便您使用;您也可以根据API调用模板配置调用示例。

    • 支持将API文档下载至本地,格式为Word。

    • API文档包括文档目录、文档版本、API调用示例、接口列表(按接口维度,每个接口内容包括基本信息、排序设置(仅服务单元API-向导模式支持)、业务请求参数列表、公共请求参数列表、返回参数列表、JSON返回示例以及该API调用的具体示例)。

API调用模板

  1. 单击顶部菜单栏的管理,再单击左侧导航栏的调用示例

  2. API调用示例页面,查看API调用示例的模板。

    您也可以单击默认调用示例下载,下载API调用示例。

    如果需要通过Python方式调用API,则单击python调用示例下载,下载Python示例文件压缩包。

    如果需要通过Java SDK方式调用API,则单击Java SDK下载,下载Java SDK代码包。

    image

  3. 根据调用示例说明,进行调用API。

API返回条数

完成调用API后,即可查询数据。对于不同的服务类型和数据源支持查询条数如下表所示。

数据源类型

单次最大返回条数

查询总条数限制

是否支持分页查询

单物理表服务单元

MySQL

10000

无上限

支持

AnalyticDB for MySQL2.0

支持

ElasticSearch

支持

Microsoft SQL Server

不支持

PostgreSQL

支持

AnalyticDB for MySQL3.0

支持

AnalyticDB for PostgreSQL

支持

Hologres

支持

Hbase(0.9.4/1.1.x/1.2.1/2.x)

10000

10000

支持

Oracle

支持

MongoDB

支持

多物理表服务单元

MySQL

10000

无上限

支持

AnalyticDB for MySQL2.0

支持

ElasticSearch

支持

Microsoft SQL Server

不支持

PostgreSQL

支持

AnalyticDB for MySQL3.0

支持

AnalyticDB for PostgreSQL

支持

Hologres

支持

Hbase(0.9.4/1.1.x/1.2.1/2.x)

10000

10000

支持

Oracle

支持

MongoDB

支持

直连数据源API

Impala

10000

无上限

支持

Oracle

支持

MySQL

支持

PostgreSQL

支持

Microsoft SQL Server

支持

Hologres

支持

Lindorm

支持

ClickHouse

支持

StarRocks

支持

TDengine

不支持

SAP HANA

不支持

SelectDB

支持

Hbase(0.9.4/1.1.x/1.2.1/2.x)

1

无上限

不支持

ElasticSearch

10000

10000

支持

逻辑表API

不涉及

10000

10000

支持

Dataphin数据源

Dataphin数据源

10000

无上限

支持

在通过SDK调用API时,如需查询第9000~10000条数据,则公共请求参数PageStart配置为9000,PageSize配置为1000。