エッジPC の一覧を取得する

組織のエッジPC を登録した順に返します。state は直近の通信から判定した接続状態で、90 秒以上通信が無ければ offline、一度も通信していなければ unknown です。スコープは data か data:write が要ります。

GET/edge-pcs

Authorization

AuthorizationBearer token · headerrequired

組織設定の「API・MCP」タブで発行した API トークン（tcn_ で始まる）。

Responses

200

エッジPC の一覧

edgePcsEdgePc[]required

Show properties

Array of EdgePc

idstringrequired

namestringrequired

notestring | nullrequired

メモ

attributesobjectrequired

管理項目の値。キーは項目の ID で、未入力の項目は含みません

statestringrequired

接続状態

Allowed:onlineofflineunknown

lastSeenAtstring<date-time> | nullrequired

最後に通信した時刻

versionstring | nullrequired

エッジPC で動いているソフトウェアの版

createdAtstring<date-time>required

401

トークンが無い、または無効

errorstringrequired

人が読めるエラーメッセージ

403

スコープが足りない、または操作が許可されていない

errorstringrequired

人が読めるエラーメッセージ

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer tokenRemember on this deviceInclude my values in samples

Request

curl -X GET 'https://api.thingsconnect.app/api/v1/edge-pcs' \
  -H 'Authorization: Bearer YOUR_TOKEN'

const response = await fetch("https://api.thingsconnect.app/api/v1/edge-pcs", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.get(
    "https://api.thingsconnect.app/api/v1/edge-pcs",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response

{
  "edgePcs": [
    {
      "id": "string",
      "name": "string",
      "note": "string",
      "attributes": {},
      "state": "online",
      "lastSeenAt": "2019-08-24T14:15:22Z",
      "version": "string",
      "createdAt": "2019-08-24T14:15:22Z"
    }
  ]
}

{
  "error": "Unauthorized"
}

{
  "error": "data スコープが必要です"
}