変更履歴

KernelHost API

セマンティックバージョニングを採用します。破壊的変更(フィールド名変更、エンドポイント削除、認証方式変更)は新 URL プレフィックス /v2/ の新メジャーバージョンでのみ発生します。/v1/ 内では追加的変更(任意の新フィールド、新エンドポイント)のみが行われます。

v1.4.0 (2026-11-09)

  • 新しいルート GET /v1/services/{id}/metrics(read:services 権限):1h、6h、24h、7d、14d の期間のサーバーメトリクスを取得できます。Edge Unlimited Traffic VPS は CPU、メモリ、ネットワーク、送信トラフィックの値を、通常の Unlimited Traffic VPS はエンドポイントリファレンスに記載のロケーションで送受信のネットワークの値を提供します。
  • 新しいルート GET /v1/services/{id}/ddos/attacks と GET /v1/services/{id}/ddos/attacks/{attack_id}(read:ddos 権限):Remote DDoS Protection の攻撃レポートを最大90日分取得でき、トラフィックの推移と、プロトコル、ポート、送信元、パケットサイズ別の内訳を確認できます。
  • プロファイルとルール(/ddos/profiles、/ddos/rules および書き込み操作):自分のアカウントのサービスであっても Advanced DDoS Protection サービスでない場合、HTTP 404 ではなく HTTP 409 not_supported_for_product が返されるようになりました。不明または他の所有者のサービス ID には引き続き HTTP 404 が返されます。

v1.3.1 (2026-11-02)

  • ドイツとフランスは個別に選択できます。「ドイツ(ヨーロッパ)」はドイツのフランクフルトのみ、「フランス(ヨーロッパ)」はフランスのみでの提供です。
  • 通常の Unlimited Traffic VPS では、ヨーロッパ、ドイツ、フランス、カナダ東部、英国、ポーランドの各ロケーションで提供までに最大7日かかる場合があります。多くの場合、48時間以内にサーバーをご利用いただけます。契約期間はサーバーのお受け取り後に始まります。

v1.3.0 (2026-11-02)

  • Advanced DDoS Protection:4つの新しいルートでプロファイルとルールの取得、ルールの追加、所有するルールの削除が可能になりました。read:ddos と write:ddos を明示的に有効にしてください。既存のキーに新しい権限は付与されません。
  • パネルと API で共有する制限、変更の直列実行、および POST と DELETE の Idempotency-Key 必須化により、大量のルール送信と並列リクエストから保護します。

v1.2.2 (2026-10-27)

  • POST /v1/orders:お支払い済みのサービスをすぐにプロビジョニングできない場合、そのサービスの ID は provisioning_failures(status partial)ではなく、awaiting_setup フィールド(status awaiting_setup)に表示されるようになりました。可能になりしだい自動的にプロビジョニングされ、その後 active に切り替わります。この場合は、再度注文しないでください。

v1.2.1 (2026-10-26)

  • Dedicated Unlimited Traffic VPN:ヨーロッパ、南北アメリカ、アジア、中東、アフリカ、オーストラリアに追加料金ありの新しいロケーションを追加しました。GET /v1/products/{id} は、これらを表示名と追加料金付きで一覧表示します。該当するロケーションが現在売り切れの場合、POST /v1/orders は HTTP 409 location_sold_out を返します。指定しない場合は、引き続き一覧の最初のロケーション(Europe)が適用されます。
  • Dedicated Unlimited Traffic VPN と Dedicated High Speed Unlimited Traffic VPN の構成オプション(ロケーションと OS)とそのサブオプションは、新しい ID になりました。ID は GET /v1/products/{id} から取得してください。古い ID を固定で指定すると HTTP 400 validation_failed になります。この変更の前から status が cancelled、terminated、fraud のいずれかだったこれらのプランのサービスについては、GET /v1/services/{id} は location として null を返します。High Speed VPN は今後、ロケーションオプション Europe、Germany or France、Canada East (Beauharnois)、France (Europe)、United Kingdom (Europe)、Poland (Europe) でのみ注文できます。
  • Edge Unlimited Traffic VPS:新しいロケーションを 6 か所追加しました(フランクフルト・アム・マイン、ロンドン、チェスター、パリ、ワルシャワ、ワシントンD.C.)。合計で最大 25 拠点です。新しいロケーションには独自の sub_option_id があり、既存ロケーションの ID は変わりません。一部のプランでは基本料金とロケーション追加料金の配分が変わりましたが、既存ロケーションの合計料金は変わりません。ID と料金は必ず GET /v1/products/{id} から取得してください。

v1.2.0 (2026-10-24)

  • ロケーションを選択できる製品(Edge Unlimited Traffic VPS)の POST /v1/orders:ロケーションオプションには既定値がないため、config_options で必ず送信してください。送信しない場合は HTTP 422(reason location_required)になります。売り切れのロケーションには HTTP 409 location_sold_out が返ります。新しい任意フィールド storage_gb で、合計ストレージを 20~300 GB の範囲で指定します。20 GB はプラン料金に含まれており、フィールドを省略した場合に適用されます。追加の 1 GB ごとに GET /v1/products/{id} に記載の料金がかかります。それ以外の値は HTTP 422 storage_out_of_range になります。
  • これらの製品では、注文結果に location と storage_gb(GB 単位の合計ストレージ)が含まれ、GET /v1/products/{id} は storage フィールドでストレージの範囲と追加 1 GB あたりの料金を示します。GET /v1/services と GET /v1/services/{id} はすべてのサービスについて location と storage_gb を返します(製品にその選択肢がない場合は null)。
  • GET /v1/products/{id} は、サブオプションを表示名のみで返すようになりました(例:「Finland (Europe)」)。その前にあった内部値は含まれません。POST /v1/orders は、現在売り切れの製品を HTTP 409 out_of_stock で拒否します。

v1.1.0 (2026-09-23)

  • POST /v1/orders:config_options はショップに表示されているオプションと値のみ、数量は上限と下限の範囲内のみ受け付けます。指定しなかった表示オプションには、ショップと同じく一覧の最初の値が設定されます。GET /v1/products/{id} は注文可能なオプションのみを表示し、quantity.min と quantity.max を返します。
  • KernelHost チームが手動でセットアップする製品向けに、新しい注文ステータス awaiting_setup とフィールド awaiting_setup を追加しました。自動プロビジョニングされるサービスは必ず一度だけプロビジョニングされます。
  • リクエストの body は 64 KB までに制限されます(HTTP 413)。アカウントごとに全キー合計で毎分 120 リクエストの上限があり、1 アカウントあたり最大 20 個の有効なキーを保持できます。認証失敗でキーがロックされることはなくなり、Idempotency-Key はメソッドとパスに紐付けられます。
  • 複数のクエリパラメータを含むリクエスト(例:GET /v1/services?limit=10&offset=0)が HTTP 401 で拒否されていました。現在、署名はドキュメントどおりにクエリ文字列を含めて検証されます。

v1.0.0 (2026-05-14)

  • 初回リリース。全 15 エンドポイント、HMAC 認証、AES-GCM シークレット保管、レート制限、冪等性、監査ログを含みます。
  • GET /v1/me, /v1/products, /v1/products/{id}
  • POST /v1/orders, GET /v1/orders/{id}
  • GET /v1/services, /v1/services/{id}, /v1/services/{id}/credentials
  • POST /v1/services/{id}/actions
  • GET /v1/billing/balance, /v1/billing/invoices, /v1/billing/invoices/{id}/pdf
  • GET/PUT /v1/webhooks
  • HMAC-SHA256 signing, AES-256-GCM secret storage, replay protection, idempotency.