Hivee 運営管理画面

外部サービスとの連携

Hivee は start.gg と連携し、アカウントの紐付けと大会の順位の取り込みができます。外部のツールで Hivee と start.gg のデータを突き合わせるときの前提をまとめています。

start.gg: 出場者の ID

  • 出場者の startgg_user_id に入るのは、本人が Hivee の設定で start.gg と連携した(start.gg にログインして本人だと確かめた)ときだけです。自己申告の ID は使いません
  • 返すのは start.gg のユーザー ID だけです。start.gg のプロフィール(URL の slug・表示名)は返しません。必要なときは、利用者自身が start.gg の API でユーザー ID から取得してください
  • 本人が連携を解除すると、次の取得から null になります
  • 連携していない人とゲストは null です。display_name での突き合わせになります

start.gg: 取り込んだプログラム

主催者は、start.gg の大会の順位から Hivee のプログラム(決勝トーナメントなど)の出場者を取り込めます。

  • 取り込んだプログラムは entry_mode が startgg で、startgg_event_slug に取り込み元の start.gg のイベントが入ります
  • 取り込みのときに start.gg のユーザー ID で Hivee の参加者と照合します。照合できなかった出場者はゲストになり、本人があとで start.gg と連携すると本人の枠に切り替わります
  • 試合の結果は Hivee で報告します。start.gg には書き戻しません

start.gg: キャラ

試合の使用キャラは Hivee のキャラコードで返します。start.gg のキャラ ID との対応は「キャラコード」の表にあります。

start.gg: 出典と規約

次のデータは start.gg 由来です。

データ取得元
出場者の startgg_user_id本人の連携時に START.GG APIs から取得
start.gg から取り込んだプログラムの出場者(ゲストの display_name を含む)取り込み時に START.GG APIs から取得
startgg_event_slug取り込み元の start.gg イベントの識別子
キャラコード表の start.gg キャラ IDstart.gg のキャラ定義
  • これらのデータを表示・転載する場合は、出典として start.gg を明記してください(例: 「データ: start.gg」)
  • start.gg 由来データの利用には、START.GG APIs Terms of Use(https://www.start.gg/about/apitos)が適用されます。再配布・再販売の禁止を含む同規約の条件を遵守してください
  • start.gg は第三者が運営するサービスです。Hivee は start.gg の運営会社による提携・公認を受けたサービスではありません
外部サービスとの連携 | Hivee 開発者向け