QueryFaceUserBatch
更新時間:
調(diào)用該接口根據(jù)用戶ID列表批量獲取用戶信息。
使用說明
- 單個阿里云賬號調(diào)用該接口的每秒請求數(shù)(QPS)最大限制為100。說明 RAM用戶共享阿里云賬號配額。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數(shù)
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
Action | String | 是 | QueryFaceUserBatch | 系統(tǒng)規(guī)定參數(shù)。取值:QueryFaceUserBatch。 |
IsolationId | String | 是 | ZheJiangHZ | 業(yè)務(wù)隔離ID,用于隔離同一個阿里云賬號下不同業(yè)務(wù)應(yīng)用之間的數(shù)據(jù)。請與調(diào)用AddFaceUser接口添加用戶時設(shè)置的IsolationId保持一致。 |
UserIdList.N | RepeatList | 是 | ["xqymlby****4whye","6qyyb69zqara****","64nbfx8****hzmy4"] | 用戶ID列表。請傳入在調(diào)用AddFaceUser接口添加用戶后,獲取并保存到本地的用戶ID。 |
調(diào)用API時,除了本文介紹的該API的特有請求參數(shù),還需傳入公共請求參數(shù)。公共請求參數(shù)說明,請參見公共參數(shù)文檔。
返回數(shù)據(jù)
名稱 | 類型 | 示例值 | 描述 |
Code | String | 200 | 接口返回碼:
|
Data | Array of data | 調(diào)用成功時,返回的數(shù)據(jù)。 |
|
CreateTime | Long | 1636427314000 | 用戶創(chuàng)建人臉數(shù)據(jù)的13位時間戳,單位為毫秒。 |
CustomUserId | String | 1234567890 | 用戶身份識別ID。 |
FacePicList | Array of facePicList | 用戶的人臉圖片信息列表。 |
|
FaceMd5 | String | TestFaceMd5 | 用戶人臉圖片的MD5值。 |
FaceUrl | String | https://example.com/test.jpeg | 用戶的人臉圖片URL地址。 |
FeatureDTOList | Array of featureDTO | 人臉特征值列表。 |
|
AlgorithmName | String | TestAlgorithmName | 算法名。 |
AlgorithmProvider | String | TestAlgorithmProvider | 算法提供者。 |
AlgorithmVersion | String | TestAlgorithmVersion | 算法版本。 |
ErrorCode | String | 200 | 算法返回碼:
|
ErrorMessage | String | parameter error | 算法執(zhí)行出錯時,返回的錯誤信息。 |
FaceMd5 | String | TestFaceMd5 | 人臉特征的MD5值。 |
ModifyTime | Long | 1636436864000 | 用戶最后一次修改人臉數(shù)據(jù)的13位時間戳,單位為毫秒。 |
Name | String | Tony | 用戶名。 |
Params | String | {"key1":"value1", "key2":"value2"} | 自定義的用戶參數(shù)。 |
UserId | String | 3mtjaqebeq4d**** | 用戶ID。 |
ErrorMessage | String | face user not exist | 調(diào)用失敗時,返回的出錯信息。 |
RequestId | String | 0A13279A-5640-45E7-87AA-83750541AD0E | 阿里云為該請求生成的唯一標識符。 |
Success | Boolean | true | 是否調(diào)用成功:
|
示例
請求示例
http(s)://linkvisual.cn-shanghai.aliyuncs.com/?Action=QueryFaceUserBatch
&IsolationId=ZheJiangHZ
&UserIdList.1=["xqymlby****4whye","6qyyb69zqara****","64nbfx8****hzmy4"]
&<公共請求參數(shù)>
正常返回示例
XML
格式
<QueryFaceUserBatchResponse>
<RequestId>0A13279A-5640-45E7-87AA-83750541AD0E</RequestId>
<Data>
<ModifyTime>1636436864000</ModifyTime>
<UserId>3mtjaqebeq4d****</UserId>
<CreateTime>1636427314000</CreateTime>
<Params>{"key1":"value1", "key2":"value2"}</Params>
<CustomUserId>63f45472c2bf4cfa98b56****49238fa</CustomUserId>
<Name>Tony</Name>
<FacePicList>
<FaceMd5>TestFaceMd5</FaceMd5>
<FaceUrl>https://example.com/test.jpeg</FaceUrl>
<FeatureDTOList>
<AlgorithmVersion>TestAlgorithmVersion</AlgorithmVersion>
<ErrorCode>200</ErrorCode>
<AlgorithmProvider>TestAlgorithmProvider</AlgorithmProvider>
<FaceMd5>TestFaceMd5</FaceMd5>
<AlgorithmName>TestAlgorithmName</AlgorithmName>
</FeatureDTOList>
</FacePicList>
</Data>
<Code>200</Code>
<Success>true</Success>
</QueryFaceUserBatchResponse>
JSON
格式
{
"RequestId": "0A13279A-5640-45E7-87AA-83750541AD0E",
"Data": [
{
"ModifyTime": "1636436864000",
"UserId": "3mtjaqebeq4d****",
"CreateTime": "1636427314000",
"Params": "{\"key1\":\"value1\", \"key2\":\"value2\"}",
"CustomUserId": "63f45472c2bf4cfa98b56****49238fa",
"Name": "Tony",
"FacePicList": [
{
"FaceMd5": "TestFaceMd5",
"FaceUrl": "https://example.com/test.jpeg",
"FeatureDTOList": [
{
"AlgorithmVersion": "TestAlgorithmVersion",
"ErrorCode": "200",
"AlgorithmProvider": "TestAlgorithmProvider",
"FaceMd5": "TestFaceMd5",
"AlgorithmName": "TestAlgorithmName"
}
]
}
]
}
],
"Code": "200",
"Success": true
}
文檔內(nèi)容是否對您有幫助?