Önceden imzalanmış bir URL ile API üzerinden dosya yükleyin, ardından bunları Whop kaynaklarına ekleyin.
Kurslarda, forumlarda, profillerde, itirazlarda ve daha fazlasında kullanmak üzere Whop’a dosya yükleyin.
Yüklemeler nasıl çalışır
Yükleme iki adımlı bir akıştır ve SDK ilk adımda yardımcı olur:
Bir dosya kaydı oluşturun.files.create, yeni dosyanın id değerini, önceden imzalanmış bir upload_url adresini ve bununla birlikte gönderilecek upload_headers başlıklarını döndürür.
Baytları kendiniz gönderin. Dosyanın içeriğini bu başlıklarla upload_url adresine PUT edin. SDK baytları sizin yerinize aktarmaz.
Baytlar ulaştığında dosya işlenir ve upload_status değeri ready olur. ready olana kadar yoklamak için files.retrieve kullanın, ardından id değerini bir kaynağa ekleyin ve son url değerini okuyun.Baytlar sunucunuza hiç uğramadan doğrudan tarayıcıdan yüklemek veya büyük bir dosyayı parçalar hâlinde göndermek için Dosyaları doğrudan yükleyin sayfasına bakın.
SDK’yı başlatın
import { WhopClient } from "@whop/sdk";const client = new WhopClient({ token: process.env.WHOP_API_KEY,});
use whop_sdk::prelude::*;let config = ClientConfig { token: Some(std::env::var("WHOP_API_KEY").expect("WHOP_API_KEY is not set")), ..Default::default()};let client = Whop::new(config).expect("Failed to build client");
Bir dosya yükleyin
Kaydı oluşturun, ardından baytları dönen önceden imzalanmış URL’ye PUT edin.
import { readFile } from "node:fs/promises";// 1. Create the file record and get a presigned upload URLconst file = await client.files.create({ filename: "photo.jpg" });// 2. Send the bytes to storage yourselfconst bytes = await readFile("./photo.jpg");await fetch(file.upload_url!, { method: "PUT", headers: file.upload_headers as Record<string, string>, body: bytes,});console.log(file.id); // file_xxxxxxxxxxxxx — attach it once it's ready
import requests# 1. Create the file record and get a presigned upload URLfile = client.files.create(filename="photo.jpg")# 2. Send the bytes to storage yourselfwith open("./photo.jpg", "rb") as contents: requests.put( file.upload_url, headers=file.upload_headers or {}, data=contents, )print(file.id) # file_xxxxxxxxxxxxx — attach it once it's ready
require "net/http"# 1. Create the file record and get a presigned upload URLfile = client.files.create(filename: "photo.jpg")# 2. Send the bytes to storage yourselfuri = URI(file.upload_url)request = Net::HTTP::Put.new(uri)(file.upload_headers || {}).each { |key, value| request[key] = value }request.body = File.binread("./photo.jpg")Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }puts file.id # file_xxxxxxxxxxxxx — attach it once it's ready
import ( "bytes" "fmt" "net/http" "os")// 1. Create the file record and get a presigned upload URLfile, err := client.Files.Create(context.TODO(), &whopsdk.CreateFilesRequest{ Filename: "photo.jpg",})if err != nil { return err}// 2. Send the bytes to storage yourselfdata, err := os.ReadFile("./photo.jpg")if err != nil { return err}request, err := http.NewRequest(http.MethodPut, *file.UploadURL, bytes.NewReader(data))if err != nil { return err}for key, value := range file.UploadHeaders { request.Header.Set(key, fmt.Sprint(value))}if _, err := http.DefaultClient.Do(request); err != nil { return err}fmt.Println(file.ID) // file_xxxxxxxxxxxxx — attach it once it's ready
// 1. Create the file record and get a presigned upload URLlet file = client .files .create( &CreateFilesRequest { filename: "photo.jpg".to_string(), ..Default::default() }, None, ) .await?;// 2. Send the bytes to storage yourselflet contents = std::fs::read("./photo.jpg")?;let mut request = reqwest::Client::new() .put(file.upload_url.as_deref().unwrap()) .body(contents);if let Some(headers) = &file.upload_headers { for (key, value) in headers { if let Some(value) = value.as_str() { request = request.header(key, value); } }}request.send().await?;println!("{}", file.id); // file_xxxxxxxxxxxxx — attach it once it's ready
Herkese açık ve özel dosyalar
Yüklediğiniz her dosyanın erişimi kontrol eden bir görünürlüğü vardır. Görünürlüğü yükleme sırasında seçersiniz ve daha sonra değiştiremezsiniz.
Görünürlük
URL türü
Kimler erişebilir
Kullanım amacı
private (varsayılan)
Süresi dolan imzalı URL
Yalnızca uygulamanız, API üzerinden
Mesaj ekleri, kullanıcıların yüklediği belgeler, hassas içerik, yapay zekâ tarafından oluşturulan dosyalar
public
Kalıcı, imzasız içerik dağıtım ağı URL’si
Bağlantıya sahip herkes
Ürün görselleri, küçük resimler, marka öğeleri, pazarlama varlıkları
Görünürlüğü yüklemeden önce ayarlayın. Herkese açık dosyalar Whop’un CDN’inde önbelleğe alınır ve URL’ye sahip herkes tarafından erişilebilir; erişimi iptal etmenin bir yolu yoktur. İçerik kullanıcıya özgü veya hassassa varsayılan private değerini koruyun.
Herkese açık bir dosya yükleme
Dosyayı oluştururken public görünürlüğünü iletin, ardından baytları aynı şekilde yükleyin:
const file = await client.files.create({ filename: "product-cover.jpg", visibility: "public",});// PUT the bytes to file.upload_url, then file.url is a permanent CDN URL
file = client.files.create( filename="product-cover.jpg", visibility="public",)# PUT the bytes to file.upload_url, then file.url is a permanent CDN URL
file = client.files.create( filename: "product-cover.jpg", visibility: "public",)# PUT the bytes to file.upload_url, then file.url is a permanent CDN URL
file, err := client.Files.Create(context.TODO(), &whopsdk.CreateFilesRequest{ Filename: "product-cover.jpg", Visibility: whopsdk.CreateFilesRequestVisibilityPublic.Ptr(),})// PUT the bytes to file.UploadURL, then file.URL is a permanent CDN URL
let file = client .files .create( &CreateFilesRequest { filename: "product-cover.jpg".to_string(), visibility: Some(CreateFilesRequestVisibility::Public), ..Default::default() }, None, ) .await?;// PUT the bytes to file.upload_url, then file.url is a permanent CDN URL
Bir dosyayı bir kaynağa eklemek, onu o kaynağın kendi görünürlüğüyle eşleşen depolama alanına taşır. Açıkça belirtilen bir visibility değeri esas olarak, eklemeden doğrudan bağlantı verdiğiniz dosyalar için önemlidir.
Yüklemenin bittiğini doğrulayın
Baytlar ulaştıktan sonra dosya eşzamansız olarak işlenir. upload_status, pending ve processing durumlarından çıkana kadar dosyayı alın. ready olduğunda son url değerini okuyun. failed olduğunda durun ve hatayı gösterin.