CheckImageExists
接口说明
使用说明
本接口用于根据图片查询图像搜索实例中的图片信息。
QPS 限制
查询操作默认的最大访问频率可在控制台中查看，为您购买时所选择的访问频次（QPS），当前支持 1QPS、5QPS、10QPS。
SDK 版本说明
图像 SDK 版本升级到 V3.1.1，可使用“多主体识别”、“相似性分数”功能。请参见Java SDK。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
imagesearch:CheckImageExists |
get |
*全部资源
|
无 | 无 |
请求语法
POST HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| InstanceName |
string |
是 |
图搜实例名称。最多支持 20 个字符。 如果已经购买图搜实例可登录图像搜索管控台查看。 如果没有购买图搜实例可参考开通服务和创建实例。 说明
这里的实例名称并非实例 ID，使用时请区分。 |
demoinstance1 |
| ProductId |
string |
是 |
商品 ID。 |
2092061_1 |
| PicName |
string |
是 |
图片名称。 |
2092061_1 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
结果返回。 |
||
| Msg |
string |
错误信息。 |
success |
| RequestId |
string |
请求 ID。 |
B3137727-7D6E-488C-BA21-0E034C38A879 |
| Auctions |
object |
所有返回的商品描述信息。 |
|
| ProductId |
string |
商品 ID。 |
2092061_1 |
| PicName |
string |
图片名称。 |
2092061_1.jpg |
| CategoryId |
integer |
图片类目。 |
88888888 |
| CustomContent |
string |
用户自定义的内容。 |
zidingyi |
| IntAttr |
integer |
整数类型属性。 |
2 |
| IntAttr2 |
integer |
整数类型属性。 |
2 |
| StrAttr |
string |
字符串类型属性。 |
test |
| StrAttr2 |
string |
字符串类型属性。 |
test |
| StrAttr3 |
string |
字符串类型属性。 |
test |
| StrAttr4 |
string |
字符串类型属性。 |
test |
| IntAttr3 |
integer |
整数类型属性。 |
2 |
| IntAttr4 |
integer |
整数类型属性。 |
2 |
| Code |
integer |
错误码。
|
0 |
| Success |
boolean |
请求是否成功。 |
true |
| Exists |
boolean |
图片是否存在。 |
true |
示例
正常返回示例
JSON格式
{
"Msg": "success",
"RequestId": "B3137727-7D6E-488C-BA21-0E034C38A879",
"Auctions": {
"ProductId": "2092061_1",
"PicName": "2092061_1.jpg",
"CategoryId": 88888888,
"CustomContent": "zidingyi",
"IntAttr": 2,
"IntAttr2": 2,
"StrAttr": "test",
"StrAttr2": "test",
"StrAttr3": "test",
"StrAttr4": "test",
"IntAttr3": 2,
"IntAttr4": 2
},
"Code": 0,
"Success": true,
"Exists": true
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | BadRequest | The request has invalid parameters. | 无效的参数 |
| 400 | InstanceStatusError | Your instance is unavailable. | |
| 400 | TimeoutForTransferImage | Timeout after 5 seconds waiting for images transfer to complete. | |
| 400 | InvalidInstance | The specified instance name is invalid. | 实例名错误 |
| 400 | NoCaretSeperator | The body content is missing the ^ separator. | 请求body缺少特定符号 |
| 400 | EmptyMeta | The body content has an empty meta field. | 请求body含有空的字段 |
| 400 | InvalidMetaItem | The meta field is invalid. | 无效的元信息字段 |
| 400 | NoPicList | The body content is missing the pic_list parameter. | 未指定pic_list字段 |
| 400 | InvalidPicList | The specified pic_list parameter is invalid. | 无效的pic_list字段 |
| 400 | NoSpecifiedPic | he content of an image is not specified in the HTTP POST body. | |
| 400 | NoSpecifiedSearchPic | The search image is not specified. | |
| 400 | InvalidCategory | The specified category is invalid. | 无效的类目id |
| 400 | OverflowMaxResultNum | The specified number of total results exceeds the maximum of 500. | 超过了最大的返回结果限制数500 |
| 400 | OverflowMaxReturnNum | The specified number of results for each request exceeds the maximum of 100. | 单次返回数超过限制值100 |
| 400 | InvalidStartParameter | The specified parameter start is inavlid. | |
| 400 | InvalidNumParameter | The specified parameter num is invalid. | 无效的字段num |
| 400 | NoSpecifiedAddPic | The image to insert is not specified. | |
| 400 | NoSpecifiedItemId | The item_id parameter is not specified. | |
| 400 | InvalidIntAttr | The specified int_attr field is invalid. | 无效的int过滤字段 |
| 400 | UnsupportedPicFormat | The specified image format is invalid. | 无效的图片格式 |
| 400 | InvalidFilterClause | The specified filtering condition is invalid. | 无效的过滤条件 |
| 400 | InstanceOverQuota | The number of items exceeds the limit. | 实例的图片数量超过限制值 |
| 400 | IncorrectOrientation | The image contains incorrect rotation flags in the meta data. | 图片包含不支持的旋转参数 |
| 400 | UnsupportedPicPixels | The specified pixels is not supported. | 图片像素值不支持 |
| 400 | SearchTimeout | The request is timed out. | |
| 400 | PicNotExist | The search picture does not exist. | |
| 400 | NoSpecifiedProductId | The parameter ProductId no specified. | |
| 400 | NoSpecifiedPicName | The parameter PicName no specified. | |
| 400 | NoSpecifiedPicContent | The parameter PicContent no specified. | |
| 400 | InvalidType | The specified parameter Type is not valid. | |
| 400 | InvalidProductId | The specified parameter ProductId is not valid. | |
| 400 | InvalidPicName | The specified parameter PicName is not valid. | |
| 400 | InvalidStrAttr | The specified parameter StrAttr is not valid. | 无效StrAttr |
| 400 | InvalidCustomContent | The specified parameter CustomContent is not valid. | |
| 400 | InvalidPicContent | The specified parameter PicContent length greater than 2 * 1024 * 1024. | |
| 400 | InvalidStrAttr4 | The specified parameter StrAttr4 is not valid. | 无效StrAttr4 |
| 400 | InvalidStrAttr3 | The specified parameter StrAttr3 is not valid. | 无效StrAttr3 |
| 400 | InvalidStrAttr2 | The specified parameter StrAttr2 is not valid. | 无效StrAttr2 |
| 400 | InvalidIntAttr4 | The specified parameter IntAttr4 is not valid. | 无效IntAttr4 |
| 400 | InvalidIntAttr3 | The specified parameter IntAttr3 is not valid. | 无效IntAttr3 |
| 400 | InvalidIntAttr2 | The specified parameter IntAttr2 is not valid. | 无效IntAttr2 |
| 400 | UnsupportedOperationType | The specified action is not supported. | 内部错误：不支持的action |
| 400 | UnsupportedInstanceType | The instance type is not supported. | 内部错误：不支持的实例类型 |
| 500 | InternalError | An internal server error occurred. | |
| 500 | NetworkException | A network error occurred. | 内部错误：请求网络异常 |
| 500 | RequestTimeout | The request is timeout. | |
| 500 | ExtractFeatureTimeout | The request was timed out while extracting features. | |
| 500 | AccessEngineFailed | An error occurred while accessing the search engine. | |
| 500 | InternalOssError | An internal OAS error occurred. | 内部错误：请求内部算法错误 |
| 500 | InternalSwiftError | An internal SWIFT error occurred. | 内部错误：请求内部消息队列错误 |
| 500 | InternalTableStoreError | An internal Table Store error occurred. | 内部错误：请求特征存储错误 |
| 403 | NoPermission | You are not authorized to perform this operation. | 未授权的行为 |
| 403 | DeniedRequest | Your request was denied due to instance flow control. | 请求被限流 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。
该文章对您有帮助吗？