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と完全一致が必要です。
同じサークル限定をONにしたクライアントは、認可コード発行とトークン交換時にログインユーザーがクライアント所属サークルのメンバーか確認します。
Authorization Code
GET https://id.arito.group/oauth/authorize?response_type=code&client_id=CLIENT_ID&redirect_uri=REDIRECT_URI&scope=link:read&state=STATE&code_challenge=CODE_CHALLENGE&code_challenge_method=S256POST https://id.arito.group/oauth/token
grant_type=authorization_code
code=CODE
redirect_uri=REDIRECT_URI
client_id=CLIENT_ID
client_secret=CLIENT_SECRET
code_verifier=CODE_VERIFIERClient Credentials
POST https://id.arito.group/oauth/token
grant_type=client_credentials
client_id=CLIENT_ID
client_secret=CLIENT_SECRET
scope=link:read link:writeLinktion API (外部API v1)
リンク / 分析Authorization: Bearer <token> を利用。必要スコープに応じて利用可。
スコープ: link:read / link:write / analytics:read / team:read / project:read
JWT は iss / aud / exp / sub と teams 配列が必要です。project_id 付きリンクは teams[].projects に対象IDを含めます。
セッション 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",
"project_id": "PROJECT_ID",
"tags": ["campaign"],
"note": "LiveOps"
}例: 分析取得
GET https://linktion.arito.group/api/v1/links/LINK_ID/analytics?from=YYYY-MM-DD&to=YYYY-MM-DD
Authorization: Bearer ACCESS_TOKENfrom / to は ISO日時または YYYY-MM-DD。CSVはProサークルのみ利用でき、ANALYTICS_CSV_EXPORT_LIMIT 件まで出力します。
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 を指定