SSS

IPFS Ninja hakkında sıkça sorulan sorular.

Genel

IPFS Ninja nedir?

IPFS Ninja, yönetilen bir IPFS sabitleme hizmetidir. Basit bir REST API aracılığıyla herhangi bir dosyayı yükler veya IPFS ağından mevcut CID'leri sabitlersiniz. Her dosya kalıcı bir içerik tanımlayıcısı (CID) alır ve ipfs.ninja/ipfs/<CID> adresindeki gateway'imiz üzerinden erişilebilir olur.

ipfs.ninja/ipfs/<CID> IPFS ağındaki herhangi bir CID'yi sunar mı?

Hayır. Apex ağ geçidi yalnızca bir IPFS Ninja kullanıcısı tarafından yüklenmiş veya sabitlenmiş CID'leri sunar. Bilinmeyen CID'ler için yapılan istekler HTTP 410 Gone döndürür ve genel IPFS ağ geçitlerine (ipfs.io, dweb.link) yönlendirir. Üçüncü taraf bir CID'yi ağ geçidimiz üzerinden sunmak için önce hesabınıza POST /pin yapın — sabitlendikten sonra CID hem apex'te hem de özel gateway URL'nizde erişilebilir hale gelir.

Apex ağ geçidi ile özel gateway arasındaki fark nedir?

Yön	Apex ipfs.ninja/ipfs/<CID>	Özel <slug>.gw.ipfs.ninja/ipfs/<CID>
Kapsam	Tüm kullanıcılar arasında paylaşılır	Yalnızca sizin CID'leriniz
Kimlik doğrulama	Yok	İsteğe bağlı token / IP allowlist / origin allowlist
SLA	Best-effort	Tam SLA
Önerilen kullanım	Gündelik bağlantılar	Üretim gömme (NFT, video, web siteleri)
Hız sınırları	IP başına + CID başına paylaşılır	Plana göre, yapılandırılabilir

Her ikisi de aynı içeriği sunar. Üretim trafiği için özel gateway'i kullanın.

Hangi dosya türleri desteklenir?

