AIからRORへアップロードする
完成済みの静的HTMLをAIや自動化ツールからRORへ公開する基本の流れです。
カテゴリー: はじめに
AIアップロードでできること
ROR APIは、完成済みの静的HTML一式をZIPで受け取り、検証後に共有URLを返します。公開処理は同期的に行われ、成功時にはすでに閲覧可能な pin.url がレスポンスに含まれます。
APIがソースコードのビルドや依存パッケージのインストールを行うことはありません。AIには、ブラウザでそのまま開ける成果物を作成させてください。
基本の流れ
- HTML、CSS、JavaScript、画像など、表示に必要なファイルを用意します。
index.htmlが入口になるようにZIP化します。- APIキーを実行環境の
ROR_API_KEYに設定します。 POST https://ror.jp/api/v1/pinsへZIPを送信します。- 成功レスポンスの
pin.urlを共有します。
新しいロールは公開完了から7日後が初期期限です。ピン留めとピン留め解除は管理画面だけで操作できます。
AIへ渡す指示の例
AIへはAPIキーの値ではなく、環境変数名だけを伝えます。
このフォルダーの配布用成果物をRORへアップロードし、共有URLだけ返してください。
- ZIP直下に index.html が来るようにZIP化する
- .env、APIキー、秘密情報、個人情報をZIPへ含めない
- APIキーは環境変数 ROR_API_KEY から読み、Authorization Bearerヘッダーだけに使う
- https://ror.jp/api/v1/pins へmultipart/form-dataでPOSTする
- Idempotency-Keyには、この公開用に新しく生成したUUIDを使う
- APIキーの値を出力しない
AIとの会話、生成ログ、成果物、コミットへAPIキーを貼り付けないでください。