AIからRORへアップロードする

完成済みの静的HTMLをAIや自動化ツールからRORへ公開する基本の流れです。

カテゴリー: はじめに

AIアップロードでできること

ROR APIは、完成済みの静的HTML一式をZIPで受け取り、検証後に共有URLを返します。公開処理は同期的に行われ、成功時にはすでに閲覧可能な pin.url がレスポンスに含まれます。

APIがソースコードのビルドや依存パッケージのインストールを行うことはありません。AIには、ブラウザでそのまま開ける成果物を作成させてください。

基本の流れ

  1. HTML、CSS、JavaScript、画像など、表示に必要なファイルを用意します。
  2. index.html が入口になるようにZIP化します。
  3. APIキーを実行環境の ROR_API_KEY に設定します。
  4. POST https://ror.jp/api/v1/pins へZIPを送信します。
  5. 成功レスポンスの 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キーを貼り付けないでください。