Tüm dosya türleri desteklenir. JSON nesneleri ve dizileri doğrudan gönderilebilir. Diğer tüm dosyalar (görseller, PDF'ler, HTML, video, ses, ikili dosyalar) base64 kodlanmış içerik olarak gönderilir.

Dosya boyutu sınırı var mı?

Tek yüklemeler planınızın depolama kotasıyla sınırlıdır. Mevcut depolama alanınız dışında dosya başına boyut sınırı yoktur.

IPFS'te zaten var olan içeriği sabitleyebilir miyim?

Evet. Herhangi bir geçerli CID ile POST /pin kullanın. Kümemiz içeriği IPFS ağından alır ve hesabınıza sabitler. Ayrıntılar için Sabitleme API dokümantasyonuna bakın.

Sabitleme ne kadar sürer?

Dosya boyutuna ve içeriğe sahip IPFS düğümlerinin sayısına bağlıdır. Küçük, iyi dağıtılmış dosyalar saniyeler içinde sabitlenir. Büyük veya nadiren sabitlenmiş içerik birkaç dakika alabilir. Sabitleme uç noktası pinning durumuyla hemen döner — ilerlemeyi kontrol etmek için GET /pin/:cid'i sorgulayın.

Bir CID bulunamazsa ne olur?

Durum failed olarak değişir. Bu, CID'nin geçersiz olduğu veya içeriğin ulaşılabilir herhangi bir IPFS düğümünde artık mevcut olmadığı anlamına gelir.

IPFS'e yüklenen veriler herkese açık mı?

Evet. IPFS'e sabitlenmiş tüm içerik, CID'si aracılığıyla herhangi bir IPFS gateway'inden herkese açık olarak erişilebilir. Özel erişime ihtiyacınız varsa, token zorunlu modunda bir özel gateway kullanın — bu, gateway'iniz üzerinden erişimi kısıtlar, ancak içerik daha geniş IPFS ağında erişilebilir olmaya devam eder.

Yeni CID'lerim neden Qm...'den bafy...'ye değişti?

Yeni yüklemeler ve sabitlemeler, IPIP-0499 unixfs-v1-2025 profiline uygun modern CIDv1 (bafk… küçük tek bloklu içerik için, bafy… daha büyük dosyalar ve dizinler için) döndürür: CIDv1 base32 kodlaması, 1 MiB parçalar, ham yapraklar (raw leaves). Bu, modern araçların (Helia, en son Kubo, ipfs-car) aynı içerik için ürettiğiyle eşleşir, bu yüzden bizim üzerimizden yüklenen bir dosya, aynı baytlar için herhangi bir modern istemcinin hesaplayacağı aynı CID'yi alır.

Önceki yüklemelerden gelen eski Qm… CID'leri tam olarak çözümlenebilir olmaya devam eder — gateway, POST /pin, GET /file, IPNS ve diğer tüm uç noktalar her iki biçimi de süresiz olarak kabul eder. Zaten sahip olduğunuz hiçbir şey çalışmayı durdurmaz.

Özel / DHT dışı bir düğümde bulunan içeriği nasıl sabitlerim?

POST /pin, isteğe bağlı multiaddresses[] (en fazla 5) kabul eder. Sağlanırsa, kümemiz sabitleme çalışmadan önce her ipucu için ipfs swarm connect <multiaddr> yapar, böylece genel DHT üzerinden duyuru yapmayan eşlerdeki içeriğe (özel düğümler, hazırlık ortamları, VPN'e özel makineler) ulaşılabilir. Bkz. Özel bir IPFS düğümünden sabitleme kılavuzu.

Hesabımı iptal edersem dosyalarım IPFS'te kalır mı?

İptal ettiğinizde dosyalarınızın sabitlemesini düğümlerimizden kaldırırız. Diğer IPFS düğümleri içeriğinizi önbelleklemişse, erişilebilir kalabilir. Ancak aktif sabitleme olmadan, dosyalar zamanla ağ genelinde çöp toplama ile kaldırılır.

Kimlik Doğrulama ve API

API isteklerini nasıl doğrularım?

API anahtarınızı X-Api-Key başlığıyla iletin. Kontrol panelinizde API Anahtarları sayfasından anahtarlar oluşturun.

API hız sınırlamaları var mı?

Hayır. IPFS Ninja, API isteklerine hız sınırlaması uygulamaz. Herhangi bir planda ihtiyacınız kadar istek yapabilirsiniz.

API anahtarlarının süresi dolur mu?

Hayır. API anahtarları siz silene kadar geçerlidir. Birden fazla anahtar oluşturabilir ve bunları tek tek iptal edebilirsiniz.

API anahtarları ile gateway token'ları arasındaki fark nedir?

API anahtarları (bws_) tam erişime sahiptir — yükleme, silme, dosya listeleme. Gateway token'ları (gwt_) salt okunurdur ve yalnızca özel gateway'iniz üzerinden dosyalara erişebilir. Gateway token'larını ön yüz uygulamalarına güvenle yerleştirebilirsiniz.

Özel Gateway'ler

Özel gateway nedir?

Yalnızca hesabınıza sabitlenmiş dosyaları sunan, kendi alt alan adınızdaki (örn. abc123.gw.ipfs.ninja) özel bir IPFS gateway'idir. Genel gateway'in aksine, diğer kullanıcıların CID'lerini çözmez.

Hangi planlar özel gateway içerir?

Özel gateway'ler tüm ücretli planlarda mevcuttur (Bodhi 5 $/ay, Karma 19 $/ay, Nirvana 59 $/ay). Her planın aylık bant genişliği kotası hem apex hem de özel gateway'lerden gelen trafiği kapsar. Plan başına kotalar için aşağıdaki "Bant genişliği ücretleri var mı?" bölümüne bakın.

Gateway'ime kimin eriştiğini kısıtlayabilir miyim?

Evet. Token zorunlu modunu etkinleştirebilir (her istekte gwt_ token'ı gerektirir) ve/veya IP beyaz listesi ayarlayabilirsiniz (100 adrese kadar).

Gateway'imi kaynak/alan adına göre kısıtlayabilir miyim?

Evet. Gateway ayarlarınızda HTTPS kaynakları listesiyle allowedOrigins yapılandırın. Yalnızca bu kaynaklardan gelen tarayıcı isteklerine izin verilir. Tarayıcı dışı istekler (Origin başlığı olmadan) kısıtlama olmadan geçer. Boş liste tüm kaynaklara izin verir.

İmzalı yükleme token'ları nedir?

İmzalı yükleme token'ları, istemci tarafı yüklemeler için süreli kimlik bilgileridir. Bunları sunucunuzda POST /upload/signed-url ile oluşturur ve tarayıcılara veya mobil uygulamalara iletirsiniz. İstemci, API anahtarınızı açığa çıkarmak yerine Authorization: Signed <token> ile kimlik doğrulaması yapar. Her token kullanımı izler ve otomatik olarak sona erer. Ayrıntılar için İmzalı Token'lar dokümantasyonuna bakın.

IPFS'ten sunulan görselleri optimize edebilir miyim?

Evet. Görselleri anında yeniden boyutlandırmak, dönüştürmek ve sıkıştırmak için GET /image/:cid'yi w, h, format ve quality gibi sorgu parametreleriyle kullanın. Yanıtlar içerik adreslemeli CID'ye dayalı olarak önbelleğe alınır. Tüm planlarda çalışır. Bkz. Görüntü Optimizasyonu.

Dosyalara meta veri ekleyebilir miyim?

Evet. POST /upload/new ile yükleme veya POST /pin ile sabitleme yaparken en fazla 10 anahtar-değer çifti içeren bir metadata nesnesi ekleyin. Meta veriler dosya listelerinde ve dosya detay uç noktasında döndürülür. Dosyalar ve Sabitleme dokümantasyonuna bakın.

Faturalandırma ve Planlar

Ücretsiz plan var mı?

Evet. Dharma planı sonsuza kadar ücretsizdir — 1 GB depolama, sınırsız API istekleri, kredi kartı gerekmez.

Bant genişliği ücretleri var mı?

Herhangi bir planda ölçülü bant genişliği ücreti yoktur. Her plan, sert bir sınır olan aylık bir gateway bant genişliği kotası içerir — kotaya ulaşıldığında içeriğiniz hem apex hem de özel gateway'lerde sunulmayı durdurur ve bir sonraki ayın 1'inde veya bir yükseltmeden sonra devam eder:

Plan	Aylık bant genişliği
Dharma	2 GB
Bodhi	20 GB
Karma	100 GB
Nirvana	500 GB

Kotanızın %80'inde ve %100'ünde uyarı e-postaları alırsınız.

Depolama sıfırlanır mı?

Depolama sıfırlanmaz. Planınız toplam bir depolama kotası içerir (Dharma 1 GB / Bodhi 10 GB / Karma 100 GB / Nirvana 1 TB). Yer açmak için artık ihtiyaç duymadığınız dosyaları silin. Planınızı yükseltmek toplam kotanızı artırır.

İstediğim zaman iptal edebilir miyim?

Evet. Aboneliğinizi faturalandırma portalı üzerinden iptal edin — bağlayıcılık yok. Hesabınız ücretsiz katmana döner ve mevcut sabitlenmiş dosyalar erişilebilir kalır.

Plan düşürürsem dosyalarıma ne olur?

Dosyalarınız IPFS'te sabitli kalır, ancak mevcut kullanımınız yeni planın depolama sınırını aşıyorsa daha fazla yükleme yapamazsınız. Sınırın altına inmek için dosyaları silin.

Güvenlik

Verilerim şifreleniyor mu?

Tüm veriler TLS/HTTPS aracılığıyla aktarım sırasında şifrelenir. Kimlik doğrulama JWT token'ları (Cognito) ve güvenli şekilde saklanan API anahtarları kullanır. IPFS'teki dosya içerikleri durağan halde şifrelenmez — IPFS tasarım gereği herkese açık bir ağdır.

API anahtarlarını sunucu tarafı kodumda kullanmak güvenli mi?

Evet. API anahtarları sunucu tarafı kullanım için tasarlanmıştır. Bunları asla istemci tarafı kodda açığa çıkarmayın. İstemci tarafı dosya erişimi için salt okunur olan gateway token'larını (gwt_) kullanın.

Destek

Nasıl yardım alabilirim?

info@ipfs.ninja adresine e-posta gönderin veya API Referansı dokümantasyonuna bakın.

SLA var mı?

Yüksek erişilebilirlik hedefliyoruz ancak şu anda resmi bir SLA sunmuyoruz. Hizmet "olduğu gibi" sunulmaktadır.