Pandafile · Her hafta 50 GB ücretsiz

Uygulamalarınız ve iş akışlarınız için dosya transferi API'si

Pandafile, büyük dosyaları kendi kodunuzdan, sunucularınızdan ve kodsuz araçlardan göndermeniz için bir REST API sunar. Bir transfer oluşturun, dosyaları kaldığı yerden devam eden yüklemelerle gönderin, alıcılara kişisel bağlantıları e-postayla iletin ve biri indirdiğinde bir webhook alın. API, Pro ve Team planlarına dahildir, web uygulamasıyla aynı sınırları izler ve herkese açık bir OpenAPI 3.1 belgesiyle tanımlanır. Test anahtarları sayesinde gerçek e-posta göndermeden ve depolama alanınızı kullanmadan geliştirme yapıp test çalıştırabilirsiniz.

Geliştirici kılavuzunu okuyun

OpenAPI 3.1 ile tanımlanmış bir REST API

Tüm uç noktalar /api/v1 altında bulunur ve JSON kullanır. Kimlik doğrulama, Authorization başlığında Bearer token olarak gönderilen bir API anahtarıyla yapılır. Anahtarlar panelinizde oluşturulur, yalnızca bir kez gösterilir ve salt okuma, okuma ve yazma ya da tam erişim olarak sınırlandırılabilir; böylece bir raporlama betiği asla transfer silme yetkisi almaz. API'nin tamamı /api/v1/openapi.json adresindeki makine tarafından okunabilir OpenAPI 3.1 belgesinde tanımlanmıştır; bu belgeyi Postman'e yükleyebilir, ondan bir istemci üretebilir ya da bir yapay zekâ kodlama asistanına verebilirsiniz. /developers adresindeki geliştirici kılavuzu temel kavramları açıklar, /developers/api adresindeki API referansı ise her uç noktayı örneklerle listeler. Her yanıt bir istek kimliği taşır, hız sınırları RateLimit başlıklarında bildirilir, listeler imleç tabanlı sayfalama kullanır ve hatalar tek bir JSON biçimini paylaşır.

tus ile kaldığı yerden devam eden yüklemeler

Büyük dosyalar ve güvenilmez ağlar tek ve uzun bir HTTP isteğiyle pek iyi anlaşmaz. Dosya göndermek için önce POST /api/v1/transfers ile dosyaları, başlığı, mesajı ve isterseniz alıcıların e-posta adreslerini belirterek bir transfer oluşturursunuz. Ardından her dosya, kaldığı yerden devam eden yüklemeler için açık protokol olan tus ile yüklenir; böylece kopan bir bağlantı ya da yeniden başlatılan bir sunucu baştan başlamak yerine son bayttan devam edebilir. JavaScript, Python, Go, Java, .NET, Swift ve daha fazlası için hazır tus istemcileri vardır. Tüm dosyalar yüklendiğinde complete çağrısını yaparsınız ve transfer; indirme sayfası, alıcılar için kişisel bağlantılar, hatırlatmalar ve son kullanma tarihiyle normal bir Pandafile bağlantısına dönüşür. Tarayıcıdaki plan sınırlarının aynısı geçerlidir: Pro'da transfer başına 1000 GB'a kadar ve 1500 GB depolama.

Dosyaları doğrudan bir URL'den gönderin

Bazen dosya zaten başka bir yerdedir: bir CRM eki, bir render farm çıktısı ya da başka bir sunucudaki bir dışa aktarım. POST /api/v1/transfers/from-url HTTPS URL'lerini alır ve dosyaları Pandafile'ın sizin yerinize çekmesini sağlar, ardından transferi oluşturup tamamlar. İstek en fazla 20 saniye bekler. Küçük içe aktarmalar tamamlanmış olarak döner; daha büyükleri ise uploading durumuyla hemen yanıt verir ve içe aktarma arka planda sürer. İlerlemeyi GET /api/v1/transfers/{id}/import ile takip edebilir ya da yalnızca transfer.ready webhook'unu bekleyebilirsiniz. Zapier ve Make entegrasyonları da dosyaları, iş akışınızın önce onları indirmesine gerek kalmadan bu şekilde gönderir.

