Hivee 運営管理画面

用途別の手順

大会の結果を取り込む

ランキングサイトなどで、コミュニティの大会の順位を集計する流れです。

  1. GET /communities/{handle}/events でイベントの一覧を取ります。progress が ended のものが終わったイベントです
  2. GET /events/{id} で、そのイベントのプログラム(大会の単位)を取ります。format が null のプログラムは順位を持ちません
  3. GET /programs/{id}/standings で順位を取ります
  4. GET /events/{id}/entrants で出場者を取り、順位の participant_id と出場者の id をつなげます

出場者の startgg_user_id には、本人が OAuth で連携した start.gg のユーザー ID が入ります。これがある人は start.gg のアカウントと確実に紐付けられます。連携していない人とゲストは display_name だけです。

配信のスコアボードに試合を出す

  1. 主催者から受け取った Hivee のイベント URL を GET /resolve?url=... に渡し、イベント ID を得ます
  2. GET /events/{id}/stream-queue で配信中の試合と次の試合を、GET /events/{id}/stations で台ごとの進行中の試合を取ります
  3. 選手名・スコア・キャラ・ラウンド名は試合の slots と round_label にあります。1 試合だけ取り直すときは GET /matches/{id} を使います
  4. 数秒おきに If-None-Match を付けて取り直し、304 のあいだは表示を変えません

シードを計算する

GET /events/{id}/entrants で出場者と start.gg の連携を取り、外部のレーティングと突き合わせてシードを計算できます。計算したシードを Hivee に書き込む API はまだありません。結果は主催者が Hivee の画面で入力します。

用途別の手順 | Hivee 開発者向け