撮影ログを取得する

写真 1 枚ごとの撮影と送信の結果を新しい順に返します。続きは、応答の nextBefore を before に指定して取得します（nextBefore が null なら最後まで取得済み）。撮影ログは 30 日間残ります。スコープは capture が要ります。

GET/capture/deliveries

Authorization

AuthorizationBearer token · headerrequired

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

Query parameters

jobIdstring

この撮影ジョブの分だけに絞る

runIdstring

この実行の分だけに絞る

deviceIdstring

このカメラの分だけに絞る

statusstring

状態で絞る（状態の意味は CaptureDelivery の status）

Allowed:pendingsentfailedabandonedcaptured

triggerstring

撮影のきっかけ

Allowed:scheduleedgeapimanualevent

beforestring<date-time>

この時刻より前のものだけを返す（ISO 8601）

limitinteger

件数（1〜500。既定 100）

min 1 · max 500 · default: 100

Responses

200

撮影ログ

deliveriesCaptureDelivery[]required

Show properties

Array of CaptureDelivery

idstringrequired

jobIdstring | nullrequired

runIdstring | nullrequired

jobNamestringrequired

presetNamestring | nullrequired

viewNamestring | nullrequired

撮った向きの名前

deviceIdstringrequired

triggerstringrequired

Allowed:scheduleedgeapimanualevent

statusstringrequired

pending は送信待ち（再送中を含む）、sent は送信先が 2xx を返した、failed は撮影できなかった、abandoned は再送の上限に達した、captured は外部送信先へ送らないジョブで撮影できた

Allowed:pendingsentfailedabandonedcaptured

httpStatusinteger | nullrequired

外部送信先が返したステータス

attemptsintegerrequired

送信を試みた回数

errorstring | nullrequired

sizeBytesinteger | nullrequired

capturedAtstring<date-time> | nullrequired

finishedAtstring<date-time> | nullrequired

createdAtstring<date-time>required

nextBeforestring<date-time> | nullrequired

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

jobIdqueryこの撮影ジョブの分だけに絞るrunIdqueryこの実行の分だけに絞るdeviceIdqueryこのカメラの分だけに絞るstatusquery状態で絞る（状態の意味は `CaptureDelivery` の `status`）triggerquery撮影のきっかけbeforequeryこの時刻より前のものだけを返す（ISO 8601）limitquery件数（1〜500。既定 100）

Request

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

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

import requests

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

Response

{
  "deliveries": [
    {
      "id": "string",
      "jobId": "string",
      "runId": "string",
      "jobName": "string",
      "presetName": "string",
      "viewName": "string",
      "deviceId": "string",
      "trigger": "schedule",
      "status": "pending",
      "httpStatus": 0,
      "attempts": 0,
      "error": "string",
      "sizeBytes": 0,
      "capturedAt": "2019-08-24T14:15:22Z",
      "finishedAt": "2019-08-24T14:15:22Z",
      "createdAt": "2019-08-24T14:15:22Z"
    }
  ],
  "nextBefore": "2019-08-24T14:15:22Z"
}

{
  "error": "string"
}

{
  "error": "Unauthorized"
}

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