API contract（signage-admin-ui 視点）¶

ベース URL¶

/api/user/devices はベース URL を使用しない

UserContext は /api/user/devices を相対パスで呼ぶため、 API を別ドメインに置く場合は同一オリジン化またはプロキシが必要。\ TODO: 配置形態を確認（参照: signage-admin-ui/src/context/UserContext.tsx）

GET /api/user/devices?userExternalId=...&deviceId=...
起動時にデバイス/顧客の選択情報を取得
レスポンス例（UI が参照する主な項目）
- selectedDeviceId / selectedCustomerId
- devices: [{ deviceId, label?, customerId? }]
- customers: [{ customerId, name }]
- isMasterAdmin
参照: signage-admin-ui/src/context/UserContext.tsx

GET /api/content/media?customerId=...&userExternalId=...&limit=...&offset=...
DELETE /api/content/media/:mediaId?customerId=...&userExternalId=...
409 の場合は「プレイリストで使用中」扱い
PATCH /api/content/media/:mediaId
Body: { customerId, userExternalId, title }
POST /api/content/media/upload-url
Body: { customerId, userExternalId, fileName, mimeType, mediaType, title, sizeBytes, durationSec?, createdByUserId }
POST /api/content/media/complete-upload
Body: { mediaId, sizeBytes, customerId, userExternalId }

GET /api/content/playlists?customerId=...&userExternalId=...&limit=...&offset=...
POST /api/content/playlists
Body: { customerId, userExternalId, name, description?, isActive, userName? }
PATCH /api/content/playlists/:id
Body: { customerId, userExternalId, name, description }
DELETE /api/content/playlists/:id?customerId=...&userExternalId=...
GET /api/content/playlists/:id/items?customerId=...&userExternalId=...
PUT /api/content/playlists/:id/items
Body: { customerId, userExternalId, items: [{ mediaId, sortOrder, durationSec? }] }
POST /api/content/playlists/:id/items
Body: { customerId, userExternalId, mediaId, durationSec? }
DELETE /api/content/playlists/:playlistId/items/:playlistItemId?customerId=...&userExternalId=...

GET /api/devices/:deviceId/playlist-assignment?customerId=...&userExternalId=...
GET /api/devices/:deviceId/sync-status?customerId=...&userExternalId=...
POST /api/devices/:deviceId/sync-complete
Body: { customerId, userExternalId, playlistId }
POST /api/commands/sync-content
Body: { deviceId, customerId, userExternalId }