Skip to main content
Whop yüklemeleri doğrudan depolama alanına yapılır. Create File çağırdığınızda Whop, baytlarınızı API üzerinden almaz. Bunun yerine bir dosya kaydı oluşturur ve baytları kendinizin PUT ile göndereceğiniz önceden imzalanmış bir yükleme URL’si döndürür. Bu baytlar Whop’un depolama alanına ulaştığında dosya kullanılabilir hale gelir. Bu, SDK’nın files.create ve files.retrieve yöntemlerinin arkasındaki ham iki adımlı akıştır. Tarayıcıdan yükleme yaptığınızda (böylece baytlar sunucunuza hiç dokunmaz) veya SDK’sı olmayan bir dilde çalıştığınızda bunu kullanın. Çok parçalı yükleme gerektirecek kadar büyük dosyaları da bu şekilde gönderirsiniz.
/files uç noktaları API sürümü 2026-08-21-1 veya daha yenisini gerektirir. Aşağıdaki her istek bunu Api-Version-Date başlığıyla sabitler. Bkz. API sürümleri.

Yükleme yaşam döngüsü

Tek parça da olsa çok parça da olsa her yükleme üç adımdan oluşur:
  1. Dosya kaydını oluşturun → Whop önceden imzalanmış bir hedef döndürür ve dosya pending durumunda başlar.
  2. Baytları doğrudan önceden imzalanmış URL’lere yükleyin.
  3. upload_status değeri ready olana kadar Retrieve File uç noktasını sorgulayın — ardından url ve size doldurulur ve dosyanın kimliği Whop’un belge kabul ettiği her yere eklenebilir.
Bir dosyanın url ve size değerleri işleme tamamlanana kadar null kalır. upload_status sırasıyla pending → processing → ready (veya failed) durumlarından geçer.

Tek parçalı yükleme

Birkaç yüz megabayttan küçük her şey için tek bir PUT kullanın.
1

Dosyayı oluşturun

filename değerini ve isteğe bağlı olarak bir visibility değerini (varsayılan olarak private) gönderin. Yanıttaki upload_url baytların gideceği yerdir; upload_headers ise baytlarla birlikte göndermeniz gereken başlıklardır.
2

Baytları yükleyin

Dosyanın içeriğini, upload_headers içindeki her başlığı göndererek upload_url adresine PUT ile gönderin. Bu istek api.whop.com adresine değil, doğrudan Whop’un dosya depolama alanına gider ve Whop Authorization başlığı taşımaz — kimlik bilgileri önceden imzalanmış URL’nin içine gömülüdür.
Önceden imzalanmış URL’nin süresi, verildikten bir saat sonra dolar. Dosyayı yüklemeden hemen önce oluşturun ve uzun bir gecikmeden sonra bir PUT isteği 403 ile başarısız olursa yeni bir URL isteyin. Çok parçalı yüklemelerdeki parça URL’lerinin süresi daha erken, 15 dakika sonra dolar.
3

Hazır olana kadar sorgulayın

upload_status değeri ready olana kadar dosyayı kimliğiyle getirin. Ardından url alanı bir indirme bağlantısı içerir: dosya public ise kalıcı bir içerik dağıtım ağı URL’si, private ise imzalı ve süresi dolan bir URL.

Çok parçalı yükleme

Büyük dosyalar için parçalar halinde yükleyin. Whop her parça için önceden imzalanmış bir URL döndürür. Bunları yüklersiniz (isteğe bağlı olarak paralel), ardından Whop’a onları birleştirmesini söylersiniz. Tek bir yükleme isteği 5 GB’ı aşamayacağından, çok parçalı yükleme 5 GB’ın üzerinde zorunludur. Tek bir uzun yüklemenin kırılgan olduğu ~100 MB’ın üzerinde de iyi bir fikirdir. Sonuncusu hariç her parçanın en az 5 MB olması gerektiğinden, dosya 5 MB’tan büyük olmalıdır.
1

Dosyayı çok parçalı yükleme etkinken oluşturun

Whop’un kaç tane önceden imzalanmış parça URL’si döndüreceğini bilmesi için multipart: true ve toplam byte_size değerini iletin. Yanıt bir multipart_upload_id, her part_number için önceden imzalanmış bir url ve sonuncusu hariç her parçanın olması gereken boyut olan multipart_chunk_size (bayt) değerini taşır.
Çok parçalı yüklemeler, her biri 5 MB olan en fazla 10.000 parçayı destekler — yaklaşık 50 GB. Daha fazla parça gerektirecek bir byte_size değeri 400 ile reddedilir.
2

Her parçayı yükleyin ve ETag değerini kaydedin

Dosyayı multipart_chunk_size baytlık parçalara bölün (son parça daha küçük olabilir) ve her parçayı eşleşen parçanın url adresine PUT ile gönderin. Her yükleme yanıtı bir ETag başlığı döndürür — bunu part_number ile birlikte saklayın, işlemi tamamlamak için ikisine de ihtiyacınız olacak.
3

Yüklemeyi tamamlayın

multipart_upload_id değerini ve her parçanın part_number + etag değerlerini Complete File Multipart Upload uç noktasına iletin. Whop parçaları son dosyada birleştirir.
Her parça, sırayla ve yüklediğinizde döndürülen tam ETag değeriyle listelenmelidir. Bilinmeyen bir multipart_upload_id veya eşleşmeyen bir ETag, 400 olarak döner — sorunlu parçayı yeniden yükleyin ve işlemi yeniden tamamlayın.
4

Hazır olana kadar sorgulayın

Tek parçalı yüklemelerde olduğu gibi, upload_status değeri ready olana kadar dosyayı getirin. Ardından kimlik eklenmeye hazırdır.

Bir görünürlük seçme

visibility değerini oluşturma sırasında ayarlarsınız ve daha sonra değiştiremezsiniz: Herkese açık dosyalar Whop’un CDN’inde önbelleğe alınır ve iptal edilemez, bu nedenle hassas olan her şey için varsayılan private değerini koruyun. Daha fazlası için Dosya yükleme sayfasına bakın.

Yüklenmiş bir dosyayı kullanma

Bir dosya ready olduğunda, id değerini Whop’un belge kabul ettiği her yere iletin — örneğin bir itirazın kanıtlarına veya bir hesabın yasal belgelerine.

Sonraki adımlar

Dosya yükleme (SDK)

SDK’nın files.create ve files.retrieve yöntemlerinin bu akışı nasıl sarmaladığı.

Create File

Oluşturma uç noktası için eksiksiz istek ve yanıt referansı.

Complete File Multipart Upload

Çok parçalı yükleme parçalarını birleştirme referansı.

API sürümleri

Api-Version-Date başlığının neden önemli olduğu ve nasıl sabitleneceği.