카운트다운 - 플러그인

이런 때 써요

이벤트 시작 전에는 시작까지 남은 시간을, 진행 중에는 남은 시간과 진행 막대를 보여 주고, 끝나면 내려요.

외부 서버가 유챗 API로 값을 보내면 이 플러그인이 그려요. 플러그인을 켜고, 관리 페이지 API 메뉴에서 키를 발급받아 서버에 넣으면 돼요.

보내는 법

POST https://api.uchat.io/v2/rooms/{API 채팅방 아이디}/events에 Authorization: Bearer {API 키} 헤더와 JSON 본문을 보내요. plugin은 countdown이에요.

curl -X POST https://api.uchat.io/v2/rooms/room_xxxxxxxxxxxxxxxx/events \
  -H "Authorization: Bearer uchat_..." \
  -H "Content-Type: application/json" \
  -d '{"plugin":"countdown","save":true,"data":["주말 이벤트","1792400400","1792402200"]}'

data 칸 순서: 제목, 시작 시각, 끝 시각(unix 초, UTC)
남은 시간이 아니라 시각을 저장하므로 다시 보낼 필요가 없어요. 중간에 들어온 사람도 그 순간에 맞는 남은 시간부터 봐요. 연장하려면 끝 시각만 바꿔 다시 저장해요.
"save": true로 보내면 마지막 값으로 저장돼서 나중에 들어온 사람도 입장할 때 받아요. 내리려면 "data":[]를 저장해요.
서버 API로 온 값만 그리고, 값은 글자로만 보여요.