開発者ツール:APIトークン、REST API、CLI、「エラーを解説」。
適切な権限範囲のAPIトークンを作成し、REST APIやrivervoコマンドラインでスクリプトやCIからアプリを操作できます。失敗したデプロイはAIが解説します。
パネルでアプリに対して行う操作は、すべてスクリプトでも実行できます。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をご覧ください。