IPFS Ninja

画像、PDF、JSON ファイルを簡単に IPFS にアップロードし、永続的なコンテンツ識別子 (CID) を取得して、ゲートウェイ経由で即座にアクセスできます。

IPFS とは？

InterPlanetary File System (IPFS) は、分散型のピアツーピアストレージプロトコルです。IPFS はファイルを小さなチャンクに分割し、ネットワーク全体に配布し、各ファイルの内容に基づいて一意のコンテンツ識別子 (CID) を割り当てます。

これは以下を意味します：

分散ストレージ — ファイルは複数のノードに保存され、信頼性が向上します。
コンテンツアドレッシング — CID はファイルの内容そのものから導出され、不変性が保証されます。
ネットワーク全体でのアクセス — CID を持つ人は誰でも、任意の IPFS ノードからファイルを取得できます。

IPFS Ninja でできること

IPFS Ninja は、シンプルな REST API を通じてファイルのアップロードと IPFS 上の既存コンテンツのピン留めを可能にするマネージドサービスです。独自の IPFS ノードを実行する必要はありません。

新しいファイルをアップロード — POST /upload/new で任意のファイルを送信し、永続的な CID を取得
既存の CID をピン留め — IPFS 上にすでにコンテンツがありますか？POST /pin でクラスターにピン留めし、継続的な利用を確保
ゲートウェイ経由でアクセス — すべてのピン留めされたコンテンツは ipfs.ninja/ipfs/<CID> でアクセス可能（apex ゲートウェイは、あなたのアカウントまたは他の IPFS Ninja アカウントの CID のみを配信します — 下記のゲートウェイアクセスを参照）
カスタムメタデータ — アップロードやピン留めにキーバリューペアを添付し、整理やフィルタリングに活用
署名付きアップロードトークン — API キーを公開せずにクライアントサイドアップロード用の期限付きトークンを生成
IPNS ミュータブルネーム — IPNS API を通じて、変化する CID を指す安定した名前を作成（アカウントごとに最大 10 個）
画像最適化 — ゲートウェイ URL パラメータを使用して、画像をオンザフライでリサイズ、変換、圧縮

ダッシュボード

個人ダッシュボードからアップロード、ストレージ、ゲートウェイ帯域幅を追跡できます。ダッシュボードでは、コードを書かずに API のほとんどの機能を操作することもできます。

ドラッグ&ドロップアップロード — ファイル、フォルダー（ブラウザ内で UnixFS ディレクトリにパッケージ化）、または .car アーカイブ
リネーム — アップロード後にファイル名を変更でき、選択時にファイル名から説明が自動入力されます
スナップショット — フォルダー内のすべてのコンテンツに対して単一のディレクトリ CID を取得
S3 CORS の設定 — フォームエディタでバケットごとに設定（ブラウザ SDK 連携向け）
管理 — API キー、ゲートウェイトークン、IPNS 名、専用ゲートウェイ設定を管理

IPFS Ninja Dashboard with analytics, charts, and usage stats

ゲートウェイアクセス

アップロードされたすべてのファイルは IPFS Ninja ゲートウェイを通じてアクセスできます。ゲートウェイは分散型 IPFS ネットワークと従来の Web ブラウザの間の橋渡しをします。

ゲートウェイ URL は以下のパターンに従います：

https://ipfs.ninja/ipfs/<CID>

apex ゲートウェイの範囲

https://ipfs.ninja/ipfs/<CID> の apex ゲートウェイは、登録された IPFS Ninja ユーザーによってアップロードまたはピン留めされた CID のみを配信します。それ以外の CID へのリクエストは HTTP 410 Gone を返し、ipfs.io や dweb.link などの公開 IPFS ゲートウェイへのポインタを提供します。サードパーティの CID を当社のゲートウェイ経由で配信するには、無料登録してから、まず POST /pin でアカウントに追加してください。

TIP

ファイルは同じ CID を使用して、任意の公開 IPFS ゲートウェイ（例：dweb.link、w3s.link）からもアクセスできます — IPFS ネットワークは分散型です。

すべての有料プランでは、自分のアカウントにピン留めされたファイルのみを配信する、独自のサブドメイン（<slug>.gw.ipfs.ninja）を使った専用ゲートウェイを利用できます — オプションのトークンベースのアクセス制御とオリジン制限も利用可能です。専用ゲートウェイは、本番環境への埋め込み（動画、NFT ビューア、Web サイトなど）に推奨される URL です。

サポートされるファイルタイプ

タイプ	フォーマット	入力
JSON	任意の有効な JSON オブジェクトまたは配列	`string / object`
画像	PNG, JPG, WebP, GIF, TIFF, SVG	`base64`
PDF	標準 PDF ドキュメント	`base64`
HTML	HTML ドキュメント	`base64`
任意	任意のファイル（バイナリ、テキスト、動画など）	`base64`

すべてのファイルタイプを受け付けます。タイプは自動検出され、参照用に記録されます。

セキュリティ

ゲートウェイレスポンスにはセキュリティヘッダー（Content-Security-Policy: sandbox、X-Content-Type-Options: nosniff、X-Frame-Options: DENY）が含まれ、配信されたコンテンツ内のスクリプト実行をブラウザが行うのを防ぎます。

IPFS Ninja ​

IPFS とは？ ​

IPFS Ninja でできること ​

ダッシュボード ​

ゲートウェイアクセス ​