API belgeleri
Bir dosyayı bir kez yükleyin, seçtiğiniz dosya barındırma sitelerine gönderin ve tek bir paylaşım bağlantısı alın — kendi kodunuzdan.
Güncellendi
Sürümlü bir REST API: bir dosyayı parçalar hâlinde yükleyin, seçtiğiniz sitelere gönderin; her kopya canlı durumuyla tek bir paylaşım sayfasında toplanır.
- Temel URL
- https://api.mirroruploadx.com/api/v1
- Kimlik doğrulama
- x-api-key: mux_…
1Oturum açın
POST /
api/ v1/ upload-sessions filename + sizeBytes; sessionId ve chunkSize alın
2Parçaları gönderin
PATCH /
api/ v1/ upload-sessions/ {id}/ chunks sırayla ham baytlar; dosyayı tamamlayan yanıtta fileId bulunur
3Dağıtın
POST /
api/ v1/ mirror-tasks/ start fileId + providerSlugs; ardından işi sorgulayın
Bir anahtarı API anahtarları sayfasında oluşturun. Kod içeren tam anlatım Yükleme ve dağıtım bölümündedir.
Kimlik doğrulama
Panelinizdeki API anahtarları sayfasında bir anahtar oluşturun. Anahtarın tamamı (mux_ ile başlar) yalnızca bir kez gösterilir, bu yüzden hemen saklayın. Her istekte anahtarı x-api-key başlığında gönderin; yalnızca bearer token kullanabilen istemciler için Authorization: Bearer mux_… de aynı şekilde kabul edilir.
Anahtarlar kapsamlıdır: bir anahtar yalnızca kapsamlarının kapsadığı uç noktalara ulaşır ve yanlış kapsamla yapılan bir çağrı, mesajda gereken kapsamla birlikte 403 INSUFFICIENT_SCOPE döndürür. Hesap ayarlarına, anahtar yönetimine ve webhook’lara API anahtarıyla hiç ulaşılamaz (API_KEY_NOT_ALLOWED).
| Kapsam | Erişim |
|---|---|
upload:write | Yükleme oturumları (oluşturma, parçalar, tamamlama, iptal), yükleme kotanız, bir yüklemenin otomatik dağıtımını bekletme veya değiştirme (hold-distribution, distribution-intent), uzak URL yüklemeleri, dağıtımı başlatma |
file:read | Dosyaları listeleme, dosya ayrıntıları, ayna ve iş durumu |
file:write | Bir dosyanın paylaşım ayarları |
file:delete | Bir dosyayı ve aynalarını silme |
Uç noktalar
Bir API anahtarının ulaşabildiği her şey ve anahtar gerektirmeyen herkese açık uç noktalar. Kapsam sütununda iki kapsam yazıyorsa ikisinden biri yeterlidir. Her birinin istek ve yanıt şemaları API başvurusunda yer alır.
| Yöntem | Yol | Kapsam | Ne yapar |
|---|---|---|---|
| POST | / | upload:write | Bir yükleme oturumu açar (isteğe bağlı olarak bir dağıtım planıyla) |
| PATCH | / | upload:write | Sonraki bayt parçasını gönderir |
| HEAD | / | upload:write | Nereden devam edileceği: Upload-Offset başlığı |
| GET | / | upload:writefile:read | Oturum durumu: alınan baytlar, fileId, finalizable |
| GET | / | upload:writefile:read | Yükleme sınırlarınız, kullanımınız ve tamamlanmamış oturumlarınız |
| POST | / | upload:write | Son yanıtı kaybolan bir yüklemeyi tamamlar (yeniden denemesi güvenlidir) |
| POST | / | upload:write | Ertelenmiş bir dağıtımın kendiliğinden başlamasını durdurur |
| PUT | / | upload:write | Bir yüklemenin dağıtım planını değiştirir |
| DELETE | / | upload:write | Tamamlanmamış bir yüklemeyi iptal eder ve yerini boşaltır |
| POST | / | upload:write | http(s) URL’lerinden dosyaları hesabınıza getirir |
| POST | / | upload:write | Bir dosyayı seçtiğiniz sitelere gönderir |
| GET | / | upload:writefile:read | İş durumu, her site ve paylaşım bağlantısı (shareTakenDown kaldırılmış bir sayfayı işaretler) |
| GET | / | file:read | Dosyalarınızı listeler (imleçle sayfalama, arama, filtreler) |
| GET | / | file:read | Tek dosya: boyut, sağlama toplamı, iş, paylaşım ayarları, istatistikler |
| GET | / | file:read | Bir dosyanın her kopyası: site, bağlantı, sağlık, tıklamalar |
| PATCH | / | file:write | Paylaşım parolası, bitiş tarihi, görünürlük |
| DELETE | / | file:delete | Bir dosyayı ve (varsayılan olarak) sitelerdeki kopyalarını siler |
| GET | / | yok (herkese açık) | Güncel sınırlar: en büyük dosya, dosya başına site sayısı, URL yükleme sınırları |
| GET | / | yok (herkese açık) | providerSlugs içinde gönderdiğiniz slug’larla birlikte site kataloğu |
| GET | / | yok (herkese açık) | Site başına ölçülen yükleme başarısı |
| GET | / | yok (herkese açık) | Son 30 günün platform toplamları: dosyalar, canlı aynalar, başarı oranı |
Bir dosyayı yükleyin ve dağıtın
POST /api/v1/upload-sessionsile bir oturum açın.filenamevesizeBytes(tam bayt uzunluğu) zorunludur;mimeTypeve bir UUIDidempotencyKeyisteğe bağlıdır — aynı anahtarla bir isteği tekrarlamak ikinci bir oturum açmak yerine mevcut oturumu döndürür. Yanıttadata.sessionId(iddeğil) vedata.chunkSizebulunur.PATCH /api/v1/upload-sessions/{id}/chunksile baytları gönderin: ham baytlar, içerik türüapplication/offset+octet-streamve parçanın başlangıç konumuupload-offsetbaşlığında. Parçalar sırayla ya da en fazlamaxChunksAheadparça ileriden gider; sırayla gönderirken her yanıttakidata.uploadedBytesdeğerini sonraki ofset olarak kullanın.chunkSizebaytlık parçalar gönderin; sonuncusu dışındaki her parça en az 5 MiB olmalıdır ve bir yükleme en fazla 10 000 parçadan oluşabilir. Dosyayı tamamlayan yanıttadata.fileIdbulunur. Daha fazla hız için aynı dosyanın 2–3 parçasını aynı anda gönderebilirsiniz. İlk parçayı tek başına gönderin; yanıtı gerçekdata.maxChunksAheaddeğerini verir (ilk parça tam birchunkSizedilimiyse 4, 0 = yalnızca sırayla). İlk parça tam birchunkSizedilimiyse sonraki her parça da (sırayla ya da ileriden) öyle olmalıdır:chunkSizedeğerinin bir katında başlar ve tam olarakchunkSizebayttır (sonuncusu: dosyanın geri kalanı).uploadedBytesdeğerinin ilerisinden gönderilen bir parça böyle bir dilim olmalı ve en fazladata.maxChunksAheadparça ileride başlamalıdır; aksi hâlde409 CHUNK_MISALIGNEDveya409 CHUNK_OUT_OF_WINDOWalır.uploadedBytesyalnızca boşluksuz alınan baytları sayar ve dosyayı hangi parça tamamlarsafileIdiçeren yanıtı o alır. Zaten ulaşmış bir parçayı yeniden göndermek zararsız bir başarıdır.POST /api/v1/mirror-tasks/startile dağıtın:fileIdveproviderSlugszorunludur (slug’larGET /api/v1/providersile alınır). İsteğe bağlı:minSuccess(varsayılan 1 — işin başarısız olmaması için dosyayı kaç sitenin kabul etmesi gerektiği; yalnızca her site de dosyayı aldığındacompleted, aksi hâldepartially_completedolur. Bu dosya türünü reddeden siteler sayılmaz),sharePassword,expiresInDaysveyaexpiresAt. YanıttauploadJobId,taskCount,shareSlug,alreadyStartedveskipped[]bulunur — bu dosyayı alamayan bir site başarısız değil, atlanmış sayılır; bu yüzdenskipped[]alanını okuyun (nedenler aşağıda listelenmiştir). Bir dosya şu anda en fazla 50 siteye gönderilebilir.data.terminaldeğeritrueolana kadar birkaç saniyede birGET /api/v1/mirror-tasks/{uploadJobId}ile bitişini izleyin. Yanıt her siteyitasks[]içinde (providerSlug,status,mirrorUrl,errorCode), paylaşım bağlantısını isedata.shareUrliçinde listeler. O paylaşım sayfası kaldırılmışsa ve artık açılmıyorsadata.shareTakenDowndeğeritrueolur.
Şu anda kabul edilen en büyük dosya boyutu: 5,00 GB.
bash, jq gerekir
set -euo pipefail
API=https://api.mirroruploadx.com
FILE=clip.mp4
SIZE=$(wc -c < "$FILE" | tr -d ' ')
# 1. Open an upload session
SESSION_JSON=$(curl -sS --fail-with-body -X POST "$API/api/v1/upload-sessions" \
-H "x-api-key: $MUX_API_KEY" -H "content-type: application/json" \
-d '{"filename":"clip.mp4","sizeBytes":'"$SIZE"',"mimeType":"video/mp4"}')
SESSION=$(echo "$SESSION_JSON" | jq -r .data.sessionId)
CHUNK=$(echo "$SESSION_JSON" | jq -r .data.chunkSize)
# 2. Send the bytes in order, one chunk per request
OFFSET=0
while [ "$OFFSET" -lt "$SIZE" ]; do
dd if="$FILE" of=part.bin bs="$CHUNK" skip=$((OFFSET / CHUNK)) count=1 status=none
REPLY=$(curl -sS --fail-with-body -X PATCH "$API/api/v1/upload-sessions/$SESSION/chunks" \
-H "x-api-key: $MUX_API_KEY" \
-H "upload-offset: $OFFSET" \
-H "content-type: application/offset+octet-stream" \
--data-binary @part.bin)
OFFSET=$(echo "$REPLY" | jq -r .data.uploadedBytes)
done
FILE_ID=$(echo "$REPLY" | jq -r .data.fileId)
# 3. Distribute to the hosts you pick
JOB=$(curl -sS --fail-with-body -X POST "$API/api/v1/mirror-tasks/start" \
-H "x-api-key: $MUX_API_KEY" -H "content-type: application/json" \
-d '{"fileId":"'"$FILE_ID"'","providerSlugs":["gofile","pixeldrain"],"minSuccess":1}' \
| jq -r .data.uploadJobId)
# 4. Poll until the job is terminal, then print the share link
until curl -sS --fail-with-body "$API/api/v1/mirror-tasks/$JOB" \
-H "x-api-key: $MUX_API_KEY" > job.json \
&& [ "$(jq -r .data.terminal job.json)" = "true" ]; do
sleep 5
done
jq -r '.data.status, .data.shareUrl' job.jsonrequests
import os, time, requests
API = "https://api.mirroruploadx.com"
H = {"x-api-key": os.environ["MUX_API_KEY"]}
def call(method, path, headers=None, **kw):
r = requests.request(method, API + path, headers={**H, **(headers or {})}, timeout=120, **kw)
body = r.json()
if not body.get("success"):
err = body["error"]
raise RuntimeError(f'{r.status_code} {err["code"]}: {err["message"]}')
return body["data"]
path = "clip.mp4"
size = os.path.getsize(path)
# 1. Open an upload session
s = call("POST", "/api/v1/upload-sessions",
json={"filename": os.path.basename(path), "sizeBytes": size, "mimeType": "video/mp4"})
session, chunk = s["sessionId"], s["chunkSize"]
# 2. Send the bytes in order; the reply says where to continue
offset, last = 0, None
with open(path, "rb") as f:
while offset < size:
f.seek(offset)
last = call("PATCH", f"/api/v1/upload-sessions/{session}/chunks",
headers={"upload-offset": str(offset),
"content-type": "application/offset+octet-stream"},
data=f.read(chunk))
offset = last["uploadedBytes"]
file_id = last["fileId"]
# 3. Distribute
job = call("POST", "/api/v1/mirror-tasks/start",
json={"fileId": file_id, "providerSlugs": ["gofile", "pixeldrain"], "minSuccess": 1})
for sk in job["skipped"]:
print("skipped", sk["slug"], sk["reason"], sk["detail"])
# 4. Poll until terminal
job_id = job["uploadJobId"]
while True:
st = call("GET", f"/api/v1/mirror-tasks/{job_id}")
if st["terminal"]:
break
time.sleep(5)
print(st["status"], st["shareUrl"])
for t in st["tasks"]:
print(t["providerSlug"], t["status"], t["mirrorUrl"] or t["errorCode"])Node.js 18+, fetch
// Node.js 18+ (global fetch), ES module
import { open, stat } from 'node:fs/promises';
import { basename } from 'node:path';
const API = 'https://api.mirroruploadx.com';
const KEY = process.env.MUX_API_KEY;
async function call(method, path, { json, body, headers = {} } = {}) {
const res = await fetch(API + path, {
method,
headers: { 'x-api-key': KEY, ...(json ? { 'content-type': 'application/json' } : {}), ...headers },
body: json ? JSON.stringify(json) : body,
});
const out = await res.json();
if (!out.success) throw new Error(`${res.status} ${out.error.code}: ${out.error.message}`);
return out.data;
}
const path = 'clip.mp4';
const { size } = await stat(path);
// 1. Open an upload session
const { sessionId, chunkSize } = await call('POST', '/api/v1/upload-sessions', {
json: { filename: basename(path), sizeBytes: size, mimeType: 'video/mp4' },
});
// 2. Send the bytes in order; the reply says where to continue
const fh = await open(path);
let offset = 0;
let last;
while (offset < size) {
const buf = Buffer.alloc(Math.min(chunkSize, size - offset));
await fh.read(buf, 0, buf.length, offset);
last = await call('PATCH', `/api/v1/upload-sessions/${sessionId}/chunks`, {
headers: { 'upload-offset': String(offset), 'content-type': 'application/offset+octet-stream' },
body: buf,
});
offset = last.uploadedBytes;
}
await fh.close();
// 3. Distribute
const job = await call('POST', '/api/v1/mirror-tasks/start', {
json: { fileId: last.fileId, providerSlugs: ['gofile', 'pixeldrain'], minSuccess: 1 },
});
for (const s of job.skipped) console.log('skipped', s.slug, s.reason, s.detail);
// 4. Poll until terminal
let st;
do {
await new Promise((r) => setTimeout(r, 5000));
st = await call('GET', `/api/v1/mirror-tasks/${job.uploadJobId}`);
} while (!st.terminal);
console.log(st.status, st.shareUrl);
for (const t of st.tasks) console.log(t.providerSlug, t.status, t.mirrorUrl ?? t.errorCode);PHP 8.1+, ext-curl
<?php
// PHP 8.1+, built-in ext-curl and ext-json only (no Composer)
declare(strict_types=1);
const API = 'https://api.mirroruploadx.com';
function call(string $method, string $path, ?array $json = null, ?string $body = null, array $headers = []): array
{
$h = ['x-api-key: ' . getenv('MUX_API_KEY'), 'expect:']; // no 100-continue round trip
if ($json !== null) {
$h[] = 'content-type: application/json';
$body = json_encode($json, JSON_THROW_ON_ERROR);
}
foreach ($headers as $k => $v) {
$h[] = "$k: $v";
}
$ch = curl_init(API . $path);
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => $method,
CURLOPT_HTTPHEADER => $h,
CURLOPT_RETURNTRANSFER => true,
// no total cap (a large part can take minutes); give up on a stalled transfer instead
CURLOPT_TIMEOUT => 0,
CURLOPT_CONNECTTIMEOUT => 15,
CURLOPT_LOW_SPEED_LIMIT => 1024, // bytes per second
CURLOPT_LOW_SPEED_TIME => 60,
]);
if ($body !== null) {
curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
}
$raw = curl_exec($ch);
if ($raw === false) {
throw new RuntimeException('network error: ' . curl_error($ch));
}
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$out = json_decode($raw, true, 512, JSON_THROW_ON_ERROR);
if (empty($out['success'])) {
$err = $out['error'];
throw new RuntimeException("$status {$err['code']}: {$err['message']}");
}
return $out['data'];
}
$path = 'clip.mp4';
$size = filesize($path);
// 1. Open an upload session
$s = call('POST', '/api/v1/upload-sessions',
json: ['filename' => basename($path), 'sizeBytes' => $size, 'mimeType' => 'video/mp4']);
$session = $s['sessionId'];
$chunk = $s['chunkSize'];
// 2. Send the bytes in order, one chunk in memory at a time; the reply says where to continue
$fh = fopen($path, 'rb');
$offset = 0;
$last = null;
while ($offset < $size) {
fseek($fh, $offset);
$last = call('PATCH', "/api/v1/upload-sessions/$session/chunks", body: fread($fh, $chunk), headers: [
'upload-offset' => (string) $offset,
'content-type' => 'application/offset+octet-stream',
]);
$offset = $last['uploadedBytes'];
}
fclose($fh);
$fileId = $last['fileId'];
// 3. Distribute
$job = call('POST', '/api/v1/mirror-tasks/start',
json: ['fileId' => $fileId, 'providerSlugs' => ['gofile', 'pixeldrain'], 'minSuccess' => 1]);
foreach ($job['skipped'] as $sk) {
echo "skipped {$sk['slug']} {$sk['reason']} {$sk['detail']}\n";
}
// 4. Poll until terminal
$jobId = $job['uploadJobId'];
do {
sleep(5);
$st = call('GET', "/api/v1/mirror-tasks/$jobId");
} while (!$st['terminal']);
echo "{$st['status']} {$st['shareUrl']}\n";
foreach ($st['tasks'] as $t) {
echo $t['providerSlug'], ' ', $t['status'], ' ', $t['mirrorUrl'] ?? $t['errorCode'], "\n";
}Örnek yanıtlar
Oturum açma 201 ile yanıt verir. Sonuncusu dışındaki her parça { uploadedBytes, completed: false, expiresAt } ile yanıt verir; sonuncusu dosyayı taşır. distribution yalnızca oturumu açarken bir plan verdiyseniz bulunur (aşağıya bakın).
{
"success": true,
"data": {
"sessionId": "…",
"uploadedBytes": 0,
"chunkSize": 8388608,
"maxChunksAhead": 0
}
}{
"success": true,
"data": {
"uploadedBytes": 10485760,
"completed": true,
"fileId": "…",
"scan": "skipped",
"distributable": true,
"distribution": {
"started": true,
"uploadJobId": "…",
"taskCount": 2,
"shareSlug": "…",
"skipped": []
}
}
}{
"success": true,
"data": {
"uploadJobId": "…",
"taskCount": 2,
"shareSlug": "…",
"skipped": [],
"alreadyStarted": false
}
}{
"success": true,
"data": {
"uploadJobId": "…",
"status": "completed",
"terminal": true,
"shareSlug": "…",
"shareUrl": "https://mirroruploadx.com/f/…",
"shareTakenDown": false,
"minSuccess": 1,
"scan": "skipped",
"tasks": [
{
"provider": "Gofile",
"providerSlug": "gofile",
"status": "succeeded",
"attempts": 1,
"errorCode": null,
"viaOwnAccount": false,
"errorMessage": null,
"mirrorUrl": "https://gofile.io/d/…",
"mirrorHidden": false
},
{
"provider": "Pixeldrain",
"providerSlug": "pixeldrain",
"status": "succeeded",
"attempts": 1,
"errorCode": null,
"viaOwnAccount": false,
"errorMessage": null,
"mirrorUrl": "https://pixeldrain.com/u/…",
"mirrorHidden": false
}
]
}
}İlk ve başarılı bir start 202 ile yanıt verir; zaten çalışan bir iş için yeniden çağırmak alreadyStarted: true ile 200 döndürür. Bir sitenin bağlantısı politika gereği gizli tutulduğunda mirrorUrl değeri null ve mirrorHidden değeri true olur — paylaşım sayfası onu yine de listeler.
İkinci çağrıyı atlayın
Oturumu açarken distribution verirseniz sunucu, dosya tamamlanır tamamlanmaz dağıtıma başlar. Dosyayı tamamlayan yanıttaki data.distribution alanını kontrol edin: started: true, işin kuyruğa alındığı anlamına gelir (uploadJobId, shareSlug). started: false ve deferred: true ile henüz bilerek hiçbir şey kuyruğa alınmamıştır — aşağıya bakın. started: false olup deferred yoksa yükleme yine de başarılı olmuştur ancak dağıtım başlatılamamıştır (error nedenini söyler): fileId ile POST /api/v1/mirror-tasks/start çağırın. deferred: true ile birlikte bir error, geçici bir hata anlamına gelir (örneğin tüm siteler yoğun veya bakımda): start çağırmayın veya dosyayı yeniden yüklemeyin — sunucu dağıtımı başlatmayı autoStartAt zamanından itibaren kendisi yeniden dener (en fazla 5 deneme). Durdurmak için hold-distribution çağırın.
curl -sS -X POST "https://api.mirroruploadx.com/api/v1/upload-sessions" \
-H "x-api-key: $MUX_API_KEY" -H "content-type: application/json" \
-d '{
"filename": "clip.mp4",
"sizeBytes": 10485760,
"mimeType": "video/mp4",
"distribution": { "providerSlugs": ["gofile", "pixeldrain"], "minSuccess": 1 }
}'
# The reply to the final chunk then carries data.distribution:
# { "started": true, "uploadJobId": "…", "taskCount": 2, "shareSlug": "…", "skipped": [] }
# or { "started": false, "error": { "code": "…", "message": "…" } }Bir bekleme süresi için distribution alanına deferred: true ekleyin: son yanıt { started: false, deferred: true, autoStartAt } olur ve siz önce start çağırmazsanız sunucu dağıtımı autoStartAt zamanında (yaklaşık 2 dakika sonra) kendisi başlatır. Otomatik başlatmayı durdurmak için POST /api/v1/upload-sessions/{id}/hold-distribution çağırın (gövde yok; autoStartAt değeri null olur ve dağıtımı siz başlatırsınız). Bunun yerine planı değiştirmek için distribution ile aynı alanlarla (providerSlugs, minSuccess, expiresInDays, sharePassword) PUT /api/v1/upload-sessions/{id}/distribution-intent çağırın: planı değiştirir ve beklemeyi kaldırır; yükleme bittiyse otomatik başlatma, çağrıdan en az 2 dakika sonrasına kayar. Dağıtım zaten başladıysa ikisi de 200 ile yanıt verir ve distribution-intent alreadyStarted: true döndürür.
30 dakika içinde başlatın. Bir yükleme bittiğinde ve hiçbir dağıtım başlatılmadığında, dosyanın bizdeki kopyası 30 dakika sonra kaldırılır (sitelerin kullanılabilir hâle gelmesini bekleyen bir dağıtım planı varsa en fazla 72 saat sonra; uzak URL yüklemeleri etkilenmez). Bundan sonra start ve distribution-intent 409 SOURCE_GONE ile yanıt verir ve dosyanın yeniden yüklenmesi gerekir.
Son yanıt kaybolursa
GET /api/v1/upload-sessions/{id} çağırın: bir fileId dosyanın var olduğu anlamına gelir; finalizable: true her baytın ulaştığı ve POST /api/v1/upload-sessions/{id}/complete çağrısının yüklemeyi tamamlayacağı anlamına gelir. Bu çağrıyı yeniden denemek güvenlidir ve asla ikinci bir dosya oluşturmaz. Uyuşmayan bir ofset 409 CHUNK_OFFSET_CONFLICT alır — oturuma HEAD gönderin ve Upload-Offset başlığından devam edin. Çalışan bir iş için start çağrısını yinelemek hata değildir: alreadyStarted: true ile 200 alırsınız.
Bir URL’den yükleme
POST /api/v1/remote-uploads, { "urls": [...] } alır ve her dosyayı sizin için getirir (kapsam upload:write). Yalnızca http ve https bağlantıları getirilir, özel ağ adresleri reddedilir ve yalnızca sınırlı sayıda yönlendirme izlenir. Tek bir istek en fazla 10 URL taşır (GET /api/v1/platform tarafından döndürülür); daha uzun listeleri bölün.
Dosya başına boyut sınırı kaynağa bağlıdır. Kaynak dosyanın boyutunu bildiriyorsa her dosya en fazla 5,00 GB (limits.remoteUploadPassthroughMaxBytes), bildirmiyorsa en fazla 100,0 MB (limits.remoteUploadMaxBytes) olabilir. Dosya adı, gönderdiğinde kaynağın Content-Disposition başlığından alınır; uzantısız bir ada dosyanın türüne göre bir uzantı eklenir.
İstek, dosyalar indirilirken bekler. Bağlantı önce koparsa dosya yine de hesabınıza ulaşır — onu GET /api/v1/files ile bulun. Her fileId ardından yukarıdaki gibi POST /api/v1/mirror-tasks/start ile dağıtılır.
Geçici depolama alanı dolu olduğunda isteğin tamamı details.reason: "staging_full" ve bir Retry-After başlığıyla birlikte 503 TEMPORARILY_UNAVAILABLE alır. Yalnızca bir URL sığmıyorsa results[] içindeki o girdide ok: false ve aynı kod bulunur; URL başına bir sonuçta başlık olmadığından saniye cinsinden bekleme süresi details.retryAfter içindedir.
curl -sS -X POST "https://api.mirroruploadx.com/api/v1/remote-uploads" \
-H "x-api-key: $MUX_API_KEY" -H "content-type: application/json" \
-d '{"urls":["https://example.com/files/archive.zip"]}'
# One result per URL, in order. A failed URL does not fail the batch:
# {"success":true,"data":{"results":[
# {"url":"https://example.com/files/archive.zip","ok":true,
# "fileId":"…","scan":…,"distributable":true}
# ]}}
# or {"url":"…","ok":false,"code":"REMOTE_TOO_LARGE","error":"…"}
#
# Then distribute each fileId with POST /api/v1/mirror-tasks/start.PHP 8.1+, ext-curl
<?php
// PHP 8.1+, built-in ext-curl and ext-json only (no Composer)
$ch = curl_init('https://api.mirroruploadx.com/api/v1/remote-uploads');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ['x-api-key: ' . getenv('MUX_API_KEY'), 'content-type: application/json'],
CURLOPT_POSTFIELDS => json_encode(['urls' => ['https://example.com/files/archive.zip']], JSON_THROW_ON_ERROR),
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 0, // the request waits while the files download
]);
$raw = curl_exec($ch);
if ($raw === false) {
throw new RuntimeException('network error: ' . curl_error($ch));
}
$out = json_decode($raw, true, 512, JSON_THROW_ON_ERROR);
if (empty($out['success'])) {
throw new RuntimeException("{$out['error']['code']}: {$out['error']['message']}");
}
// One result per URL, in order. A failed URL does not fail the batch.
foreach ($out['data']['results'] as $r) {
echo $r['ok']
? "{$r['url']} -> {$r['fileId']}\n"
: "{$r['url']} failed: {$r['code']} {$r['error']}\n";
}
// Then distribute each fileId with POST /api/v1/mirror-tasks/start.Dosya yönetimi
Dosyalarınız yüklemeden sonra hesabınızda kalır. Onları GET /api/v1/files ile listeleyin (limit en fazla 100; sonraki sayfa için yanıttaki nextCursor değerini cursor olarak verin, q ada göre arar). GET /api/v1/files/{id} tek bir dosyayı işi, paylaşım ayarları ve görüntüleme istatistikleriyle döndürür; GET /api/v1/files/{id}/mirrors her kopyayı bağlantısı, sağlığı ve tıklamalarıyla listeler.
PATCH /api/v1/files/{id}/share (kapsam file:write) paylaşım sayfasını değiştirir: password (4–128 karakter, null kaldırır — asla döndürülmez, yalnızca passwordProtected döner), expiresAt (ISO tarih, bitiş olmaması için null), visibility ve hideDownloadCount. Yalnızca değiştirmek istediğiniz alanları gönderin. DELETE /api/v1/files/{id} (kapsam file:delete) dosyayı kaldırır ve sitelerdeki kopyalarını silinmek üzere kuyruğa alır; onları tutmak için ?keepMirrors=true ekleyin. Bazı siteler silmeyi desteklemez, bu yüzden orada bir kopya kalabilir.
bash, jq gerekir; FILE_ID ayarlayın
API=https://api.mirroruploadx.com
H="x-api-key: $MUX_API_KEY"
# List your files, newest first (20 per page; pass ?cursor=<nextCursor> for more)
curl -sS "$API/api/v1/files?limit=20" -H "$H" | jq '.data.items[] | {id, name, mirrorCount, shareSlug}'
# One file, then every copy of it
curl -sS "$API/api/v1/files/$FILE_ID" -H "$H"
curl -sS "$API/api/v1/files/$FILE_ID/mirrors" -H "$H" | jq '.data.mirrors[] | {providerSlug, status, url}'
# Share settings: a password and an expiry date (null removes either)
curl -sS -X PATCH "$API/api/v1/files/$FILE_ID/share" -H "$H" -H "content-type: application/json" \
-d '{"password":"correct-horse","expiresAt":"2026-12-31T23:59:59Z"}'
# Delete the file and its copies on hosts (?keepMirrors=true keeps the copies)
curl -sS -X DELETE "$API/api/v1/files/$FILE_ID" -H "$H"requests; FILE_ID ayarlayın
import os, requests
API = "https://api.mirroruploadx.com"
H = {"x-api-key": os.environ["MUX_API_KEY"]}
file_id = os.environ["FILE_ID"]
def call(method, path, **kw):
body = requests.request(method, API + path, headers=H, timeout=60, **kw).json()
if not body.get("success"):
raise RuntimeError(f'{body["error"]["code"]}: {body["error"]["message"]}')
return body["data"]
# List your files, page by page
cursor = None
while True:
page = call("GET", "/api/v1/files", params={"limit": 100, **({"cursor": cursor} if cursor else {})})
for f in page["items"]:
print(f["id"], f["name"], f"{f['mirrorCount']}/{f['mirrorTotal']} mirrors")
cursor = page["nextCursor"]
if not cursor:
break
# One file, then every copy of it
print(call("GET", f"/api/v1/files/{file_id}")["share"])
for m in call("GET", f"/api/v1/files/{file_id}/mirrors")["mirrors"]:
print(m["providerSlug"], m["status"], m["url"])
# Share settings: a password and an expiry date (None removes either)
print(call("PATCH", f"/api/v1/files/{file_id}/share",
json={"password": "correct-horse", "expiresAt": "2026-12-31T23:59:59Z"}))
# Delete the file and its copies on hosts
print(call("DELETE", f"/api/v1/files/{file_id}")["note"])Node.js 18+, ES modülü; FILE_ID ayarlayın
const API = 'https://api.mirroruploadx.com';
const KEY = process.env.MUX_API_KEY;
const fileId = process.env.FILE_ID;
async function call(method, path, json) {
const res = await fetch(API + path, {
method,
headers: { 'x-api-key': KEY, ...(json ? { 'content-type': 'application/json' } : {}) },
body: json ? JSON.stringify(json) : undefined,
});
const out = await res.json();
if (!out.success) throw new Error(`${res.status} ${out.error.code}: ${out.error.message}`);
return out.data;
}
// List your files, page by page
let cursor = null;
do {
const page = await call('GET', `/api/v1/files?limit=100${cursor ? `&cursor=${cursor}` : ''}`);
for (const f of page.items) console.log(f.id, f.name, `${f.mirrorCount}/${f.mirrorTotal} mirrors`);
cursor = page.nextCursor;
} while (cursor);
// One file, then every copy of it
console.log((await call('GET', `/api/v1/files/${fileId}`)).share);
for (const m of (await call('GET', `/api/v1/files/${fileId}/mirrors`)).mirrors) {
console.log(m.providerSlug, m.status, m.url);
}
// Share settings: a password and an expiry date (null removes either)
console.log(await call('PATCH', `/api/v1/files/${fileId}/share`, {
password: 'correct-horse',
expiresAt: '2026-12-31T23:59:59Z',
}));
// Delete the file and its copies on hosts
console.log((await call('DELETE', `/api/v1/files/${fileId}`)).note);PHP 8.1+, ext-curl; FILE_ID ayarlayın
<?php
// PHP 8.1+, built-in ext-curl and ext-json only (no Composer)
declare(strict_types=1);
const API = 'https://api.mirroruploadx.com';
$fileId = getenv('FILE_ID');
function call(string $method, string $path, ?array $json = null, ?string $body = null, array $headers = []): array
{
$h = ['x-api-key: ' . getenv('MUX_API_KEY'), 'expect:']; // no 100-continue round trip
if ($json !== null) {
$h[] = 'content-type: application/json';
$body = json_encode($json, JSON_THROW_ON_ERROR);
}
foreach ($headers as $k => $v) {
$h[] = "$k: $v";
}
$ch = curl_init(API . $path);
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => $method,
CURLOPT_HTTPHEADER => $h,
CURLOPT_RETURNTRANSFER => true,
// no total cap (a large part can take minutes); give up on a stalled transfer instead
CURLOPT_TIMEOUT => 0,
CURLOPT_CONNECTTIMEOUT => 15,
CURLOPT_LOW_SPEED_LIMIT => 1024, // bytes per second
CURLOPT_LOW_SPEED_TIME => 60,
]);
if ($body !== null) {
curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
}
$raw = curl_exec($ch);
if ($raw === false) {
throw new RuntimeException('network error: ' . curl_error($ch));
}
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$out = json_decode($raw, true, 512, JSON_THROW_ON_ERROR);
if (empty($out['success'])) {
$err = $out['error'];
throw new RuntimeException("$status {$err['code']}: {$err['message']}");
}
return $out['data'];
}
// List your files, page by page (http_build_query drops a null cursor)
$cursor = null;
do {
$page = call('GET', '/api/v1/files?' . http_build_query(['limit' => 100, 'cursor' => $cursor]));
foreach ($page['items'] as $f) {
echo "{$f['id']} {$f['name']} {$f['mirrorCount']}/{$f['mirrorTotal']} mirrors\n";
}
$cursor = $page['nextCursor'];
} while ($cursor);
// One file, then every copy of it
print_r(call('GET', "/api/v1/files/$fileId")['share']);
foreach (call('GET', "/api/v1/files/$fileId/mirrors")['mirrors'] as $m) {
echo "{$m['providerSlug']} {$m['status']} {$m['url']}\n";
}
// Share settings: a password and an expiry date (null removes either)
print_r(call('PATCH', "/api/v1/files/$fileId/share",
json: ['password' => 'correct-horse', 'expiresAt' => '2026-12-31T23:59:59Z']));
// Delete the file and its copies on hosts
echo call('DELETE', "/api/v1/files/$fileId")['note'], "\n";{
"success": true,
"data": {
"stagingDeleted": true,
"mirrorsQueued": true,
"mirrorsPurgeDeferred": false,
"note": "File removed. Copies on providers are being deleted; some may remain on providers that do not support deletion."
}
}Webhook’lar
Webhook’lar sayfasında bir uç nokta ekleyin. URL https:// kullanmalıdır; imzalama sırrı (whsec_…) oluşturduğunuzda bir kez gösterilir. Hiçbir olay seçilmemiş bir uç nokta tüm olayları alır.
| Olay | Ne zaman |
|---|---|
upload.completed | Her site dosyayı kabul etti ve en az minSuccess kadarı kabul etti — bu dosyayı reddeden (rejected) veya iptal edilen siteler sayılmaz |
upload.partially_completed | En az minSuccess kadar site dosyayı kabul etti, ancak en az bir başka site başarısız oldu |
upload.failed | Dosyayı minSuccess değerinden az site kabul etti (minSuccess 0 ise 1 sayılır) |
upload.quarantined | Zararlı yazılım taraması dosyayı işaretledi (yalnızca tarama etkinken) |
provider.upload_succeeded | Bir site dosyayı kabul etti — her site için bir kez gönderilir |
provider.upload_failed | Bir site dosyadan vazgeçti — her site için bir kez gönderilir |
webhook.test | Webhook’lar sayfasında Test et düğmesine bastınız |
Her teslimat, JSON gövdeli ve X-MUX-Event ile X-MUX-Signature başlıklarını içeren tek bir POST isteğidir. 10 saniye içinde gelen herhangi bir 2xx yanıtı teslim edildi sayılır; yönlendirmeler izlenmez. Başarısız bir teslimat (ağ hatası, zaman aşımı, 408, 425, 429 veya 5xx) aynı gövdeyle 1, 5 ve 30 dakika sonra yeniden denenir; diğer 4xx yanıtları ve yönlendirmeler denenmez. Her deneme X-MUX-Delivery-Attempt (1–4) ve yeni bir imza taşır, bu yüzden tekrarları gövdeye göre ayıklayın. Teslimat sırası garanti edilmez (yeniden denenen bir olay daha yeni bir olaydan sonra gelebilir); üzerine işlem yapmadan önce data ve createdAt değerlerini karşılaştırın. Eksikleri tamamlamak için GET /api/v1/mirror-tasks/{uploadJobId} kullanın. Son denemesi başarısız olan art arda 15 teslimattan veya tek bir başarı olmadan geçen bir saatlik hatalardan sonra uç nokta duraklatılır; yeniden açmak sayacı sıfırlar. Bir webhook.test teslimatı (Test et düğmesi) X-MUX-Delivery-Attempt: 1 ile bir kez gönderilir ve asla yeniden denenmez.
{
"event": "provider.upload_succeeded",
"createdAt": "2026-09-25T12:00:00.000Z",
"data": {
"uploadJobId": "…",
"fileId": "…",
"provider": "gofile",
"providerName": "Gofile",
"status": "succeeded",
"mirrorUrl": "https://…"
}
}upload.* olayları uploadJobId, fileId ve status taşır; provider.upload_failed ise mirrorUrl yerine errorCode taşır.
İmzayı doğrulama
Başlık t=1727265600,v1=5f2b… biçimindedir: t Unix saniyesi cinsinden imzalama zamanı, v1 ise uç nokta sırrınızla anahtarlanmış <t>.<raw body> değerinin onaltılık HMAC-SHA256 özetidir. Ham baytları tam olarak alındığı gibi özetleyin, sabit sürede karşılaştırın ve 5 dakikadan eski zaman damgalarını reddedin.
Express
import express from 'express';
import { createHmac, timingSafeEqual } from 'node:crypto';
function verify(rawBody, header, secret, toleranceSec = 300) {
const parts = Object.fromEntries(
header.split(',').map((kv) => {
const i = kv.indexOf('=');
return [kv.slice(0, i).trim(), kv.slice(i + 1).trim()];
}),
);
const t = Number(parts.t);
if (!Number.isFinite(t) || !parts.v1) return false;
if (Math.abs(Date.now() / 1000 - t) > toleranceSec) return false; // too old: replay
const expected = createHmac('sha256', secret).update(`${parts.t}.`).update(rawBody).digest();
const got = Buffer.from(parts.v1, 'hex');
return got.length === expected.length && timingSafeEqual(got, expected);
}
const app = express();
// Raw bytes, not parsed JSON: the signature covers the body exactly as sent.
app.post('/hooks/mirroruploadx', express.raw({ type: 'application/json' }), (req, res) => {
if (!verify(req.body, req.get('x-mux-signature') ?? '', process.env.MUX_WEBHOOK_SECRET)) {
return res.sendStatus(401);
}
const { event, data } = JSON.parse(req.body);
console.log(event, data.uploadJobId);
res.sendStatus(204); // any 2xx counts as delivered
});
app.listen(3000);Flask
import hashlib, hmac, os, time
from flask import Flask, abort, request
def verify(raw_body: bytes, header: str, secret: str, tolerance: int = 300) -> bool:
parts = dict(kv.strip().split("=", 1) for kv in header.split(",") if "=" in kv)
t, v1 = parts.get("t", ""), parts.get("v1", "")
if not t.isdigit() or not v1 or abs(time.time() - int(t)) > tolerance:
return False
expected = hmac.new(secret.encode(), t.encode() + b"." + raw_body, hashlib.sha256).hexdigest()
return hmac.compare_digest(expected, v1)
app = Flask(__name__)
@app.post("/hooks/mirroruploadx")
def hook():
# get_data(): the raw bytes, exactly as signed
if not verify(request.get_data(), request.headers.get("X-MUX-Signature", ""),
os.environ["MUX_WEBHOOK_SECRET"]):
abort(401)
payload = request.get_json()
print(payload["event"], payload["data"].get("uploadJobId"))
return "", 204 # any 2xx counts as deliveredyalın PHP 8.1+
<?php
// Plain PHP 8.1+ endpoint, e.g. public/hooks/mirroruploadx.php
declare(strict_types=1);
function verify(string $rawBody, string $header, string $secret, int $tolerance = 300): bool
{
$parts = [];
foreach (explode(',', $header) as $kv) {
[$k, $v] = array_pad(explode('=', $kv, 2), 2, '');
$parts[trim($k)] = trim($v);
}
$t = $parts['t'] ?? '';
$v1 = $parts['v1'] ?? '';
if (!ctype_digit($t) || $v1 === '' || abs(time() - (int) $t) > $tolerance) {
return false; // malformed, or too old: replay
}
$expected = hash_hmac('sha256', "$t.$rawBody", $secret);
return hash_equals($expected, $v1);
}
// php://input: the raw bytes, exactly as signed (not $_POST, not re-encoded JSON)
$raw = file_get_contents('php://input');
if (!verify($raw, $_SERVER['HTTP_X_MUX_SIGNATURE'] ?? '', (string) getenv('MUX_WEBHOOK_SECRET'))) {
http_response_code(401);
exit;
}
$payload = json_decode($raw, true, 512, JSON_THROW_ON_ERROR);
error_log($payload['event'] . ' ' . ($payload['data']['uploadJobId'] ?? ''));
http_response_code(204); // any 2xx counts as deliveredİstek sınırları
Sınırlar IP adresi başına değil, API anahtarı başına sayılır. Sınırlı bir uç noktadaki her yanıt X-RateLimit-Limit, X-RateLimit-Remaining ve X-RateLimit-Reset (epoch saniyesi) taşır. Sınırın aşılması bir Retry-After başlığıyla birlikte 429 RATE_LIMITED döndürür — o kadar saniye bekleyin. Parça yüklemelerine geniş bir bütçe ayrılır; dar sınırlar oturum açma ve dağıtım başlatma üzerindedir.
| Grup | Uç noktalar | Anahtar başına | Aralık |
|---|---|---|---|
| Yükleme başlatma | POST /POST /DELETE / | 60 | 1 dakika |
| Parça yükleme | PATCH / | 600 | 1 dakika |
| İlerleme sorgulama | GET /HEAD /GET /GET / | 600 | 1 dakika |
| Bir yüklemenin dağıtım ayarları | POST /PUT / | 300 | 1 dakika |
| Dağıtım başlatma | POST / | 30 | 1 dakika |
| Uzak (URL) yüklemeler | POST / | 20 | 10 dakika |
| Dosya okuma | GET /GET /GET / | 300 | 1 dakika |
| Dosya değiştirme | PATCH /DELETE / | 60 | 1 dakika |
| Herkese açık katalog | GET /GET /GET /GET / | 300 | 1 dakika |
Bunlar varsayılan değerlerdir. İşletici bunları değiştirebilir, bu yüzden yukarıdaki başlıklar her zaman esas alınacak kaynaktır. Anahtarlarınız için kesin değerler ve şu anda her birinden ne kadar kullandığınız API anahtarları sayfasındadır. Anahtarsız istekler IP adresi başına sayılır; bunlar için yükleme başlatma (60 yerine 10), parça yükleme (600 yerine 300), ilerleme sorgulama (600 yerine 300), bir yüklemenin dağıtım ayarları (300 yerine 60), dağıtım başlatma (30 yerine 10) için daha küçük bütçeler uygulanır; uzak (URL) yüklemeler ve herkese açık katalog için aynı bütçe uygulanır. Dosya okuma ve dosya değiştirme için her zaman anahtar gerekir.
Hatalar
Başarılı yanıtlar { "success": true, "data": … } biçimindedir. Hatalar, HTTP durumunun yanında tek bir biçim kullanır. code kararlıdır — dallanmayı ona göre yapın; message insanlar içindir ve değişebilir. Daha fazla bağlam olduğunda details eklenir, retryable aynı isteği yeniden denemenin işe yarayıp yaramayacağını söyler ve destek ekibiyle iletişime geçerseniz requestId isteğinizi bulmamıza yardımcı olur.
{
"success": false,
"error": {
"code": "INSUFFICIENT_SCOPE",
"message": "This endpoint needs one of these API key scopes: upload:write.",
"requestId": "…",
"retryable": false
}
}| Kod | HTTP | Yeniden? | Anlamı |
|---|---|---|---|
NO_TOKEN | 401 | Hayır | API anahtarı gönderilmedi |
INVALID_API_KEY | 401 | Hayır | Anahtar yanlış veya iptal edilmiş |
INSUFFICIENT_SCOPE | 403 | Hayır | Anahtarda bu uç noktanın gerektirdiği kapsam yok |
API_KEY_NOT_ALLOWED | 403 | Hayır | Bu uç nokta API anahtarıyla kullanılamaz |
EMAIL_NOT_VERIFIED | 403 | Hayır | Önce hesabın e-posta adresini doğrulayın; açık oturumlar çalışmaya devam eder |
SESSION_REVOKED | 401 | Hayır | Oturum sonlandırıldı (parola sıfırlama veya değiştirme, çıkış); yeniden giriş yapın |
ACCOUNT_INACTIVE | 403 | Hayır | Hesap askıya alınmış veya silinmek üzere planlanmış |
ACCOUNT_DISABLED | 401 / 409 | Hayır | Hesap askıya alındı: anahtar kontrolünde 401, istek sürerken değiştiyse 409 |
ACCOUNT_PENDING_DELETION | 409 | Hayır | İstek sürerken hesap silinmek üzere planlandı; yeni hiçbir şey başlatılmaz |
VALIDATION_ERROR | 400 | Hayır | Gövde veya bir parametre geçersiz; details alanına bakın |
FILE_REJECTED | 400 | Hayır | Dosya türüne veya boyutuna izin verilmiyor; hangisi olduğunu details.reason söyler |
TOO_MANY_MIRRORS | 400 | Hayır | Bir dosyanın sahip olabileceğinden fazla site |
NO_CONNECTED_PROVIDERS | 400 | Hayır | Seçilen her site kendi hesabınızı gerektiriyor ve hiçbiri bağlı değil |
PROVIDER_REJECTS_FILE | 400 | Hayır | Seçilen sitelerin hiçbiri bu dosya türünü veya boyutunu kabul etmiyor |
NO_AVAILABLE_PROVIDERS | 400 | Hayır | Seçilen sitelerin hiçbiri şu anda yükleme kabul etmiyor; başkalarını seçin veya sonra deneyin. `details.waiting` yalnızca duraklatılmış siteleri listeler (örneğin 24 saat içinde kalkan günlük sınır): `retryable` false olsa da bunlar için sonra yeniden denemek işe yarar |
NO_VALID_PROVIDERS | 400 | Hayır | Hiçbir providerSlugs değeri etkin bir siteyle eşleşmiyor; GET /api/v1/providers yanıtına bakın |
INVALID_JOB_STATE | 400 | Hayır | İş mevcut durumunda başlatılamaz |
JOB_NOT_READY | 400 | Hayır | Dosyanın henüz bir dağıtım işi yok |
FILE_TOO_LARGE_FOR_UPLOAD | 400 | Hayır | Dosya, oturumun parça boyutunda 10 000 parçaya sığmıyor; details.limitBytes |
MISSING_OFFSET | 400 | Hayır | Bir parça sayısal bir upload-offset başlığı olmadan gönderildi |
RAW_BODY_REQUIRED | 400 | Hayır | Parça gövdesi, content-type application/offset+octet-stream olan ham baytlardan oluşmalıdır |
TOO_MANY_URLS | 400 | Hayır | Tek bir remote-uploads isteğinde izin verilenden fazla URL |
FILE_NOT_FOUND | 404 | Hayır | Hesabınızda böyle bir dosya yok (veya silinmiş) |
JOB_NOT_FOUND | 404 | Hayır | Hesabınızda böyle bir dağıtım işi yok |
SESSION_NOT_FOUND | 404 | Hayır | Hesabınızda böyle bir yükleme oturumu yok |
SHARE_NOT_FOUND | 404 | Hayır | Dosyanın henüz bir paylaşım sayfası yok |
QUOTA_EXCEEDED | 409 | Hayır | Günlük veya eşzamanlı bir yükleme sınırı; ne zaman boşalacağını details.retryAt söyler |
CHUNK_OFFSET_CONFLICT | 409 | Hayır | upload-offset alınan baytlarla eşleşmiyor; HEAD ile öğrenip devam edin |
CHUNK_TOO_SMALL | 409 | Hayır | Sonuncusu dışındaki bir parça 5 MiB’ın altında |
CHUNK_TOO_MANY_PARTS | 409 | Hayır | 10 000’den fazla parça; daha büyük parçalar gönderin |
CHUNK_MISALIGNED | 409 | Hayır | Parça, chunkSize değerinin bir katında başlayan tam bir chunkSize dilimi değil: bu, ileriden gönderilen bir parça için ve ilk parça tam bir chunkSize dilimiyse sonraki her parça için de (sırayla ya da ileriden) zorunludur; ya da parçaları yalnızca sırayla kabul eden bir oturumda bir parça ileriden gönderildi |
CHUNK_OUT_OF_WINDOW | 409 | Hayır | Bir parça uploadedBytes değerinin maxChunksAhead parçadan daha ilerisinde ya da ilk parça kabul edilmeden önce hiç ilerisinde başlıyor; öncekilerden sonra yeniden gönderin |
CHUNK_EXCEEDS_DECLARED_SIZE | 409 | Hayır | Parça, oturum oluşturulurken bildirilen dosya boyutunu aşıyor |
CHUNK_EMPTY | 409 | Hayır | Parçada hiç bayt yok |
CHUNK_NOT_RECEIVABLE | 409 | Hayır | Oturum artık veri kabul etmiyor (tamamlandı, iptal edildi veya süresi doldu); yeni bir oturum açın |
SESSION_EXPIRED | 409 | Hayır | Yükleme oturumunun süresi doldu; yeni bir oturum açın |
SESSION_NOT_RECEIVABLE | 409 | Hayır | Oturum iptal edildi veya süresi doldu ve başka değişiklik kabul etmiyor |
SESSION_COMPLETED | 409 | Hayır | Yükleme zaten tamamlandı; bunun yerine dosyayı silin |
UPLOAD_INCOMPLETE | 409 | Hayır | Baytların hepsi ulaşmadı; önce kalan parçaları gönderin (sayılar details içindedir) |
IDEMPOTENCY_KEY_CONFLICT | 409 | Hayır | Bu idempotencyKey başka bir yükleme tarafından kullanılıyor; her yükleme için benzersiz bir anahtar kullanın |
SOURCE_GONE | 409 | Hayır | Dosyanın bizdeki kopyası zaten kaldırıldı, bu yüzden henüz denenmemiş olduğu sitelere gönderilemez; o siteler için yeniden yükleyin. Kopyamız bir dağıtım işi biter bitmez (tamamlandı, kısmen tamamlandı veya başarısız) kaldırılır ve dağıtımı hiç başlatılmayan bir yükleme, bittikten 30 dakika sonra kaldırılır (dağıtım planı hâlâ siteleri bekliyorsa en fazla 72 saat; uzak URL yüklemeleri hariç). Bitmiş bir iş için yalnızca zaten denenmiş sitelerle mirror-tasks/start çağrısını yinelemek yalnızca paylaşım ayarlarını uygular (alreadyStarted: true) |
JOB_NOT_DISTRIBUTABLE | 409 | Hayır | İş başarısız oldu, iptal edildi veya artık dağıtılamayacak bir durumda |
SHARE_TAKEN_DOWN | 409 | Hayır | Dosyanın paylaşım sayfası kaldırıldı, bu yüzden daha fazla siteye gönderilemez |
FINALIZING | 409 | Evet | Başka bir istek dosyayı birleştiriyor; birkaç saniye sonra yeniden sorun |
CONFLICT | 409 | Evet | Devam eden başka bir değişiklikle çakıştı; aynı isteği yeniden deneyin |
TEMPORARILY_UNAVAILABLE | 503 | Evet, Retry-After sonrasında | Sunucu şu anda yoğun; Retry-After süresinden sonra yeniden deneyin. details.reason "staging_full": geçici depolama alanı dolu, yeni yükleme kabul edilmedi (Retry-After yaklaşık 10 dakika); devam eden yüklemeler çalışmayı sürdürür |
PAYLOAD_TOO_LARGE | 413 | Hayır | İstek gövdesi (veya bir parça) sunucunun kabul ettiğinden büyük |
REMOTE_TOO_LARGE | URL başına | Hayır | Bir remote-uploads sonucunda: dosya URL yükleme sınırını aşıyor |
RATE_LIMITED | 429 | Evet, Retry-After sonrasında | Bu grup için çok fazla istek |
INTERNAL_ERROR | 500 | Evet | Sunucu hatası; ayrıntılar günlüğe kaydedilir, asla döndürülmez |
MAINTENANCE | 503 | Evet, Retry-After sonrasında | Yeni yüklemeler şimdilik duraklatıldı; okumalar çalışmaya devam eder |
UPLOADS_TEMPORARILY_UNAVAILABLE | 503 | Evet, Retry-After sonrasında | Yükleme sayacımız okunamadı; oturum açılmadı |
SHUTTING_DOWN | 503 | Evet, Retry-After sonrasında | Sunucu yeniden başlatılıyor (Retry-After 5 saniye); bekleyin ve aynı isteği yeniden gönderin — hiçbir şey işlenmedi |
Bir site neden atlandı
Bunlar hata değildir: başarılı bir start yanıtının (ve dosyayı tamamlayan yanıttaki distribution alanının) skipped[].reason alanında gelirler. Diğer siteler dosyayı yine de alır. Çağrı yalnızca seçilen sitelerin hiçbiri dosyayı alamadığında başarısız olur: PROVIDER_REJECTS_FILE (hiçbiri bu dosyayı kabul etmiyor), NO_CONNECTED_PROVIDERS (hepsi kendi hesabınızı gerektiriyor), NO_AVAILABLE_PROVIDERS (hiçbiri şu anda yükleme kabul etmiyor) veya NO_VALID_PROVIDERS (hiçbir slug etkin bir siteyle eşleşmiyor).
| Neden | Anlamı |
|---|---|
UNKNOWN_PROVIDER | Bu slug’a sahip bir site yok — yazımı GET /api/v1/providers ile karşılaştırın |
PROVIDER_DISABLED | Site şu anda kapalı veya bakımda |
ACCOUNT_REQUIRED | Site yalnızca kendi hesabınıza yükleme kabul ediyor — onu Bağlantılar sayfasından bağlayın |
GUEST_UPLOAD_OFF | Site şu anda yükleme kabul etmiyor ve bir hesaba bağlanamıyor |
DAILY_LIMIT_REACHED | Sitenin hesapsız yüklemeler için günlük sınırı şimdilik doldu (en fazla 24 sa) — yine de yükleyebilmesi için kendi hesabınızı bağlayın |
FILE_TOO_LARGE | Dosya bu sitenin boyut sınırını aşıyor |
MIME_NOT_ALLOWED | Site bu dosya türünü kabul etmiyor |
ALREADY_ATTEMPTED | Bu host bu dosya için zaten denendi, bu yüzden dosya oraya yeniden gönderilmez |
API başvurusu, her uç noktanın döndürebileceği kodları listeler.