REST APIエンドポイントに指定のFormデータをPOSTすると分類結果のJSONを応答します。入力画像一枚につき1回APIをリクエストする必要があります。 処理に成功するとHTTPstatus200のステータスコードと共にJSONが応答されます。

・エンドポイント

・ボディ

リクエストボディは Content-Type: multipart/form-data 形式でリクエストを送信します。

• ・image
    分類する画像ファイルです。対応しているフォーマットはJPEG、png、bmp、gif、tiffです。

• ・targetRegions
    darkposeで利用するROI情報です。
    設定例
  

  {
   "targetRegions":[
    {
      "xMin": 149.88,
      "yMin": 218.10,
      "xMax": 219.28,
      "yMax": 411.9
    }
  ]
}


• ・threshold
    darkposeで利用するヒートマップの閾値です。
   (0 <= threshold < 1) 
    未指定時はモデルファイルの設定値を用います。

• ・サンプル

  ------WebKitFormBoundaryhwZz6hhFHARN6wAB
Content-Disposition: form-data; name="modelName"
"sample"
------WebKitFormBoundaryhwZz6hhFHARN6wAB--
Content-Disposition: form-data; name="image";filename="sample.png"
Content-Type: image/png
画像データ(binary)
------WebKitFormBoundaryhwZz6hhFHARN6wAB

・ボディ

• ・jobId
    画像分類の処理IDです。

• ・status
    処理成功の場合、successを返却します。

• ・candidates
    分類結果のcandidates objectをスコアの高い順にソートして配列で設定します。
    candidates object

  JSONキー	値	必須
  tag	文字列	○
  id	文字列	○
  keyPoints	object配列	○

• ・tag
    分類した画像のタグです。

• ・id
    分類した画像のidです

• ・keyPoints
    分類した画像の関節に関する情報です。

• ・Key Points object
  

    

  JSONキー	値
  name	文字列
  x	実数
  y	実数
  score	実数

  • ・name
      keyPoint の名前が表示されます。たとえば、nose などと表示されます。
      なお、 name ではなく各keyPointの名前がそのままjsonキーとなりますのでご注意ください。
      KeyPointは、 nose, neck, shoulderRight , elbowRight , wristRight , shoulderLeft , elbowLeft , wristLeft , hipRight , kneeRight , ankleRight , hipLeft , kneeLeft , ankleLeft , eyeRight , eyeLeft , earRight , earLeft となります。
  • ・x
      keyPoint の X 座標が表示されます。
    
  • ・y
      keyPoint の Y 座標が表示されます。
    
  • ・score
      keyPointに対する適合度です。
    
 

• ・サンプル

  {
  "jobId":"abcde",
  "status": "success",
  "candidates":[
   {
     "tag":"people",,
     "id":"0001",
     "keyPoints":{
          "nose": {
              "x": 322,
              "y": 533,
              "score": 0.6548669934272766,
            },
           :
           （略）
           :
          "earLeft": {
              "x": 289,
              "y": 550,
              "score": 0.4321119332372344,
          }
       }
   },
   {
     "tag":"people",
     "id":0002,
     "keyPoints":{
          "nose": {
              "x": 620,
              "y": 520,
              "score": 0.5442992933252732,
          }
           :
           （略）
           :
          "earLeft": {
              "x": 580,
              "y": 544,
              "score": 0.7299229933252511,
          }
       }
   }
]
}