大会の結果を取り込む
ランキングサイトなどで、コミュニティの大会の順位を集計する流れです。
GET /communities/{handle}/eventsでイベントの一覧を取ります。progressがendedのものが終わったイベントですGET /events/{id}で、そのイベントのプログラム(大会の単位)を取ります。formatが null のプログラムは順位を持ちませんGET /programs/{id}/standingsで順位を取りますGET /events/{id}/entrantsで出場者を取り、順位のparticipant_idと出場者のidをつなげます
出場者の startgg_user_id には、本人が OAuth で連携した start.gg のユーザー ID が入ります。これがある人は start.gg のアカウントと確実に紐付けられます。連携していない人とゲストは display_name だけです。
配信のスコアボードに試合を出す
- 主催者から受け取った Hivee のイベント URL を
GET /resolve?url=...に渡し、イベント ID を得ます GET /events/{id}/stream-queueで配信中の試合と次の試合を、GET /events/{id}/stationsで台ごとの進行中の試合を取ります- 選手名・スコア・キャラ・ラウンド名は試合の
slotsとround_labelにあります。1 試合だけ取り直すときはGET /matches/{id}を使います - 数秒おきに
If-None-Matchを付けて取り直し、304のあいだは表示を変えません
シードを計算する
GET /events/{id}/entrants で出場者と start.gg の連携を取り、外部のレーティングと突き合わせてシードを計算できます。計算したシードを Hivee に書き込む API はまだありません。結果は主催者が Hivee の画面で入力します。