今すぐ始める

開発者ツール:APIトークン、REST API、CLI、「エラーを解説」。

適切な権限範囲のAPIトークンを作成し、REST APIやrivervoコマンドラインでスクリプトやCIからアプリを操作できます。失敗したデプロイはAIが解説します。

1 分で読めます

パネルでアプリに対して行う操作は、すべてスクリプトでも実行できます。CIからのデプロイ、スクリプトからの変数設定、ターミナルでのログ確認などです。

APIトークン

アカウント設定 → APIトークン → トークンを作成。名前(使用場所。例:「GitHub Actions」)を付け、許可する操作を選びます。

権限範囲許可される操作
読み取りのみアプリ、デプロイとそのログ、実行時ログ、ドメイン
読み取りとデプロイ読み取りに加え、デプロイ、ロールバック、再起動
フルアクセスデプロイに加え、変数(読み取りと変更)とドメイン(追加と削除)
フルアクセスとターミナルフルアクセスに加え、ウェブサイトでのコマンド実行、ファイル、Cronジョブ、SSHキー、Gitからのデプロイ

有効期限も設定できます。30日、90日、365日後、または無期限から選べます。

  • トークンは一度だけ表示されます。すぐにコピーしてください。
  • トークンはご自身の権限で動作します。他のユーザーのアカウントでは、そのアプリでのご自身のロールで動作し、さらにトークンの権限範囲が適用されます。詳しくはアプリへのアクセスをご覧ください。
  • トークンは最大20個まで保持できます。無効化するとトークンはすぐに使えなくなります。
  • トークンを作成できるのはご本人のみです。代理でアカウントにログインしている人は作成できません。

REST API

APIはOpenAPI 3.1で文書化されています:api.rivervo.com/api/v1/openapi.json。Postman、Insomnia、コードジェネレーターにインポートできます。

ベースアドレスはhttps://api.rivervo.com/api/v1です。トークンはBearerトークンとして送信します。

curl -H "Authorization: Bearer $RIVERVO_TOKEN" https://api.rivervo.com/api/v1/apps

できること:

メソッドとパス内容権限範囲
GET /appsアプリとそのサービスの一覧読み取り
GET /apps/{id}1つのアプリ読み取り
GET /apps/{id}/deploymentsアプリのデプロイ読み取り
POST /apps/{id}/deploymentsデプロイ:最新のコミットをビルド、または{"rebuild": false}で稼働中のバージョンを再デプロイデプロイ
GET /apps/{id}/deployments/{deployment}デプロイとそのビルドログ読み取り
POST /apps/{id}/deployments/{deployment}/rollbackそのバージョンに戻すデプロイ
POST /apps/{id}/restart再起動デプロイ
GET /apps/{id}/logsサイト、ワーカー、スケジュールの実行時ログ読み取り
GET, PUT, PATCH /apps/{id}/env変数の読み取り、置き換え、更新フル
GET /apps/{id}/domainsドメイン読み取り
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name}ドメインの追加または削除フル
  • 他のユーザーのアカウント: アクセス権を付与されたアカウントのアプリを操作するには、ヘッダーX-Account: <the account's customer ID>を追加します。
  • 制限: 1人あたり1分間に120リクエスト、そのうち変更は30回まで。超えるとAPIはRetry-After付きで429を返します。
  • 言語: メッセージは初期設定では英語です。アゼルバイジャン語またはロシア語にするにはAccept-Language: azまたはruを送信します。
  • APIで変更した変数は、パネルと同じく次回のデプロイでアプリに反映されます。{"rebuild": false}で十分です。

rivervoコマンドライン

同じAPIトークンを使い、ターミナルからデプロイ、ログ、変数、ロールバックを操作できます。Node.js 22以降が必要です。

npm install -g rivervo
rivervo login                       # トークンを貼り付け
rivervo deploy shop                 # 最新のコミットをビルドしてデプロイを追跡
rivervo logs shop -f                # アプリの出力を追跡
rivervo env set shop API_URL=https://example.com
rivervo rollback shop               # 以前のバージョンに戻す

CIではRIVERVO_TOKEN変数からトークンを読み込みます。新しいバージョンが公開されなかった場合、deployはエラーで終了するため、パイプラインの判定に使えます。公開されるまでは、REST APIで同じことができます。

「エラーを解説」

デプロイが完了しなかったり、サービスが停止したりすると、ログの横にエラーを解説が表示されます。ログの最後の数行を読み取り、ご利用の言語で次の内容をお伝えします。

  • 考えられる原因:何が問題だったか
  • 解決方法:ご利用のスタックに合わせた具体的な手順

解説はログをもとにAIが作成します。変更を加える前にご確認ください。送信の前に、変数のすべての値と、キー、パスワード、トークンらしきものはログから隠されます。コードや変数そのものが送信されることはありません。

新しい解説は1人1日10件まで依頼できます。同じログに対してすでに作成された解説は、無料で再表示されます。

Rivervo MCP

Rivervo MCPを使えば、AIアシスタントからもアプリを操作できます。Claude、ChatGPT、Cursor、VS CodeなどMCPに対応したアプリで利用でき、会話の中でデプロイ、ログ、エラーについて質問したり、アシスタントにデプロイやロールバックを任せたりできます。トークンは不要で、Rivervoアカウントでログインします。詳しくはRivervo MCPをご覧ください。

解決しませんか?

チャットでご相談ください。AIがすぐに回答し、必要なときはエンジニアが加わります。時間帯は問いません。

サポートに問い合わせる