すべてのガイド

アカウント・連携API

アカウントキーと連携トークン

名前付きキーはパネルのアカウントサービスでAuthorization: Bearerを使います。GET /panel-api/accountは連携を検証します。GET /panel-api/server-keyは互換性検証用で、サーバーを登録・監視しません。/v1/api/auth/tokenのemail/apiToken交換は別の連携フローで、SSHログインではありません。

GET /panel-api/account
Authorization: Bearer <ACCOUNT_API_KEY>

POST /v1/api/auth/token
Content-Type: application/json
{"email":"user@example.com","apiToken":"<INTEGRATION_API_TOKEN>"}

GET /v1/api/tokens
Authorization: Bearer <INTEGRATION_ACCESS_TOKEN>

利用可能な連携リソース

/v1/apiは認証、wallet参照、トークン残高・履歴・パック、checkout、IAP検証を提供します。各APIが要求する認証情報を使ってください。サーバー、SSHキー、カテゴリ、タグのCRUDは顧客APIから除かれています。支払い操作は金銭状態を変更するため接続テストに使わないでください。

  • GET /v1/api/wallet
  • GET /v1/api/wallet/ledger
  • GET /v1/api/tokens
  • GET /v1/api/tokens/ledger
  • GET /v1/api/tokens/packs
  • POST /v1/api/tokens/checkout
  • POST /v1/api/tokens/iap/verify

安全性とエラー

不明なパネルURLや第三者へキーを送らないでください。401では認証情報、403では権限を確認し、429では待って再試行します。エラー本文を確認し、非冪等な支払いを自動再試行しないでください。キー管理にはポータルセッションと安全確認が必要です。