English
イベント（管理者用）

ラベル画像・媒体を固定したジョブを準備（管理者用）

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

ラベル画像・媒体を固定したジョブを準備。

認証要ログイン

パスパラメータ

eventIdstring必須

イベント ID。

リクエストボディ

printerIdstring必須

登録プリンター ID。

entryIdstring任意

参加登録 ID。省略は管理者の直接テスト印刷のみ。

locale"ja" | "en"任意

表示言語。既定 ja

previewHashstring任意

プレビューAPIのハッシュ。内容・用紙が変わった場合は409 LABEL_PREVIEW_CHANGEDとなり、ジョブを作成しません。

requestKeystring必須

冪等性キー。同じ入力で再利用し、明示的な再印刷は新しいキーにする。

delivery"DIRECT" | "STATION"必須

直接印刷または共用ステーション

補足

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

レスポンス

LabelPrintJob を返します。

リクエスト
curl https://api.4s.link/manage/events/EVENT_ID/label-print/jobs \
  -X POST \
  -H "Authorization: Bearer 4s_at_..." \
  -H "Content-Type: application/json" \
  -d '{
  "printerId": "printer-1",
  "entryId": "entry-1",
  "locale": "ja",
  "requestKey": "unique-request-key",
  "delivery": "DIRECT"
}'
レスポンス例
{
  "id": "job-1",
  "printerId": "printer-1",
  "entryId": "entry-1",
  "state": "PREPARED",
  "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"
}