アカウント概要
OAuth (id.arito)
認可 / トークン第三者サービス向けのログイン/トークン発行。Authorization Code / Client Credentials に対応。
認可URL GET /oauth/authorize
トークン POST /oauth/token
UserInfo GET /oauth/userinfo
JWKS GET /.well-known/jwks.json
redirect_uri は登録済みURLと完全一致が必要です。
Authorization Code
GET https://id.arito.group/oauth/authorize?response_type=code&client_id=CLIENT_ID&redirect_uri=REDIRECT_URI&scope=link:read
POST https://id.arito.group/oauth/token
grant_type=authorization_code
code=CODE
redirect_uri=REDIRECT_URI
client_id=CLIENT_ID
client_secret=CLIENT_SECRET
Client Credentials
POST https://id.arito.group/oauth/token
grant_type=client_credentials
client_id=CLIENT_ID
client_secret=CLIENT_SECRET
scope=link:read link:write
Linktion API (外部API v1)
リンク / 分析Authorization: Bearer <token> を利用。必要スコープに応じて利用可。
セッション GET /api/v1/session
チーム一覧 GET /api/v1/teams
プロジェクト一覧 GET /api/v1/projects?team_id=...
リンク一覧 GET /api/v1/links
リンク作成 POST /api/v1/links
リンク詳細 GET /api/v1/links/:id
リンク更新 PATCH /api/v1/links/:id
リンク削除 DELETE /api/v1/links/:id
一括削除 POST /api/v1/links/bulk-delete
移動 POST /api/v1/links/move
分析 GET /api/v1/links/:id/analytics
分析CSV GET /api/v1/links/:id/analytics.csv
例: リンク作成
POST https://linktion.arito.group/api/v1/links
Authorization: Bearer ACCESS_TOKEN
{
"url": "https://example.com",
"team_id": "TEAM_ID"
}
LiveOps告知リンク
ゲーム内お知らせ・イベント告知を短縮URLで配布し、成果を分析。
- POST /api/v1/links で告知リンク作成
- GET /api/v1/links/:id/analytics でクリック分析
- 終了後に DELETE /api/v1/links/:id
端末/地域別のストア誘導
iOS/Androidや地域別にストアURLを出し分け。
- POST /api/v1/links に routing_rules を付けて作成
- 必要に応じて PATCH /api/v1/links/:id で更新
ゲーム内リンク管理
運営パネルからリンクの作成・一覧・更新を一元管理。
- GET /api/v1/links で一覧表示
- PATCH /api/v1/links/:id で差し替え
- POST /api/v1/links/bulk-delete で一括終了
チーム/プロジェクト別運用
タイトル別にチーム/プロジェクトを分けて権限管理。
- GET /api/v1/teams でチーム一覧取得
- GET /api/v1/projects?team_id=... でプロジェクト取得
- POST /api/v1/links で team_id / project_id を指定