POST /api/branding

이미 실행 중인 실시간 현황의 브랜드를 바꿔요.

브랜드는 start에서 정하고, 나중에 이 호출로 바꿔요. 보낸 필드만 바뀌고, 빈 필드는 저장된 값을 유지해요. 휴대폰에는 아무것도 전송되지 않고 호출 요금도 청구되지 않아요. 앱은 다음에 실시간 현황을 불러올 때 새 브랜드를 보여 줘요.

실시간 현황 id로

curl -X POST https://api.webliveactivity.com/api/branding \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: wla_your_key' \
  -d '{
  "activityId": "act-8f2cqa4mx7rd",
  "widgetContainerId": "acme-orders",
  "brand": {
    "title": "Order #1234 (updated)",
    "name": "Acme v2",
    "description": "Now with faster delivery"
  }
}'

그룹으로

curl -X POST https://api.webliveactivity.com/api/branding \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: wla_your_key' \
  -d '{
  "group": "order-tracker",
  "widgetContainerId": "acme-orders",
  "brand": {
    "logo": "https://acme.example/seasonal-logo.png",
    "color": "#E8372C"
  }
}'

컨테이너로

widgetContainerId 값만 보내면(activityId나 group 없이) 컨테이너의 모든 실시간 현황 브랜드가 바뀌어요.

curl -X POST https://api.webliveactivity.com/api/branding \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: wla_your_key' \
  -d '{
  "widgetContainerId": "acme-orders",
  "brand": {
    "logo": "https://acme.example/logo-v2.png",
    "color": "#06C167"
  }
}'

응답

{ ok, targeted, unknown } 형태로 반환해요. 브랜드가 바뀐 실시간 현황 수와 찾지 못한 id가 담겨요.

{
  "ok": true,
  "targeted": 12,
  "unknown": []
}

예시

전체 브랜드 업데이트

모든 브랜드 필드를 한 번의 호출로.

curl -X POST https://api.webliveactivity.com/api/branding \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: wla_your_key' \
  -d '{
  "widgetContainerId": "acme-orders",
  "brand": {
    "title": "Acme Fresh Order",
    "name": "Acme Fresh",
    "logo": "https://fresh.acme.example/logo.png",
    "description": "Fresh groceries, delivered fast",
    "color": "#2ECC71"
  }
}'

이미 화면에 있는 카드의 브랜드 이름은 카드가 재시작될 때만 바뀌어요. 카드 색상을 바꾸려면 update로 state.accentColorHex 값을 보내세요.