Armadillo Twin REST API 利用方法

API の利用設定を行う

API の利用設定を行うためには、「アカウント管理」権限が必要です。「ユーザーの権限を変更する」を参考に権限を設定してください。ユーザー権限を変更するメニューが表示されない場合は、管理ユーザーに確認して権限についてご相談ください。

Armadillo Twin REST API 有効化

Armadillo Twin REST API を利用する場合、以下の手順で有効化する必要があります。

  1. 画面右上のユーザー名をクリックします
  2. 「アカウント管理」をクリックします
  3. 「アカウント管理」画面にある「API設定」の「APIの利用を有効化する」にチェックを入れ、「保存」をクリックします
  1. 「API設定を有効にしますか？」の確認画面が開いたら、「上記に同意し、API設定を変更する。」のチェックボックスにチェックを入れ、「変更」ボタンをクリックします

API 利用方法

各 API の詳細は Armadillo Twin REST API リファレンスをご確認ください。

認可トークンを発行する

Armadillo Twin REST API を呼び出す場合、Login APIを呼び出し認可トークンを発行する必要があります。

$ curl -X POST -H "Content-Type: application/json" -d '{"username":"armadillo-twin@example.com","password":"Hfew_351"}' "https://api.armadillo-twin.com/login"

{"Authorization":"MzYxGDBmN2UtYTMxYi00MDcxLDz1N2ItNzVhNzEaYjI0ODBlLDE3NDk1MDEwNzF3ODA="}

Armadillo Twin REST API を呼び出す

取得した認可トークンをヘッダに指定し、以下のように Armadillo Twin REST API を呼び出します。

$ curl -X GET -H "Authorization":"MzYxGDBmN2UtYTMxYi00MDcxLDz1N2ItNzVhNzEaYjI0ODBlLDE3NDk1MDEwNzF3ODA=" "https://api.armadillo-twin.com/devices?pageSize=1"

{
  "Item":[
    {
      "deviceId":"00C901234567",
      "modelName":"Armadillo-IoT G4",
      "label":"Device001",
      "groupName":"Factory001",
      "connectionStatus":"ONLINE",
      "softwareVersions":[
        "base_os 3.21.3-at.13",
        "boot 2020.4-at.25"
      ],
      "plan":"BASIC",
      "deviceReady":true,
      "lastHeartbeat":"2025-06-05T17:09:08.000Z",
      "deviceRegistration":"2025-06-01T17:09:08.818Z"
    }
  ],
  "LastEvaluatedKey":"00C901234567"
}

ページネーション

各 API には、一度に取得できるデータの件数が定められています。件数を超えている場合、複数のページに分割してデータを返却します。
ページネーションが発生した場合、 API のレスポンスデータに次のページを取得する際に使用するデータ (LastEvaluatedKey)が含まれます。

$ curl -X GET -H "Authorization":"MzYxGDBmN2UtYTMxYi00MDcxLDz1N2ItNzVhNzEaYjI0ODBlLDE3NDk1MDEwNzF3ODA=" "https://api.armadillo-twin.com/devices?pageSize=1&lastEvaluatedKey=00C901234567"

{
  "Item":[
    {
      "deviceId":"00C901234568",
      "modelName":"Armadillo-IoT G4",
      "label":"Device002",
      "groupName":"Factory001",
      "connectionStatus":"ONLINE",
      "softwareVersions":[
        "base_os 3.21.3-at.13",
        "boot 2020.4-at.25"
      ],
      "plan":"LITE",
      "deviceReady":true,
      "lastHeartbeat":"2025-06-05T17:11:03.000Z",
      "deviceRegistration":"2025-06-01T17:09:13.214Z"
    }
  ],
  "LastEvaluatedKey":""
}

エラーメッセージ・ステータスコード

Armadillo Twin REST API でエラーが発生した際、エラーメッセージを返却します。各 API のエラーメッセージは Armadillo Twin REST API リファレンスをご確認ください。
なお、エラーのうち 400 Bad Request と 504 Gateway Timeout は Twin ポイントを消費します。