> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Dosyaları Doğrudan Yükleyin

> Önceden imzalanmış tek parçalı ve çok parçalı yüklemelerle dosyaları Whop depolama alanına yükleyin

Whop yüklemeleri **doğrudan depolama alanına** yapılır. [Create File](https://docs.whop.com/tr/api-reference/files/create-file.md) ç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.

> [!NOTE]
>
> `/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](https://docs.whop.com/tr/developer/api/versioning.md).

## 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](https://docs.whop.com/tr/api-reference/files/retrieve-file.md) 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.

```bash theme={null}
curl https://api.whop.com/api/v1/files \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Api-Version-Date: 2026-08-21-1" \
  -H "Content-Type: application/json" \
  -d '{ "filename": "terms.pdf", "visibility": "private" }'
```

```json theme={null}
{
  "object": "file",
  "id": "file_XXXXXXXX",
  "filename": "terms.pdf",
  "content_type": "application/pdf",
  "size": null,
  "url": null,
  "removed_by_moderation": false,
  "upload_status": "pending",
  "visibility": "private",
  "created_at": "2026-08-21T18:24:00.000Z",
  "width": null,
  "height": null,
  "blurhash": null,
  "duration_seconds": null,
  "waveform_url": null,
  "upload_url": "https://upload.whop.com/uploads/...&signature=...",
  "upload_headers": { "Content-Type": "application/pdf" },
  "multipart_upload_id": null,
  "multipart_upload_urls": null,
  "multipart_chunk_size": null
}
```

**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.

```bash theme={null}
curl -X PUT "$UPLOAD_URL" \
  -H "Content-Type: application/pdf" \
  --data-binary @terms.pdf
```

> [!WARNING]
>
> Ö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.

```bash theme={null}
curl https://api.whop.com/api/v1/files/file_XXXXXXXX \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Api-Version-Date: 2026-08-21-1"
```

```json theme={null}
{
  "object": "file",
  "id": "file_XXXXXXXX",
  "filename": "terms.pdf",
  "content_type": "application/pdf",
  "size": 82345,
  "url": "https://files.whop.com/...&signature=...",
  "removed_by_moderation": false,
  "upload_status": "ready",
  "visibility": "private",
  "created_at": "2026-08-21T18:24:00.000Z",
  "width": null,
  "height": null,
  "blurhash": null,
  "duration_seconds": null,
  "waveform_url": null
}
```

## Ç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.

```bash theme={null}
curl https://api.whop.com/api/v1/files \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Api-Version-Date: 2026-08-21-1" \
  -H "Content-Type: application/json" \
  -d '{ "filename": "release.mp4", "visibility": "private", "multipart": true, "byte_size": 12582912 }'
```

```json theme={null}
{
  "object": "file",
  "id": "file_XXXXXXXX",
  "filename": "release.mp4",
  "content_type": "video/mp4",
  "size": null,
  "url": null,
  "removed_by_moderation": false,
  "upload_status": "pending",
  "visibility": "private",
  "created_at": "2026-08-21T18:24:00.000Z",
  "width": null,
  "height": null,
  "blurhash": null,
  "duration_seconds": null,
  "waveform_url": null,
  "upload_url": null,
  "upload_headers": {},
  "multipart_upload_id": "2~aBcD1234...",
  "multipart_upload_urls": [
    { "part_number": 1, "url": "https://upload.whop.com/...&part_number=1&signature=..." },
    { "part_number": 2, "url": "https://upload.whop.com/...&part_number=2&signature=..." },
    { "part_number": 3, "url": "https://upload.whop.com/...&part_number=3&signature=..." }
  ],
  "multipart_chunk_size": 5242880
}
```

> [!NOTE]
>
> Ç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.

```javascript theme={null}
import { readFile } from "node:fs/promises";

const bytes = await readFile("./release.mp4");
const chunkSize = created.multipart_chunk_size;

const parts = await Promise.all(
  created.multipart_upload_urls.map(async ({ part_number, url }) => {
    const start = (part_number - 1) * chunkSize;
    const chunk = bytes.subarray(start, start + chunkSize);

    const res = await fetch(url, { method: "PUT", body: chunk });
    if (!res.ok) throw new Error(`Part ${part_number} failed: ${res.status}`);

    // The ETag header comes back quoted, e.g. "\"abc123\"" — send it as-is.
    return { part_number, etag: res.headers.get("etag") };
  }),
);
```

**3. Yüklemeyi tamamlayın**

`multipart_upload_id` değerini ve her parçanın `part_number` + `etag` değerlerini [Complete File Multipart Upload](https://docs.whop.com/tr/api-reference/files/complete-file-multipart-upload.md) uç noktasına iletin. Whop parçaları son dosyada birleştirir.

```bash theme={null}
curl https://api.whop.com/api/v1/files/file_XXXXXXXX/complete \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Api-Version-Date: 2026-08-21-1" \
  -H "Content-Type: application/json" \
  -d '{
    "multipart_upload_id": "2~aBcD1234...",
    "multipart_parts": [
      { "part_number": 1, "etag": "\"5eb63bbbe01eeed093cb22bb8f5acdc3\"" },
      { "part_number": 2, "etag": "\"9e107d9d372bb6826bd81d3542a419d6\"" },
      { "part_number": 3, "etag": "\"e4d909c290d0fb1ca068ffaddf22cbd0\"" }
    ]
  }'
```

> [!WARNING]
>
> 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:

| Görünürlük | Aldığınız `url` | Kullanım alanı |
| - | - | - |
| `private` (varsayılan) | Süresi dolan imzalı URL | Yasal belgeler, itiraz kanıtları, kullanıcı yüklemeleri |
| `public` | Kalıcı, imzasız içerik dağıtım ağı URL'si | Ürün görselleri, küçük resimler, marka öğeleri, pazarlama varlıkları |

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](https://docs.whop.com/tr/developer/guides/upload-files.md#accessing-private-files) 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](https://docs.whop.com/tr/api-reference/disputes/dispute) kanıtlarına veya bir hesabın yasal belgelerine.

## Sonraki adımlar

> [card] [Dosya yükleme (SDK)](https://docs.whop.com/tr/developer/guides/upload-files.md)
>
> SDK'nın `files.create` ve `files.retrieve` yöntemlerinin bu akışı nasıl sarmaladığı.

> [card] [Create File](https://docs.whop.com/tr/api-reference/files/create-file.md)
>
> Oluşturma uç noktası için eksiksiz istek ve yanıt referansı.

> [card] [Complete File Multipart Upload](https://docs.whop.com/tr/api-reference/files/complete-file-multipart-upload.md)
>
> Çok parçalı yükleme parçalarını birleştirme referansı.

> [card] [API sürümleri](https://docs.whop.com/tr/developer/api/versioning.md)
>
> `Api-Version-Date` başlığının neden önemli olduğu ve nasıl sabitleneceği.


## Related topics

- [Dosya Yükleme](https://docs.whop.com/tr/developer/guides/upload-files.md)
- [Doğrulama RFI'lerini Yönetme](https://docs.whop.com/tr/developer/verification/rfis.md)
- [Whop CLI Komutları](https://docs.whop.com/tr/cli/commands.md)
