デバイスの名前・メモ・機器情報・管理項目を変更する

指定した項目だけを変更します。項目を 1 つ以上指定してください。note と機器情報（manufacturer・model・serialNumber・macAddress）は、空文字を送ると消します。映像ソースなどの設定はダッシュボードで変更してください。スコープは data:write が要ります。

PATCH/devices/{id}

Authorization

AuthorizationBearer token · headerrequired

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

Path parameters

idstringrequired

デバイス ID（<エッジPC の Thing 名>__<UUID>）

Request body

requiredapplication/json

namestring

デバイス名

min length 1

notestring

メモ。全体を置き換える

max length 2000

manufacturerstring

実機のメーカー

max length 100

modelstring

実機の型番

max length 100

serialNumberstring

実機のシリアル番号

max length 100

macAddressstring

控える MAC アドレス。区切りは : - どちらでも受け付け、小文字のコロン区切りにそろえて保存します

attributesobject

管理項目の値。キーは項目の ID（管理項目の一覧で取得）で、送った項目だけを変更します。null を送るとその項目の値を消します。日付は YYYY-MM-DD、選択肢の項目は定義した値のどれかを送ります

Responses

200

成功

okbooleanrequired

400

入力の検証エラー、または対象の種類が合わない

errorstringrequired

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

401

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

errorstringrequired

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

403

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

errorstringrequired

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

404

対象が無い（他の組織のものを含む）

errorstringrequired

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

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer tokenRemember on this deviceInclude my values in samples

Parameters

idpath*デバイス ID（`<エッジPC の Thing 名>__<UUID>`）

Bodyapplication/json

Request body

Request

curl -X PATCH 'https://api.thingsconnect.app/api/v1/devices/string' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "正門カメラ"
}'

const response = await fetch("https://api.thingsconnect.app/api/v1/devices/string", {
  method: "PATCH",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"name\": \"正門カメラ\"\n}"
});

import requests

response = requests.patch(
    "https://api.thingsconnect.app/api/v1/devices/string",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"name\": \"正門カメラ\"\n}",
)

Response

{
  "ok": true
}

{
  "error": "string"
}

{
  "error": "Unauthorized"
}

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

{
  "error": "string"
}