撮影ジョブの一覧を取得する

撮影の画面で作った撮影ジョブを返します。API から実行できるのは allowApiTrigger が true のジョブだけです。スコープは capture が要ります。

GET/capture/jobs

Authorization

AuthorizationBearer token · headerrequired

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

Query parameters

deviceIdstring

このカメラのジョブだけに絞る

Responses

200

撮影ジョブの一覧

jobsCaptureJob[]required

Show properties

Array of CaptureJob

idstringrequired

edgePcIdstringrequired

deviceIdstringrequired

撮るカメラ

namestringrequired

enabledbooleanrequired

allowApiTriggerbooleanrequired

API から実行できるか

scheduleModestringrequired

定期実行の方法（none は定期実行しない）

Allowed:noneintervaltimescron

createdAtstring<date-time>required

updatedAtstring<date-time>required

400

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

errorstringrequired

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

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

Parameters

deviceIdqueryこのカメラのジョブだけに絞る

Request

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

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

import requests

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

Response

{
  "jobs": [
    {
      "id": "string",
      "edgePcId": "string",
      "deviceId": "string",
      "name": "string",
      "enabled": true,
      "allowApiTrigger": true,
      "scheduleMode": "none",
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z"
    }
  ]
}

{
  "error": "string"
}

{
  "error": "Unauthorized"
}

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