開発者向け

どんな時に便利？

自分のデータだけにアクセスしたい場合に使います。個人的な自動化に最適です — Home Assistantに記録を取り込んだり、個人ダッシュボードに統計を表示したり、スプレッドシートで進捗を追跡したり、カスタム通知スクリプトを作成したりできます。

---

プロフィール設定からトークンを生成し、Authorizationヘッダーで使用してください：

curl -H "Authorization: Token msp_pat_YOUR_TOKEN_HERE" \
  https://myspeedpuzzling.com/api/v1/me

PATはすべての/api/v1/me/*エンドポイントへのフルアクセスを提供します。スコープは不要です。他のプレイヤーのデータにはアクセスできません。

どんな時に便利？

ユーザーがMySpeedPuzzlingアカウントでサインインするアプリを開発する場合に使います。あなたのアプリはユーザーに代わってデータにアクセスできます — あなたのウェブサイトに記録を表示したり、大会ツールからタイムを追加させたり、カスタムインターフェースからコレクションを管理したりできます。

---

ステップ1： ユーザーをアプリの認可ページにリダイレクトします：

https://myspeedpuzzling.com/oauth2/authorize?
  client_id=YOUR_CLIENT_ID
  &response_type=code
  &redirect_uri=https://your-app.com/callback
  &scope=profile:read results:read
  &state=RANDOM_STATE

ステップ2： 認可コードをトークンに交換します：

curl -X POST https://myspeedpuzzling.com/oauth2/token \
  -d "grant_type=authorization_code" \
  -d "code=AUTH_CODE_FROM_REDIRECT" \
  -d "redirect_uri=https://your-app.com/callback" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET"

ステップ3： Access tokenを使用します：

curl -H "Authorization: Bearer ACCESS_TOKEN" \
  https://myspeedpuzzling.com/api/v1/me/results

ステップ4： Access tokenの有効期限が切れたら、refresh tokenで新しいトークンを取得します：

curl -X POST https://myspeedpuzzling.com/oauth2/token \
  -d "grant_type=refresh_token" \
  -d "refresh_token=REFRESH_TOKEN" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET"

Access tokenの有効期限は1時間です。Refresh tokenは1ヶ月間有効です。