IPFS Ninja

Resimleri, PDF'leri ve JSON dosyalarını kolayca IPFS'e yükleyin ve anında gateway erişimi ile kalıcı bir içerik tanımlayıcısı (CID) alın.

IPFS nedir?

Gezegenlerarası Dosya Sistemi (IPFS), merkezi olmayan, eşler arası bir depolama protokoludur. IPFS dosyaları daha küçük parçalara böler, ağ genelinde dağıtır ve her dosyaya içeriğine dayalı benzersiz bir içerik tanımlayıcısı (CID) atar.

Bu şu anlama gelir:

• Dağıtık depolama — dosyalarınız geliştirilmiş güvenilirlik için birden fazla düğümde saklanır.
• İçerik adresleme — CID, dosya içeriğinin kendisinden türetilir ve değişmezliği garanti eder.
• Ağ genelinde erişilebilirlik — CID'ye sahip herkes dosyayı herhangi bir IPFS düğümünden alabilir.

IPFS Ninja ne yapar

IPFS Ninja, basit bir REST API aracılığıyla dosya yüklemenize ve mevcut içeriği IPFS'te sabitlemenize olanak tanıyan yönetilen bir hizmettir. Kendi IPFS düğümünüzü çalıştırmanıza gerek yoktur.

• Yeni dosya yükleme — herhangi bir dosyayı POST /upload/new ile gönderin ve kalıcı bir CID alın
• Mevcut CID'leri sabitleme — IPFS'te zaten içeriğiniz var mı? Erişilebilirliği sağlamak için POST /pin ile kümemize sabitleyin
• Gateway üzerinden erişim — tüm sabitlenmiş içerik ipfs.ninja/ipfs/<CID> adresinden erişilebilir (apex ağ geçidi yalnızca hesabınızdaki veya diğer IPFS Ninja hesaplarındaki CID'leri sunar — aşağıdaki Gateway erişimi bölümüne bakın)
• Özel meta veriler — organizasyon ve filtreleme için yüklemelere ve sabitlemelere anahtar-değer çiftleri ekleyin
• İmzalı yükleme token'ları — API anahtarınızı açığa çıkarmadan istemci tarafı yüklemeler için süreli token'lar oluşturun
• IPNS değiştirilebilir adlar — IPNS API aracılığıyla değişen CID'lere işaret eden kararlı adlar oluşturun, hesap başına 10 ada kadar
• Görüntü optimizasyonu — gateway URL parametreleri ile görüntüleri anında yeniden boyutlandırın, dönüştürün ve sıkıştırın

Kontrol Paneli

Kişisel kontrol panelinizden yüklemeleri, depolamayı ve gateway bant genişliğini takip edin. Dashboard ayrıca API'nin çoğunu kod yazmadan çalıştırmanıza olanak tanır:

• Sürükle-bırak yükleme — dosyalar, klasörler (tarayıcınızda bir UnixFS dizinine paketlenir) veya .car arşivleri
• Yüklemeden sonra dosyaları yeniden adlandırın; seçimde dosya adından açıklama otomatik doldurulur
• İçindeki her şey için tek bir dizin CID'si almak üzere bir klasörü snapshot'layın
• Form editörü ile bucket başına S3 CORS yapılandırın (tarayıcı SDK entegrasyonları için)
• API anahtarlarını, gateway token'larını, IPNS adlarını ve özel gateway ayarlarını yönetin

Gateway erişimi

Yüklenen her dosya, merkezi olmayan IPFS ağı ile geleneksel web tarayıcıları arasında köprü görevi gören IPFS Ninja gateway üzerinden erişilebilir.

Gateway URL'si şu kalıbı izler:

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

Apex ağ geçidi kapsamı

https://ipfs.ninja/ipfs/<CID> adresindeki apex ağ geçidi yalnızca kayıtlı bir IPFS Ninja kullanıcısı tarafından yüklenmiş veya sabitlenmiş CID'leri sunar. Diğer CID'ler için yapılan istekler HTTP 410 Gone döndürür ve ipfs.io veya dweb.link gibi genel IPFS ağ geçitlerine yönlendirir. Üçüncü taraf bir CID'yi ağ geçidimiz üzerinden sunmak için ücretsiz kaydolun ve önce hesabınıza POST /pin yapın.

TIP

Dosyalarınız aynı CID ile herhangi bir genel IPFS gateway'inden (örn. dweb.link, w3s.link) de erişilebilir — IPFS ağı merkeziyetsizdir.

Tüm ücretli planlar, yalnızca kendi hesabına sabitlenmiş dosyaları sunan kendi alt alan adında (<slug>.gw.ipfs.ninja) bir özel gateway alır — isteğe bağlı token tabanlı erişim kontrolü ve kaynak kısıtlamaları ile birlikte. Özel gateway, üretim ortamına gömme (videolar, NFT görüntüleyicileri, web siteleri) için önerilen URL'dir.

Desteklenen dosya türleri

Tür	Formatlar	Giriş
JSON	Herhangi bir geçerli JSON nesnesi veya dizisi	string / object
Görseller	PNG, JPG, WebP, GIF, TIFF, SVG	base64
PDF	Standart PDF belgeleri	base64
HTML	HTML belgeleri	base64
Herhangi	Herhangi bir dosya (ikili, metin, video vb.)	base64

Tüm dosya türleri kabul edilir. Tür otomatik olarak algılanır ve referansınız için kaydedilir.

Güvenlik

Gateway yanıtları, tarayıcıların sunulan içerikteki betikleri çalıştırmasını engelleyen güvenlik başlıkları (Content-Security-Policy: sandbox, X-Content-Type-Options: nosniff, X-Frame-Options: DENY) içerir.