日本熟妇hd丰满老熟妇,中文字幕一区二区三区在线不卡 ,亚洲成片在线观看,免费女同在线一区二区

調用API

調用API即應用調用生產環境中的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。