NEXTARC

APIドキュメント

NextArc公開APIの使い方とコード例です。curl・Roblox (Luau)・JavaScript の例をタブで切り替えられます。

ベースURLと認証

公開APIはすべて Bearer 認証のJSON APIです。

ベースURL:  https://nextarc.online
ヘッダー:    Authorization: Bearer <APIキー全文>
  • APIキーは Developer Portal の「APIキー」ページで、プロジェクト × 環境（development / staging / production）ごとに発行します。
  • キーは na_ で始まり、全文は発行時に一度だけ表示されます（サーバー側にはハッシュのみ保存）。
  • キー自体がスコープを兼ねます。そのキーのプロジェクト・環境のデータにしか読み書きできません。
  • APIキーはRobloxのサーバースクリプトからのみ使ってください。クライアントに渡したりソース管理へコミットしないでください。

レスポンス形式

成功時は ok: true と結果、失敗時は ok: false と message を返します。

// 成功
{ "ok": true, "playerData": { ... } }

// 失敗（HTTPステータスも変わります）
{ "ok": false, "message": "APIキーが無効です" }

動作確認（1分）

発行したキーで、まず疎通を確認します。

export NEXTARC_API_KEY="na_...."

curl -i -H "Authorization: Bearer $NEXTARC_API_KEY" https://nextarc.online/api/v1/ui-config

200が返ればキーは有効です（UI設定が未保存でも version: 0 の空設定が返ります）。401ならキーの誤り・無効化を確認してください。

Developer Portalへ移動 →