Quagga API概要

Quagga APIでできること

Quagga APIは、イベントの問題・回答・成績を、外部のプログラムからJSON形式で取得するための機能です。 出題画面でしか見られない集計結果やランキングを取り込めるため、独自の順位表示など、参加者への演出に使えます。

取得できる情報は次のとおりです。

直前に集計した問題の集計結果を取得する

直前に集計した問題の概要と回答一覧を取得することができます。

暫定の総合成績を取得する

リクエスト時点での総合成績を取得することができます。

そのほかに取得できる情報

各APIの詳細はQuagga APIリファレンスを参照してください。

利用できる人

対象イベントの管理者のみが利用できます。 管理者ではないアカウントのアクセストークンを使うと、401 エラーになります。

使い始めるまでの流れ

  1. プロフィールを開き、「アクセストークン」に記載されている文字列を控えます。
  2. 取得したいイベントのイベントIDを確認します。回答画面または管理画面のURL（https://quagga.studio/programs/1/quiz の 1 の部分）がイベントIDです。
  3. 次のようにリクエストを送ります。<アクセストークン> は手順1の文字列に置き換えてください。
curl -H "Authorization: Bearer <アクセストークン>" https://quagga.studio/api/v1/programs/1/result/total

このリクエストは、イベントID 1 の暫定総合成績を取得します。 成功すると、順位・獲得ポイント・参加者名などがJSON形式で返ります。

利用するときの注意

関連する記事