• REST APIはベースURLの下にある：

/public/external/api

• すべてのリクエストはPOSTで送信されなければならない。
• REST APIはHTTPS経由のリクエストのみをサポートしています。
• リクエストには以下のヘッダーが含まれていなければならない：

• リクエスト・ボディは、以下の値を含むjsonエンコードされたオブジェクトでなければならない：

• 成功すると、APIは要求されたデータ（下記のクエリーを参照）とHTTPステータスコード200を返す。
• エラーが発生した場合、HTTPステータスコードはエラーに応じて4xxから5xxの間となり、レスポンスオブジェクトは、人間が読めるエラーメッセージのリストを含むキー “errors “を持つ配列を含む。
• デバイスにマッチするデータがない場合は、空の配列が返される。
• デバイスIDが存在しない場合、返されるデータはNULLとなる。