本文介紹查看圖片數據列表ListImages的語法及示例。

功能描述

查看圖片數據列表能力可以查看指定數據庫中的圖片數據列表。

說明 阿里云視覺智能開放平臺視覺AI能力API接入、接口使用或問題咨詢等，請通過釘釘群（23109592）加入阿里云視覺智能開放平臺咨詢群聯系我們。

服務說明

視覺搜索服務將于2023年2月15日起停止更新，后續不再支持新用戶開通接入服務，新用戶請使用新版圖像搜索。2023年2月15日之后，會繼續支持老用戶，老用戶如果對視覺搜索服務使用有疑問，可通過搜索釘釘群（23109592）加入阿里云視覺智能開放平臺咨詢群聯系我們。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數

名稱 類型 是否必選 示例值 描述
Action String 是 ListImages

系統規定參數。取值：ListImages。
DbName String 是 default

數據庫名稱。
Token String 否 2

Offset和Limit組合的分頁方式只支持前2000條記錄。當超過2000條時，需要使用上一次請求返回的Token作為請求下一頁的參數。
Offset Integer 否 1

起始記錄。
Limit Integer 否 50

每頁最多顯示的條數。
Order String 否 asc

排列方式。包括升序（asc）和降序（desc）。
EntityIdPrefix String 否 U1

樣本ID前綴。

返回數據

名稱 類型 示例值 描述
RequestId String 2B93C43A-F824-40C8-AF79-844342B0F43A

請求ID。
Data Object

返回的結果數據內容。
ImageList Array of ImageList

返回的圖片數據列表。
EntityId String 5

實體ID或分組ID。
CreatedAt Long 1582838489213

創建數據的時間。
UpdatedAt Long 1582838489213

更新數據的時間。
DataId String 001

數據ID。
ExtraData String 元素

自定義數據內容。
Token String 2

Offset和Limit組合的分頁方式只支持前2000條記錄。

當超過2000時，需要使用上一次請求返回的Token作為請求下一頁的參數。
TotalCount Integer 100

總數量。

SDK參考

阿里云視覺AI能力推薦使用SDK調用，支持多種編程語言，文件參數通過SDK調用可支持本地文件及任意URL，具體可參見SDK總覽。

示例

請求示例

http(s)://imgsearch.cn-shanghai.aliyuncs.com/?Action=ListImages     //更多關于訪問域名（Endpoint）信息，請參見：http://bestwisewords.com/document_detail/143103.html
&DbName=default
&Token=2
&Offset=1
&Limit=50
&Order=asc
&EntityIdPrefix=U1
&公共請求參數

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<RequestId>2B93C43A-F824-40C8-AF79-844342B0F43A</RequestId>
<Data>
    <Token>2</Token>
    <TotalCount>100</TotalCount>
    <ImageList>
        <DataId>22</DataId>
        <ExtraData>元素</ExtraData>
        <EntityId>5</EntityId>
        <UpdatedAt>1582838489213</UpdatedAt>
        <CreatedAt>1582838489213</CreatedAt>
    </ImageList>
</Data>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "2B93C43A-F824-40C8-AF79-844342B0F43A",
  "Data" : {
    "Token" : "2",
    "TotalCount" : "100",
    "ImageList" : [ {
      "DataId" : "22",
      "ExtraData" : "元素",
      "EntityId" : "5",
      "UpdatedAt" : 1582838489213,
      "CreatedAt" : 1582838489213
    } ]
  }
}

錯誤碼

關于查看圖片數據列表的錯誤碼，詳情請參見常見錯誤碼。

安全聲明

  • 請確保上傳的圖片或文件來源符合相應的法律法規。
  • 通過體驗調試上傳的臨時文件有效期為1小時，在24小時后會被系統自動清理刪除。