FAQ

IPFS Ninja に関するよくある質問です。

一般

IPFS Ninja とは何ですか？

IPFS Ninja は、マネージド IPFS ピンニングサービスです。シンプルな REST API を通じて任意のファイルをアップロードしたり、IPFS ネットワーク上の既存の CID をピン留めしたりできます。各ファイルには永続的なコンテンツ識別子 (CID) が付与され、ipfs.ninja/ipfs/<CID> のゲートウェイからアクセスできます。

ipfs.ninja/ipfs/<CID> は IPFS ネットワーク上の任意の CID を配信しますか？

いいえ。apex ゲートウェイは、IPFS Ninja ユーザーによってアップロードまたはピン留めされた CID のみを配信します。未知の CID へのリクエストは HTTP 410 Gone を返し、公開 IPFS ゲートウェイ（ipfs.io、dweb.link）へのポインタを提供します。サードパーティの CID を当社のゲートウェイ経由で配信するには、まず POST /pin でアカウントに追加してください — ピン留めされると、CID は apex と専用ゲートウェイ URL の両方でアクセス可能になります。

apex ゲートウェイと専用ゲートウェイの違いは何ですか？

観点	apex ipfs.ninja/ipfs/<CID>	専用 <slug>.gw.ipfs.ninja/ipfs/<CID>
範囲	全ユーザーで共有	あなたの CID のみ
認証	なし	オプションのトークン / IP allowlist / origin allowlist
SLA	ベストエフォート	フル SLA
推奨用途	カジュアルなリンク	本番埋め込み（NFT、動画、ウェブサイト）
レート制限	IP 単位＋CID 単位で共有	プラン別、構成可能

どちらも同じコンテンツを配信します。本番トラフィックには専用ゲートウェイを使用してください。

どのファイルタイプに対応していますか？

すべてのファイルタイプに対応しています。JSON オブジェクトと配列は直接送信できます。その他すべてのファイル（画像、PDF、HTML、動画、音声、バイナリ）は base64 エンコードされたコンテンツとして送信します。

ファイルサイズの制限はありますか？

個々のアップロードはプランのストレージ割り当てによって制限されます。利用可能なストレージ以外に、ファイルごとのサイズ制限はありません。

IPFS 上に既に存在するコンテンツをピン留めできますか？

はい。POST /pin に任意の有効な CID を指定してください。クラスターが IPFS ネットワークからコンテンツを取得し、アカウントにピン留めします。詳細はピンニング API ドキュメントをご覧ください。

ピン留めにはどのくらい時間がかかりますか？

ファイルサイズとコンテンツを持つ IPFS ノードの数によります。小さく広く分散されたファイルは数秒でピン留めされます。大きいファイルや、あまりピン留めされていないコンテンツは数分かかることがあります。ピンエンドポイントはすぐに pinning ステータスを返します — GET /pin/:cid をポーリングして進捗を確認してください。

CID が見つからない場合はどうなりますか？

ステータスが failed に変わります。これは CID が無効か、到達可能な IPFS ノードにコンテンツが存在しないことを意味します。

IPFS にアップロードされたデータは公開されますか？

はい。IPFS にピン留めされたすべてのコンテンツは、その CID を通じて任意の IPFS ゲートウェイから公開でアクセスできます。プライベートアクセスが必要な場合は、トークン必須モードの専用ゲートウェイを使用してください — ゲートウェイ経由のアクセスを制限しますが、コンテンツは広範な IPFS ネットワーク上では引き続きアクセス可能です。

新しい CID が Qm... から bafy... に変わったのはなぜですか？

新規のアップロードとピン留めは、IPIP-0499 の unixfs-v1-2025 プロファイルに従い、最新の CIDv1（小さな単一ブロックのコンテンツには bafk…、より大きなファイルやディレクトリには bafy…）を返します。このプロファイルは CIDv1 base32 エンコーディング、1 MiB のチャンク、raw leaves を採用しています。これは最新のツール（Helia、最新版の Kubo、ipfs-car）が同じコンテンツに対して生成するものと一致するため、当社経由でアップロードされたファイルも、同じバイト列に対して最新のクライアントが計算するのと同じ CID になります。

以前のアップロードによるレガシーな Qm… CID は引き続き完全に解決可能です — ゲートウェイ、POST /pin、GET /file、IPNS、その他すべてのエンドポイントは両方の形式を今後も無期限にサポートします。既存のものが動作しなくなることはありません。

プライベート / 非 DHT ノード上にあるコンテンツをピン留めするにはどうすればよいですか？

POST /pin はオプションで multiaddresses[]（最大 5 件）を受け付けます。指定すると、当社のクラスターがピン留めを実行する前に、各ヒントに対して ipfs swarm connect <multiaddr> を実行します。これにより、公開 DHT にアドバタイズしていないピア（プライベートノード、ステージング環境、VPN ローカルのマシンなど）上のコンテンツにも到達できるようになります。詳細はプライベート IPFS ノードからのピン留めガイドをご覧ください。

アカウントをキャンセルした場合、ファイルは IPFS 上に残りますか？

キャンセル時にノードからファイルのピン留めを解除します。他の IPFS ノードがコンテンツをキャッシュしている場合、引き続きアクセスできる可能性があります。ただし、アクティブなピン留めがなければ、ファイルは最終的にネットワーク全体のガベージコレクションによって削除されます。

認証と API

API リクエストはどのように認証しますか？

X-Api-Key ヘッダーで API キーを渡してください。ダッシュボードの API キーページからキーを生成できます。

