Документация API
Загрузите файл один раз, отправьте его на выбранные файлообменники и получите в ответ одну ссылку — прямо из своего кода.
Обновлено
Версионируемый REST API: загрузите файл частями, отправьте его на выбранные хостинги — и все копии соберутся на одной странице с живым статусом.
- Базовый URL
- https://api.mirroruploadx.com/api/v1
- Аутентификация
- x-api-key: mux_…
1Откройте сеанс
POST /
api/ v1/ upload-sessions filename + sizeBytes; получите sessionId и chunkSize
2Отправьте части
PATCH /
api/ v1/ upload-sessions/ {id}/ chunks сырые байты по порядку; ответ, завершающий файл, содержит fileId
3Распределите
POST /
api/ v1/ mirror-tasks/ start fileId + providerSlugs; затем опрашивайте задачу
Создайте ключ на странице API-ключи. Полное пошаговое описание с кодом — в разделе Загрузка и распределение.
Аутентификация
Создайте ключ на странице API-ключи в своей панели. Полный ключ (он начинается с mux_) показывается только один раз, поэтому сразу сохраните его. Передавайте его в заголовке x-api-key в каждом запросе; Authorization: Bearer mux_… принимается точно так же — для клиентов, которые умеют работать только с bearer-токенами.
У ключей есть права (scopes): ключ даёт доступ только к эндпоинтам, которые покрывают его права, а вызов с неподходящими правами возвращает 403 INSUFFICIENT_SCOPE с указанием нужного права в сообщении. Настройки аккаунта, управление ключами и вебхуки с API-ключом недоступны вовсе (API_KEY_NOT_ALLOWED).
| Право | Доступ |
|---|---|
upload:write | Сеансы загрузки (создание, части, завершение, отмена), ваша квота загрузок, приостановка или изменение автоматического распределения загрузки (hold-distribution, distribution-intent), загрузка по URL, запуск распределения |
file:read | Список файлов, сведения о файле, статус зеркал и задач |
file:write | Настройки доступа к файлу |
file:delete | Удаление файла и его зеркал |
Эндпоинты
Всё, к чему есть доступ у API-ключа, плюс публичные эндпоинты, которым ключ не нужен. Если в столбце прав указаны два права, достаточно любого из них. Схемы запросов и ответов для каждого — в справочнике API.
| Метод | Путь | Право | Что делает |
|---|---|---|---|
| POST | / | upload:write | Открыть сеанс загрузки (при желании — с планом распределения) |
| PATCH | / | upload:write | Отправить следующую часть байтов |
| HEAD | / | upload:write | С какого места продолжить: заголовок Upload-Offset |
| GET | / | upload:writefile:read | Статус сеанса: получено байтов, fileId, finalizable |
| GET | / | upload:writefile:read | Ваши лимиты загрузок, расход и незавершённые сеансы |
| POST | / | upload:write | Завершить загрузку, финальный ответ на которую потерялся (безопасно повторять) |
| POST | / | upload:write | Не дать отложенному распределению запуститься самостоятельно |
| PUT | / | upload:write | Заменить план распределения загрузки |
| DELETE | / | upload:write | Отменить незавершённую загрузку и освободить её место |
| POST | / | upload:write | Загрузить файлы по ссылкам http(s) в ваш аккаунт |
| POST | / | upload:write | Отправить файл на выбранные хостинги |
| GET | / | upload:writefile:read | Статус задачи, каждый хостинг и ссылка на файл (shareTakenDown отмечает удалённую страницу) |
| GET | / | file:read | Список ваших файлов (пагинация курсором, поиск, фильтры) |
| GET | / | file:read | Один файл: размер, контрольная сумма, задача, настройки доступа, статистика |
| GET | / | file:read | Все копии файла: хостинг, ссылка, состояние, клики |
| PATCH | / | file:write | Пароль ссылки, срок действия, видимость |
| DELETE | / | file:delete | Удалить файл и (по умолчанию) его копии на хостингах |
| GET | / | нет (публичный) | Текущие лимиты: максимальный файл, хостингов на файл, ограничения загрузки по URL |
| GET | / | нет (публичный) | Каталог хостингов со слагами, которые передаются в providerSlugs |
| GET | / | нет (публичный) | Измеренная доля успешных загрузок по каждому хостингу |
| GET | / | нет (публичный) | Итоги платформы за последние 30 дней: файлы, работающие зеркала, доля успеха |
Загрузка файла и его распределение
- Откройте сеанс с помощью
POST /api/v1/upload-sessions. ПоляfilenameиsizeBytes(точная длина в байтах) обязательны;mimeTypeи UUIDidempotencyKeyнеобязательны — повтор запроса с тем же ключом возвращает существующий сеанс, а не открывает второй. Ответ содержитdata.sessionId(неid) иdata.chunkSize. - Отправьте байты с помощью
PATCH /api/v1/upload-sessions/{id}/chunks: сырые байты, тип содержимогоapplication/offset+octet-stream, начальная позиция части — в заголовкеupload-offset. Части отправляются по порядку или с опережением не более чем наmaxChunksAheadчастей; при отправке по порядку используйтеdata.uploadedBytesиз каждого ответа как следующее смещение. Отправляйте части поchunkSizeбайтов; каждая часть, кроме последней, должна быть не меньше 5 MiB, а у загрузки может быть не более 10 000 частей. Ответ, завершающий файл, содержитdata.fileId. Для большей скорости можно держать в полёте 2–3 части одного файла. Первую часть отправьте отдельно; её ответ сообщает реальное значениеdata.maxChunksAhead(4, если первая часть была целым срезом размеромchunkSize; 0 — только по порядку). Если первая часть была целым срезомchunkSize, каждая следующая часть тоже должна им быть (по порядку или с опережением): она начинается с позиции, кратнойchunkSize, и имеет размер ровноchunkSizeбайтов (последняя — остаток файла). Часть, отправленная с опережением относительноuploadedBytes, должна быть таким срезом и начинаться не дальше чем наdata.maxChunksAheadчастей вперёд, иначе она получит409 CHUNK_MISALIGNEDили409 CHUNK_OUT_OF_WINDOW.uploadedBytesучитывает только байты, полученные без пропусков, а ответ сfileIdполучает та часть, которая завершает файл. Повторная отправка уже полученной части — безвредный успех. - Распределите с помощью
POST /api/v1/mirror-tasks/start: поляfileIdиproviderSlugsобязательны (слаги берутся изGET /api/v1/providers). Необязательные:minSuccess(по умолчанию 1 — сколько хостингов должны принять файл, чтобы задача не завершилась ошибкой; статусcompletedставится, только если файл приняли и все остальные хостинги, иначе —partially_completed. Хостинги, отклоняющие этот тип файла, не учитываются),sharePassword,expiresInDaysилиexpiresAt. Ответ содержитuploadJobId,taskCount,shareSlug,alreadyStartedиskipped[]— хостинг, который не может принять этот файл, пропускается, а не считается ошибкой, поэтому читайтеskipped[](причины перечислены ниже). Сейчас максимум хостингов на один файл — 50. - Дождитесь завершения, опрашивая
GET /api/v1/mirror-tasks/{uploadJobId}раз в несколько секунд, покаdata.terminalне станетtrue. В ответе перечислены все хостинги вtasks[](providerSlug,status,mirrorUrl,errorCode) и ссылка на файл вdata.shareUrl.data.shareTakenDownравноtrue, если страница файла была удалена и больше не открывается.
Сейчас максимальный принимаемый размер файла — 5,00 GB.
bash, нужен jq
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";
}Примеры ответов
Открытие сеанса отвечает 201. Каждая часть, кроме последней, отвечает { uploadedBytes, completed: false, expiresAt }; последняя возвращает файл. distribution присутствует, только если вы передали план при открытии сеанса (см. ниже).
{
"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
}
]
}
}Первый успешный вызов start отвечает 202; повторный вызов для уже идущей задачи отвечает 200 с alreadyStarted: true. Если ссылка хостинга по правилам скрыта, mirrorUrl равно null, а mirrorHidden — true; страница файла всё равно его показывает.
Обойдитесь без второго вызова
Передайте distribution при открытии сеанса — и сервер начнёт распределение, как только файл будет загружен целиком. Проверьте data.distribution в ответе, завершающем файл: started: true означает, что задача поставлена в очередь (uploadJobId, shareSlug). При started: false и deferred: true в очередь пока намеренно ничего не поставлено — см. ниже. При started: false без deferred загрузка всё равно прошла успешно, но распределение не удалось запустить (причина — в error): вызовите POST /api/v1/mirror-tasks/start с fileId. error вместе с deferred: true означает временный сбой (например, все хостинги перегружены или на обслуживании): не вызывайте start и не загружайте файл заново — сервер сам повторит запуск распределения начиная с autoStartAt (до 5 попыток). Чтобы остановить это, вызовите hold-distribution.
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": "…" } }Добавьте deferred: true в distribution, чтобы получить отсрочку: финальный ответ — { started: false, deferred: true, autoStartAt }, и сервер сам запустит распределение в autoStartAt (примерно через 2 минуты), если вы не вызовете start раньше. Чтобы остановить автоматический запуск, вызовите POST /api/v1/upload-sessions/{id}/hold-distribution (без тела; autoStartAt становится null, и вы запускаете распределение сами). Чтобы вместо этого изменить план, вызовите PUT /api/v1/upload-sessions/{id}/distribution-intent с теми же полями, что и в distribution (providerSlugs, minSuccess, expiresInDays, sharePassword): он заменяет план и снимает приостановку, а если загрузка уже завершена, автоматический запуск переносится не ранее чем на 2 минуты после вызова. Если распределение уже началось, оба вызова отвечают 200, а distribution-intent возвращает alreadyStarted: true.
Запустите в течение 30 минут. Если загрузка завершена, а распределение не запущено, наша копия файла удаляется через 30 минут (если план распределения ещё ждёт, пока хостинги станут доступны, — не позднее чем через 72 часа; на загрузки по URL это не распространяется). После этого start и distribution-intent отвечают 409 SOURCE_GONE, и файл придётся загрузить заново.
Если финальный ответ потерялся
Вызовите GET /api/v1/upload-sessions/{id}: наличие fileId означает, что файл существует; finalizable: true означает, что все байты дошли и POST /api/v1/upload-sessions/{id}/complete завершит загрузку. Этот вызов безопасно повторять, и он никогда не создаёт второй файл. Несовпадающее смещение получает 409 CHUNK_OFFSET_CONFLICT — отправьте HEAD на сеанс и продолжите с его заголовка Upload-Offset. Повторный вызов start для идущей задачи не является ошибкой: вы получите 200 с alreadyStarted: true.
Загрузка по URL
POST /api/v1/remote-uploads принимает { "urls": [...] } и сам скачивает каждый файл (право upload:write). Загружаются только ссылки http и https, адреса частных сетей отклоняются, а число переходов по редиректам ограничено. Один запрос содержит не более 10 URL (значение возвращает GET /api/v1/platform); более длинные списки разбивайте.
Лимит размера на файл зависит от источника. Если источник сообщает размер файла, каждый файл может весить до 5,00 GB (limits.remoteUploadPassthroughMaxBytes); если нет — до 100,0 MB (limits.remoteUploadMaxBytes). Имя файла берётся из заголовка Content-Disposition источника, если он его отправляет; имени без расширения расширение добавляется по типу файла.
Запрос ждёт, пока файлы скачиваются. Если соединение оборвётся раньше, файл всё равно попадёт в ваш аккаунт — найдите его через GET /api/v1/files. Затем каждый fileId распределяется через POST /api/v1/mirror-tasks/start, как описано выше.
Если временное хранилище заполнено, весь запрос получает 503 TEMPORARILY_UNAVAILABLE с details.reason: "staging_full" и заголовком Retry-After. Если не поместился только один URL, соответствующая запись в results[] содержит ok: false и тот же код; у результата по отдельному URL заголовка нет, поэтому время ожидания в секундах указано в details.retryAfter.
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.Управление файлами
После загрузки файлы остаются в вашем аккаунте. Получите их список через GET /api/v1/files (limit до 100; для следующей страницы передайте nextCursor из ответа как cursor, q ищет по имени). GET /api/v1/files/{id} возвращает один файл с его задачей, настройками доступа и статистикой просмотров; GET /api/v1/files/{id}/mirrors перечисляет все копии с их ссылками, состоянием и кликами.
PATCH /api/v1/files/{id}/share (право file:write) меняет страницу файла: password (4–128 символов, null удаляет пароль — он никогда не возвращается, только passwordProtected), expiresAt (дата ISO, null — бессрочно), visibility и hideDownloadCount. Передавайте только те поля, которые хотите изменить. DELETE /api/v1/files/{id} (право file:delete) удаляет файл и ставит его копии на хостингах в очередь на удаление; добавьте ?keepMirrors=true, чтобы их сохранить. Некоторые хостинги не поддерживают удаление, поэтому копия может там остаться.
bash, нужен jq; задайте FILE_ID
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
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-модуль; задайте FILE_ID
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
<?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."
}
}Вебхуки
Добавьте эндпоинт на странице Вебхуки. URL должен использовать https://; его секрет подписи (whsec_…) показывается один раз, при создании. Эндпоинт без выбранных событий получает все события.
| Событие | Когда |
|---|---|
upload.completed | Файл приняли все хостинги, и не меньше minSuccess — хостинги, отклонившие этот файл (rejected) или отменённые, не учитываются |
upload.partially_completed | Файл приняли не менее minSuccess хостингов, но хотя бы один другой хостинг завершился ошибкой |
upload.failed | Файл приняли меньше minSuccess хостингов (minSuccess 0 считается как 1) |
upload.quarantined | Антивирусная проверка пометила файл (только если проверка включена) |
provider.upload_succeeded | Один хостинг принял файл — отправляется один раз для каждого хостинга |
provider.upload_failed | Один хостинг сдался — отправляется один раз для каждого хостинга |
webhook.test | Вы нажали «Проверить» на странице «Вебхуки» |
Каждая доставка — это один POST с телом JSON и заголовками X-MUX-Event и X-MUX-Signature. Любой ответ 2xx в течение 10 секунд считается доставкой; редиректы не выполняются. Неудачная доставка (сетевая ошибка, тайм-аут, 408, 425, 429 или 5xx) повторяется через 1, 5 и 30 минут с тем же телом; другие 4xx и редиректы не повторяются. Каждая попытка содержит X-MUX-Delivery-Attempt (1–4) и новую подпись, поэтому убирайте дубли по телу. Порядок доставки не гарантируется (повторённое событие может прийти после более нового); прежде чем действовать, сравнивайте data и createdAt. Чтобы наверстать пропущенное, используйте GET /api/v1/mirror-tasks/{uploadJobId}. После 15 доставок подряд, последняя попытка которых не удалась, или часа сбоев без единого успеха эндпоинт приостанавливается; его повторное включение сбрасывает счётчик. Доставка webhook.test (кнопка «Проверить») отправляется один раз, с X-MUX-Delivery-Attempt: 1, и никогда не повторяется.
{
"event": "provider.upload_succeeded",
"createdAt": "2026-09-25T12:00:00.000Z",
"data": {
"uploadJobId": "…",
"fileId": "…",
"provider": "gofile",
"providerName": "Gofile",
"status": "succeeded",
"mirrorUrl": "https://…"
}
}События upload.* содержат uploadJobId, fileId и status; provider.upload_failed содержит errorCode вместо mirrorUrl.
Проверка подписи
Заголовок выглядит так: t=1727265600,v1=5f2b…: t — время подписи в секундах Unix, v1 — шестнадцатеричный HMAC-SHA256 от <t>.<raw body> с ключом — секретом вашего эндпоинта. Хешируйте сырые байты ровно в том виде, в каком они получены, сравнивайте за постоянное время и отклоняйте метки времени старше 5 минут.
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 deliveredчистый 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Лимиты запросов
Лимиты считаются по API-ключу, а не по IP-адресу. Каждый ответ ограниченного эндпоинта содержит X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset (секунды epoch). При превышении возвращается 429 RATE_LIMITED с заголовком Retry-After — подождите указанное число секунд. На загрузку частей выделен широкий лимит; узкие лимиты — на открытие сеансов и запуск распределения.
| Группа | Эндпоинты | На ключ | Окно |
|---|---|---|---|
| Запуск загрузок | POST /POST /DELETE / | 60 | 1 минута |
| Приём частей | PATCH / | 600 | 1 минута |
| Опрос прогресса | GET /HEAD /GET /GET / | 600 | 1 минута |
| Настройки распределения загрузки | POST /PUT / | 300 | 1 минута |
| Запуск распределения | POST / | 30 | 1 минута |
| Загрузки по URL | POST / | 20 | 10 минут |
| Чтение файлов | GET /GET /GET / | 300 | 1 минута |
| Изменение файлов | PATCH /DELETE / | 60 | 1 минута |
| Публичный каталог | GET /GET /GET /GET / | 300 | 1 минута |
Это значения по умолчанию. Оператор может их изменить, поэтому источником истины всегда служат заголовки выше. Точные значения для ваших ключей и текущий расход по каждому показаны на странице API-ключи. Запросы без ключа считаются по IP-адресу и получают меньшие лимиты на запуск загрузок (10 вместо 60), приём частей (300 вместо 600), опрос прогресса (300 вместо 600), настройки распределения загрузки (60 вместо 300), запуск распределения (10 вместо 30), а те же лимиты на загрузки по URL и публичный каталог. Чтение файлов и изменение файлов — только с ключом.
Ошибки
Успешные ответы имеют вид { "success": true, "data": … }. Ошибки имеют единую форму и сопровождаются HTTP-статусом. code стабилен — ветвитесь по нему; message предназначен для людей и может меняться. details добавляется, когда есть дополнительный контекст, retryable сообщает, поможет ли повтор того же запроса, а requestId поможет нам найти ваш запрос, если вы обратитесь в поддержку.
{
"success": false,
"error": {
"code": "INSUFFICIENT_SCOPE",
"message": "This endpoint needs one of these API key scopes: upload:write.",
"requestId": "…",
"retryable": false
}
}| Код | HTTP | Повтор? | Значение |
|---|---|---|---|
NO_TOKEN | 401 | Нет | API-ключ не передан |
INVALID_API_KEY | 401 | Нет | Ключ неверный или отозван |
INSUFFICIENT_SCOPE | 403 | Нет | У ключа нет права, необходимого для этого эндпоинта |
API_KEY_NOT_ALLOWED | 403 | Нет | Этот эндпоинт нельзя использовать с API-ключом |
EMAIL_NOT_VERIFIED | 403 | Нет | Сначала подтвердите эл. почту аккаунта; открытые сеансы продолжают работать |
SESSION_REVOKED | 401 | Нет | Сеанс входа завершён (сброс или смена пароля, выход); войдите снова |
ACCOUNT_INACTIVE | 403 | Нет | Аккаунт заблокирован или запланирован к удалению |
ACCOUNT_DISABLED | 401 / 409 | Нет | Аккаунт заблокирован: 401 при проверке ключа, 409, если это изменилось во время выполнения запроса |
ACCOUNT_PENDING_DELETION | 409 | Нет | Аккаунт был запланирован к удалению во время выполнения запроса; ничего нового не запускается |
VALIDATION_ERROR | 400 | Нет | Тело или параметр некорректны; см. details |
FILE_REJECTED | 400 | Нет | Тип или размер файла недопустим; details.reason уточняет, что именно |
TOO_MANY_MIRRORS | 400 | Нет | Больше хостингов, чем допускается для одного файла |
NO_CONNECTED_PROVIDERS | 400 | Нет | Каждому выбранному хостингу нужен ваш собственный аккаунт, и ни один не подключён |
PROVIDER_REJECTS_FILE | 400 | Нет | Ни один выбранный хостинг не принимает файл такого типа или размера |
NO_AVAILABLE_PROVIDERS | 400 | Нет | Ни один из выбранных хостингов сейчас не принимает загрузки; выберите другие или попробуйте позже. `details.waiting` перечисляет хостинги, которые лишь приостановлены (например, дневной лимит, снимаемый в течение 24 часов): для них повторная попытка позже сработает, хотя `retryable` равно false |
NO_VALID_PROVIDERS | 400 | Нет | Ни одно значение providerSlugs не соответствует включённому хостингу; см. GET /api/v1/providers |
INVALID_JOB_STATE | 400 | Нет | Задачу нельзя запустить в её текущем состоянии |
JOB_NOT_READY | 400 | Нет | У файла ещё нет задачи распределения |
FILE_TOO_LARGE_FOR_UPLOAD | 400 | Нет | Файл не помещается в 10 000 частей размера, заданного для сеанса; details.limitBytes |
MISSING_OFFSET | 400 | Нет | Часть отправлена без числового заголовка upload-offset |
RAW_BODY_REQUIRED | 400 | Нет | Тело части должно состоять из сырых байтов с content-type application/offset+octet-stream |
TOO_MANY_URLS | 400 | Нет | В одном запросе remote-uploads больше URL, чем разрешено |
FILE_NOT_FOUND | 404 | Нет | Такого файла в вашем аккаунте нет (или он удалён) |
JOB_NOT_FOUND | 404 | Нет | Такой задачи распределения в вашем аккаунте нет |
SESSION_NOT_FOUND | 404 | Нет | Такого сеанса загрузки в вашем аккаунте нет |
SHARE_NOT_FOUND | 404 | Нет | У файла ещё нет страницы |
QUOTA_EXCEEDED | 409 | Нет | Дневной лимит или лимит одновременных загрузок; details.retryAt сообщает, когда он освободится |
CHUNK_OFFSET_CONFLICT | 409 | Нет | upload-offset не совпадает с полученными байтами; продолжите с HEAD |
CHUNK_TOO_SMALL | 409 | Нет | Часть, кроме последней, меньше 5 MiB |
CHUNK_TOO_MANY_PARTS | 409 | Нет | Больше 10 000 частей; отправляйте части крупнее |
CHUNK_MISALIGNED | 409 | Нет | Часть не является целым срезом chunkSize, начинающимся с позиции, кратной chunkSize: это обязательно для части, отправленной с опережением, а если первая часть была целым срезом chunkSize, то и для каждой следующей части (по порядку или с опережением); либо часть отправлена с опережением в сеансе, который принимает части только по порядку |
CHUNK_OUT_OF_WINDOW | 409 | Нет | Часть начинается дальше чем на maxChunksAhead частей после uploadedBytes или вообще после него до того, как принята первая часть; отправьте её снова после предыдущих |
CHUNK_EXCEEDS_DECLARED_SIZE | 409 | Нет | Часть выходит за размер файла, заявленный при создании сеанса |
CHUNK_EMPTY | 409 | Нет | В части нет байтов |
CHUNK_NOT_RECEIVABLE | 409 | Нет | Сеанс больше не принимает данные (он завершён, отменён или истёк); откройте новый |
SESSION_EXPIRED | 409 | Нет | Сеанс загрузки истёк; откройте новый |
SESSION_NOT_RECEIVABLE | 409 | Нет | Сеанс отменён или истёк и больше не принимает изменения |
SESSION_COMPLETED | 409 | Нет | Загрузка уже завершена; вместо этого удалите файл |
UPLOAD_INCOMPLETE | 409 | Нет | Дошли не все байты; сначала отправьте оставшиеся части (счётчики — в details) |
IDEMPOTENCY_KEY_CONFLICT | 409 | Нет | Этот idempotencyKey уже используется другой загрузкой; используйте уникальный ключ для каждой загрузки |
SOURCE_GONE | 409 | Нет | Наша копия файла уже удалена, поэтому его нельзя отправить на хостинги, на которых он ещё не пробовался; для них загрузите файл заново. Наша копия удаляется сразу после завершения задачи распределения (завершена, частично завершена или ошибка), а загрузка, распределение которой так и не запущено, удаляется через 30 минут после завершения (до 72 часов, если её план распределения ещё ждёт хостинги; кроме загрузок по URL). Повторный вызов mirror-tasks/start для завершённой задачи только с уже опробованными хостингами просто применяет настройки доступа (alreadyStarted: true) |
JOB_NOT_DISTRIBUTABLE | 409 | Нет | Задача завершилась ошибкой, отменена или находится в состоянии, в котором распределение больше невозможно |
SHARE_TAKEN_DOWN | 409 | Нет | Страница файла удалена, поэтому его нельзя отправить на другие хостинги |
FINALIZING | 409 | Да | Другой запрос собирает файл; повторите через несколько секунд |
CONFLICT | 409 | Да | Конфликт с другим изменением, которое выполняется сейчас; повторите тот же запрос |
TEMPORARILY_UNAVAILABLE | 503 | Да, после Retry-After | Сервер сейчас перегружен; повторите после задержки Retry-After. details.reason "staging_full": временное хранилище заполнено, новая загрузка не принята (Retry-After примерно 10 минут); уже идущие загрузки продолжают работать |
PAYLOAD_TOO_LARGE | 413 | Нет | Тело запроса (или одна часть) больше, чем принимает сервер |
REMOTE_TOO_LARGE | по URL | Нет | В результате remote-uploads: файл превышает лимит загрузки по URL |
RATE_LIMITED | 429 | Да, после Retry-After | Слишком много запросов для этой группы |
INTERNAL_ERROR | 500 | Да | Ошибка сервера; подробности записываются в журнал и никогда не возвращаются |
MAINTENANCE | 503 | Да, после Retry-After | Новые загрузки пока приостановлены; чтение продолжает работать |
UPLOADS_TEMPORARILY_UNAVAILABLE | 503 | Да, после Retry-After | Не удалось прочитать наш счётчик загрузок; сеанс не открыт |
SHUTTING_DOWN | 503 | Да, после Retry-After | Сервер перезапускается (Retry-After 5 секунд); подождите и отправьте тот же запрос снова — ничего не было обработано |
Почему хостинг пропущен
Это не ошибки: они приходят в skipped[].reason успешного вызова start (и в distribution ответа, завершающего файл). Остальные хостинги всё равно получают файл. Вызов завершается ошибкой, только если ни один выбранный хостинг не может принять файл: PROVIDER_REJECTS_FILE (ни один не принимает этот файл), NO_CONNECTED_PROVIDERS (каждому нужен ваш собственный аккаунт), NO_AVAILABLE_PROVIDERS (ни один сейчас не принимает загрузки) или NO_VALID_PROVIDERS (ни один слаг не соответствует включённому хостингу).
| Причина | Значение |
|---|---|
UNKNOWN_PROVIDER | Хостинга с таким слагом нет — сверьте написание с GET /api/v1/providers |
PROVIDER_DISABLED | Хостинг сейчас отключён или на обслуживании |
ACCOUNT_REQUIRED | Хостинг принимает загрузки только в ваш собственный аккаунт — подключите его на странице «Подключения» |
GUEST_UPLOAD_OFF | Хостинг сейчас не принимает загрузки, и его нельзя подключить к аккаунту |
DAILY_LIMIT_REACHED | Дневной лимит хостинга для загрузок без аккаунта пока исчерпан (до 24 ч) — подключите собственный аккаунт, чтобы загружать всё равно |
FILE_TOO_LARGE | Файл превышает лимит размера этого хостинга |
MIME_NOT_ALLOWED | Хостинг не принимает этот тип файла |
ALREADY_ATTEMPTED | Этот хостинг уже пробовали для этого файла, поэтому повторно файл туда не отправляется |
В справочнике API перечислены коды, которые может вернуть каждый эндпоинт.