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> でアクセス可能
• カスタムメタデータ — アップロードやピン留めにキーバリューペアを添付し、整理やフィルタリングに活用
• 署名付きアップロードトークン — API キーを公開せずにクライアントサイドアップロード用の期限付きトークンを生成
• IPNS ミュータブルネーム — IPNS API を通じて、変化する CID を指す安定した名前を作成（アカウントごとに最大 10 個）
• 画像最適化 — ゲートウェイ URL パラメータを使用して、画像をオンザフライでリサイズ、変換、圧縮

ダッシュボード

個人ダッシュボードからアップロード、ストレージ、ゲートウェイ帯域幅を追跡できます。

ゲートウェイアクセス

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

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

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

TIP

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

Nirvana プランのユーザーは、独自のサブドメイン（<slug>.gw.ipfs.ninja）に専用ゲートウェイを取得でき、自分のアカウントにピン留めされたファイルのみを配信します — オプションのトークンベースのアクセス制御とオリジン制限が利用可能です。

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

タイプ	フォーマット	入力
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）が含まれ、配信されたコンテンツ内のスクリプト実行をブラウザが行うのを防ぎます。

サイズ制限

制限	値
リクエストあたりの最大ペイロード	6 MB（API Gateway の制限）
総ストレージ（Dharma）	1 GB
総ストレージ（Bodhi）	10 GB
総ストレージ（Nirvana）	100 GB

ユースケース

NFT メタデータとアセット

永続的で不変の CID を使用して、NFT メタデータ JSON と関連画像を保存します。

静的リソースホスティング

Web およびモバイルアプリケーション向けの画像、ドキュメント、データファイルをホスティングします。

検証可能なデータ共有

コンテンツアドレッシングによる来歴証明でデータを共有 — 受信者はデータが改ざんされていないことを検証できます。