Webhook'lar ve bildirimler

Sürekli sorgulamak yerine olaylara abone olun. Pandafile; bir transfer hazır olduğunda, indirildiğinde ya da süresi dolduğunda, bir alıcı dosyaları onayladığında ya da değişiklik istediğinde, biri dosya isteklerinizden birine yükleme yaptığında ve bir imza talebi tamamlandığında URL'nizi çağırabilir. Her teslimat Pandafile-Signature başlığında HMAC-SHA256 ile imzalanır, böylece gerçekten bizden geldiğini doğrulayabilirsiniz; başarısız teslimatlar 1 dakika, 5 dakika, 30 dakika, 2 saat ve 12 saat sonra yeniden denenir. Olaylar ayrıca 30 gün saklanır ve GET /api/v1/events ile okunabilir. Hiç kod yazmak istemiyorsanız aynı olaylar Slack, Microsoft Teams ya da Discord'a mesaj olarak da gönderilebilir.

Test anahtarları, güvenli yeniden denemeler ve otomatikleştirebileceğiniz diğer şeyler

API anahtarları iki modda gelir. Canlı anahtarlar pf_live_ ile, test anahtarları pf_test_ ile başlar. Test anahtarıyla oluşturulan transferler asla e-posta göndermez, depolama alanınıza ya da kullanımınıza sayılmaz, yalnızca 24 saat saklanır ve normal transfer listenizde görünmez; böylece gerçek API'ye karşı yan etkisi olmadan entegrasyon testleri çalıştırabilirsiniz. POST ve PATCH istekleri Idempotency-Key başlığını kabul eder, bu yüzden yeniden denenen bir istek asla ikinci bir transfer oluşturmaz. API, transferlerin ötesinde alıcıları ve hatırlatmaları, indirme geçmişini, bağlantı istatistiklerini ve onayları, dosya isteklerini, imza taleplerini, markalamayı ve ekip davetlerini de kapsar. API, aylık 5,99 $ veya yıllık 49,99 $'dan başlayan Pro'ya ve aylık 14,99 $ veya yıllık 129,99 $'dan başlayan Team'e dahildir. Bir ekipte her üyenin kendi kişisel anahtarları vardır.

Sorular

Pandafile'ın bir API'si var mı?

Evet. Pandafile'ın transfer oluşturmak, dosya yüklemek, alıcıları, dosya isteklerini ve imza taleplerini yönetmek ve webhook almak için /api/v1 altında bir REST API'si vardır. Pro ve Team planlarına dahildir.

API belgeleri nerede?

Geliştirici kılavuzu /developers adresinde, örnekli tam API referansı ise /developers/api adresindedir. Makine tarafından okunabilir OpenAPI 3.1 belgesi /api/v1/openapi.json adresinde herkese açıktır.

Bağlantı koparsa yüklemeler devam edebilir mi?

Evet. Dosyalar, kaldığı yerden devam eden yüklemeler için tus protokolüyle yüklenir; böylece yarıda kalan bir yükleme baştan başlamak yerine durduğu yerden sürer.

Gerçek e-posta göndermeden test edebilir miyim?

Evet. pf_test_ ile başlayan bir test anahtarı kullanın. Test transferleri asla e-posta göndermez, depolama alanınıza ya da kullanımınıza sayılmaz ve 24 saat sonra silinir.

Zaten çevrimiçi olan bir dosyayı gönderebilir miyim?

Evet. POST /api/v1/transfers/from-url dosyaları HTTPS URL'lerinden çeker ve bir transfere dönüştürür. Büyük içe aktarmalar arka planda sürer ve transfer.ready webhook'u bağlantı hazır olduğunda size haber verir.

Geliştirici kılavuzunu okuyun

Popüler