全部产品
云市场

查询图片

更新时间:2018-07-11 16:39:24

描述

本接口用于查询实例中图片信息,需要在 Url 参数中传入 instanceName 参数,表示要查询的实例,其它参数拼接成系统指定的格式串,然后通过 Body 进行传输。

请求路径

/item/search

请求参数

URL中参数

名称 类型 是否必须 描述
instanceName String 查询实例名称。

Body中参数

名称 类型 是否必须 描述
cat_id String 类目 Id。
n int 返回结果的数目。
s int 返回结果的起始位置。
crop boolean 是否需要进行主体识别,默认为true。
region String 图片的主体区域,格式为 x1,x2,y1,y2, 其中 x1,y1 是左上角的点,x2,y2是右下角的点,默认自动识别主体区域。
pic_list List 搜索的图片名称,只能指定1个。
pic_map Map 搜索图片对应的内容。

Body构造方法

Body 的格式参考 新增图片 接口中 Body 的格式部分。

返回参数

名称 类型 描述
Success Boolean 请求是否成功。
RequestId String 请求 Id。
Code int 错误码,0 表示成功,非 0 表示失败。
Message String 错误信息。
Head Map 结果描述信息。
DocsReturn int 返回结果数目。
DocsFound int 实例中命中结果数目。
PicInfo Map 抠图相关信息。
Category String 图片所属的类目。
Region String 主体区域,分别表示 x1,x2,y1,y2 其中 x1,y1 是左上角的点,x2,y2是右下角的点。
AllCategory Map 系统支持的所有类目信息。
Name String 类目名称。
Id String 类目 Id。
Auctions Map 表示所有返回的商品描述信息。
CustContent String 表示商品自定义的信息。
PicName String 图片名称。
CatId String 图片类目。
ProductId String 商品 Id。
SortExprValues String 系统打分信息。

返回格式

  1. {
  2. "Auctions": {
  3. "Auction": [{
  4. "CustContent": "k1:v1,k2:v2,k3:v3",
  5. "PicName": "girl_cloth3.jpg",
  6. "CatId": "0",
  7. "SortExprValues": "7.33136443711219e+24;0",
  8. "ProductId": "1002"
  9. }]
  10. },
  11. "Head": {
  12. "DocsReturn": 1,
  13. "DocsFound": 57,
  14. "SearchTime": 124
  15. },
  16. "PicInfo": {
  17. "Category": "0",
  18. "Region": "51,339,91,392",
  19. "AllCategory": {
  20. "Category": [{
  21. "Name": "Tops",
  22. "Id": "0"
  23. }, {
  24. "Name": "Dress",
  25. "Id": "1"
  26. }, {
  27. "Name": "Bottoms",
  28. "Id": "2"
  29. }, {
  30. "Name": "Bag",
  31. "Id": "3"
  32. }, {
  33. "Name": "Shoes",
  34. "Id": "4"
  35. }, {
  36. "Name": "Accessories",
  37. "Id": "5"
  38. }, {
  39. "Name": "Snack",
  40. "Id": "6"
  41. }, {
  42. "Name": "Makeup",
  43. "Id": "7"
  44. }, {
  45. "Name": "Bottle",
  46. "Id": "8"
  47. }, {
  48. "Name": "Furniture",
  49. "Id": "9"
  50. }, {
  51. "Name": "Toy",
  52. "Id": "20"
  53. }, {
  54. "Name": "Underwear",
  55. "Id": "21"
  56. }, {
  57. "Name": "Digital device",
  58. "Id": "22"
  59. }, {
  60. "Name": "Other",
  61. "Id": "88888888"
  62. }]
  63. }
  64. },
  65. "Message": "success",
  66. "RequestId": "183A7C57-20B9-4AE6-8227-1EE8B0A4B99B",
  67. "Success": true,
  68. "Code": 0
  69. }

示例

假定某个用户要搜索实例 goodssearch 中类目为 0 下的某一个商品。图片内容为 pic_content1,图片名称可任意指定,本例为 searchPic,返回结果的起始位置为 0,返回结果的数目为 10。最终请求方式如下:

  1. URL: /item/search?instaneName=goodssearch
  2. POST Body:
  3. s,0,1#cat_id,1,2#pic_list,2,14#c2VhcmNoUGlj,14,30#n,30,32^00c2VhcmNoUGljcGljX2NvbnRlbnQx10
  4. 说明:其中 c2VhcmNoUGlj 表示 searchPic 进行 base64 编码后的值