よくある質問

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

一般

IPFS Ninja とは何ですか？

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

アカウントをキャンセルした場合、ファイルは 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 を解決しません。

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

専用ゲートウェイは Nirvana プラン（$29/月）で利用可能で、月間 50 GB のゲートウェイ帯域幅が含まれています。

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

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

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

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

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

署名付きアップロードトークンは、クライアントサイドアップロード用の期限付き認証情報です。サーバーで 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 リクエスト、クレジットカード不要です。

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

どのプランでも API リクエストに帯域幅の料金はかかりません。専用ゲートウェイの帯域幅（Nirvana プラン）は月間 50 GB が含まれます。制限に達すると、ゲートウェイリクエストは翌月までブロックされます。

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

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

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

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

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

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

セキュリティ

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

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

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

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

サポート

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

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

SLA はありますか？

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