API レート制限はありますか？

ありません。IPFS Ninja は API リクエストにレート制限を課していません。どのプランでも必要なだけリクエストを送信できます。

API キーには有効期限がありますか？

ありません。API キーは削除するまで有効です。複数のキーを作成し、個別に取り消すことができます。

API キーとゲートウェイトークンの違いは何ですか？

API キー（bws_）はフルアクセスを持ちます — アップロード、削除、ファイル一覧。ゲートウェイトークン（gwt_）は読み取り専用で、専用ゲートウェイ経由でのみファイルにアクセスできます。ゲートウェイトークンはフロントエンドアプリに安全に埋め込めます。

専用ゲートウェイ

専用ゲートウェイとは何ですか？

独自のサブドメイン（例：abc123.gw.ipfs.ninja）にあるプライベート IPFS ゲートウェイで、アカウントにピン留めされたファイルのみを配信します。パブリックゲートウェイとは異なり、他のユーザーの CID を解決しません。

どのプランに専用ゲートウェイが含まれていますか？

専用ゲートウェイはすべての有料プラン（Bodhi $5/月、Karma $19/月、Nirvana $59/月）で利用できます。各プランの月間帯域幅クォータは、apex ゲートウェイと専用ゲートウェイ両方のトラフィックをカバーします。プランごとのクォータについては、下記の「帯域幅の料金はかかりますか？」をご覧ください。

ゲートウェイへのアクセスを制限できますか？

はい。トークン必須モード（すべてのリクエストに gwt_ トークンが必要）の有効化や、IP ホワイトリスト（最大 100 アドレス）の設定が可能です。

オリジン/ドメインでゲートウェイを制限できますか？

はい。ゲートウェイ設定で allowedOrigins に HTTPS オリジンのリストを設定してください。それらのオリジンからのブラウザリクエストのみが許可されます。Origin ヘッダーのない非ブラウザリクエストは通過します。空のリストはすべてのオリジンを許可します。

署名付きアップロードトークンとは何ですか？

署名付きアップロードトークンは、クライアントサイドアップロード用の期限付き認証情報です。サーバーで POST /upload/signed-url を使って生成し、ブラウザやモバイルアプリに渡します。クライアントは API キーを公開する代わりに Authorization: Signed <token> で認証します。各トークンは使用状況を追跡し、自動的に有効期限が切れます。詳細は署名付きトークンのドキュメントをご覧ください。

IPFS から配信される画像を最適化できますか？

はい。GET /image/:cid に w、h、format、quality などのクエリパラメータを付けて、画像をオンザフライでリサイズ、変換、圧縮できます。レスポンスはコンテンツアドレスの CID に基づいてキャッシュされます。この機能はすべてのプランで利用可能です。画像最適化をご覧ください。

ファイルにメタデータを添付できますか？

はい。POST /upload/new でのアップロード時や POST /pin でのピン留め時に、最大 10 個のキーバリューペアを持つ metadata オブジェクトを含めてください。メタデータはファイル一覧とファイル詳細エンドポイントで返されます。ファイルとピンニングのドキュメントをご覧ください。

料金とプラン

無料プランはありますか？

はい。Dharma プランは永久無料です — 1 GB のストレージ、無制限の API リクエスト、クレジットカード不要です。

帯域幅の料金はかかりますか？

どのプランでも従量課金の帯域幅料金はかかりません。各プランには月間のゲートウェイ帯域幅クォータが含まれており、これはハードキャップです — クォータに達すると、apex ゲートウェイと専用ゲートウェイの両方でコンテンツの配信が停止し、翌月の 1 日、またはアップグレード後に再開されます。

プラン	月間帯域幅
Dharma	2 GB
Bodhi	20 GB
Karma	100 GB
Nirvana	500 GB

クォータの 80% および 100% に達した時点で警告メールが届きます。

ストレージはリセットされますか？

ストレージはリセットされません。プランには総ストレージ割り当て（Dharma 1 GB / Bodhi 10 GB / Karma 100 GB / Nirvana 1 TB）が含まれています。空き容量を確保するには、不要なファイルを削除してください。プランをアップグレードすると総割り当てが増加します。

いつでもキャンセルできますか？

はい。請求ポータルからサブスクリプションをキャンセルできます — ロックインはありません。アカウントは無料プランに戻り、既存のピン留めされたファイルは引き続きアクセスできます。

ダウングレードした場合、ファイルはどうなりますか？

ファイルは IPFS 上にピン留めされたままですが、現在の使用量が新しいプランのストレージ制限を超えている場合、さらにアップロードすることはできません。制限内に収まるようにファイルを削除してください。

セキュリティ

データは暗号化されていますか？

すべてのデータは TLS/HTTPS により転送中に暗号化されます。認証には JWT トークン（Cognito）と安全に保存された API キーを使用します。IPFS 上のファイルコンテンツは保存時には暗号化されません — IPFS は設計上パブリックネットワークです。

サーバーサイドのコードで API キーを使用しても安全ですか？

はい。API キーはサーバーサイドでの使用を想定して設計されています。クライアントサイドのコードには決して公開しないでください。クライアントサイドでのファイルアクセスには、読み取り専用のゲートウェイトークン（gwt_）を使用してください。

サポート

ヘルプを受けるにはどうすればよいですか？

info@ipfs.ninja にメールするか、API リファレンスのドキュメントをご確認ください。

SLA はありますか？

高い可用性を目指していますが、現時点では正式な SLA は提供していません。サービスは「現状のまま」で提供されます。