物理プリンターの排他取得（管理者用）

POST/manage/events/:eventId/label-print/printers/:printerId/claim

物理プリンターの排他取得。

認証	要ログイン

パスパラメータ

eventIdstring必須

イベント ID。

printerIdstring必須

登録プリンター ID。

リクエストボディ

sessionIdstring必須

受信・取得セッションの識別子。

jobIdstring任意

ジョブ ID。

補足

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

共用受信は jobId を省略して1秒間隔で取得。直接印刷は作成者本人の jobId を指定。取得の有効期間は30秒。

レスポンス

フィールド	型	説明
`job`	ClaimedLabelPrintJob \| null	取得したジョブと claimToken。待機ジョブがなければ null

リクエスト

curl https://api.4s.link/manage/events/EVENT_ID/label-print/printers/PRINTER_ID/claim \
  -X POST \
  -H "Authorization: Bearer 4s_at_..." \
  -H "Content-Type: application/json" \
  -d '{
  "sessionId": "example",
  "jobId": "example"
}'

レスポンス例

{
  "job": {
    "id": "job-1",
    "printerId": "printer-1",
    "entryId": "entry-1",
    "state": "CLAIMED",
    "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",
    "claimToken": "example-token"
  }
}