edit-icon download-icon

画像の検索(旧)

最終更新日: May 24, 2019

説明

この操作は、指定された Image Search インスタンスに対して POST リクエストを送信し、画像を検索します。この操作を呼び出すには、instanceName パラメーターを設定してインスタンスを指定し、関連するパラメーターで POST Body の内容を構成する必要があります。

リクエストパス

/item/search

リクエストパラメーター

URL パラメーター

名前 データタイプ 必須かどうか 説明
instanceName String はい 画像を検索するインスタンスの名前。

Body パラメーター

名前 データタイプ 必須かどうか 説明
cat_id String いいえ カテゴリー ID。
n int いいえ 返される検索結果の数。
s int いいえ 返される検索結果の、最初の結果位置。他の検索結果がこれに続きます。
pic_list List はい 検索する画像の名前。画像名は 1 つだけ指定できます。
pic_map Map はい 検索する画像名と、それに対応する内容。

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, y1) と右下座標 (x2, y2) で決まる矩形領域。
AllCategory Map システムでサポートされているカテゴリー。
Name String カテゴリー名。
Id String カテゴリー ID。
Auctions Map 返品されたプロダクトすべてに関する情報。
CustContent String カスタムプロダクト情報
PicName String 画像名。
CatId String 画像カテゴリー ID。
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 ボディ:
  3. s,0,1#cat_id,1,2#pic_list,2,14#c2VhcmNoUGlj,14,30#n,30,32^00c2VhcmNoUGljcGljX2NvbnRlbnQx10
  4. 注意: c2VhcmNoUGlj は画像名 searchPic を Base64 でエンコードされた値です。