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.

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.

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, aylık 50 GB gateway bant genişliği içeren Nirvana planında ($29/ay) mevcuttur.

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 API istekleri için bant genişliği ücreti yoktur. Özel gateway bant genişliği (Nirvana planı) aylık 50 GB içerir. Sınıra ulaşıldığında, gateway istekleri bir sonraki aya kadar engellenir.

Depolama sıfırlanır mı?

Depolama sıfırlanmaz. Planınız toplam depolama kotası içerir (1 GB / 10 GB / 100 GB). 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.