Skip to main content

ガチャの取得

ガチャ情報を取得する方法。設定によってチェックインが必要な場合についても紹介します。

ガチャ一覧の取得

ガチャ情報の取得​

ガチャの取得方法は主に二種類存在します。詳しくはAPI 仕様をご覧ください

  • ユーザプール ID を指定した取得
  • ユーザの認証情報に基づいた取得

ユーザプール ID を指定して取得する​

すでに公開されているガチャ一覧を取得したい場合はこちらをご利用ください。管理画面より、発見方法のプロバイダ名とプロバイダ ID の値がユーザプール ID となります。ユーザプール ID は${認証プロバイダ}:${プロバイダ内でのプールID}という形式で表されます。 限定公開 状態のガチャを取得することはできません。

以下の例ではprovider_infoにfirebase:web-rollという値が入っており、FirebaseAuth の OIDC トークンを元にweb-rollというプロジェクト ID のユーザプールを対象したガチャ一覧を取得しています。

curl --request GET \
  --url 'https://devapi.3barc.space/api/v1/gachas/?provider_info=firebase%3Aweb-roll' \
  --header 'Accept: application/json'

ユーザの認証情報に基づいた取得​

この方法ではユーザの認証が必要です。

ユーザが認証情報を持っている場合、認証情報に基づいてガチャを取得することができます。認証トークンを Bearer トークンとしてリクエストヘッダに設定することで、ユーザがアクセス可能なガチャ一覧を取得できます。

curl --request GET \
  --url https://devapi.3barc.space/api/v1/gachas/ \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer ${認証トークン}'