送信開始・完了報告・取消・現物確認（管理者用）

POST/manage/events/:eventId/label-print/jobs/:jobId/transition

送信開始・完了報告・取消・現物確認。

認証	要ログイン

パスパラメータ

eventIdstring必須

イベント ID。

jobIdstring必須

ジョブ ID。

リクエストボディ

action"start" | "result" | "cancel" | "resolve"必須

実行する操作

claimTokenstring任意

claim で返るトークン。start/result に必須。

state"COMPLETED" | "FAILED" | "UNKNOWN"任意

result/resolve で使用。resolve は COMPLETED/FAILED のみ

errorCodestring任意

機密情報を含まないエラーコード

補足

イベント所属と participantsWrite または speakersWrite が必要。プリンター登録と参加登録を指定しないテスト印刷は eventWrite も必要。HTTP 成功や送信成功は物理印刷完了を意味しません。結果不明は自動再送せず、現物を確認してください。画像・QR・claimToken をログに記録しないでください。

start/result は取得者と claimToken を照合。UNKNOWN の解除は現物確認後の resolve で行う。cancel は未実行の PREPARED/QUEUED のみ。

レスポンス

LabelPrintJob を返します。

リクエスト

curl https://api.4s.link/manage/events/EVENT_ID/label-print/jobs/JOB_ID/transition \
  -X POST \
  -H "Authorization: Bearer 4s_at_..." \
  -H "Content-Type: application/json" \
  -d '{
  "action": "result",
  "claimToken": "example-token",
  "state": "COMPLETED"
}'

レスポンス例

{
  "id": "job-1",
  "printerId": "printer-1",
  "entryId": "entry-1",
  "state": "COMPLETED",
  "delivery": "DIRECT",
  "media": "CONTINUOUS_62",
  "lengthMm": 60,
  "widthPx": 696,
  "heightPx": 639,
  "errorCode": null,
  "createdAt": "2026-09-18T00:00:00Z",
  "expiresAt": "2026-09-18T00:02:00Z"
}