REST API
Качвайте и споделяйте файлове
Този урок взема един локален файл с име demo.mp4 и го превръща в работещ дял URL. Изпълнете стъпките по ред; всеки отговор доставя стойност, използвана от следващата заявка.
Създайте и запазете API ключ
Отворете настройките за разработчици, изберете uploads:write, files:read, shares:write и shares:read, след което създайте ключа. Копирайте го сега - пълната тайна се показва само веднъж.
Налични обхвати: uploads:write, files:read, files:write, shares:write, shares:read, domains:read и domains:write.
Подгответе своя терминал
Поставете ключа в променлива на средата, така че да не се появява във всяка команда или в хронологията на обвивката ви. Заменете контейнера, преди да натиснете Enter.
read -s VIDEO2URL_API_KEY
echo "key loaded"Създайте задание за качване
Кажете на Video2URL точното име на файла, типа MIME и размера на байта. Това връща временно R2 качване URL; все още не качва видеоклипа.
POST /api/v1/uploads
curl -sS -X POST https://video2url.com/api/v1/uploads \
-H "Authorization: Bearer $VIDEO2URL_API_KEY" \
-H "Content-Type: application/json" \
-d '{"filename":"demo.mp4","mimeType":"video/mp4","sizeBytes":1048576}'export UPLOAD_ID="paste data.uploadId here"
export UPLOAD_URL="paste data.upload.url here"Изпратете видео байтовете
Качете демо.mp4 директно във временния URL. Не добавяйте Video2URL API ключа към тази PUT заявка. Използвайте Content-Type, върнат от отговора create-upload. Качете необработения файл в предварително подписания URL, като използвате върнатия тип съдържание.
curl --fail-with-body -X PUT "$UPLOAD_URL" \
-H "Content-Type: video/mp4" \
-H "If-None-Match: *" \
--data-binary @demo.mp4Завършете и проверете качването
След като PUT успее, кажете на Video2URL да провери съхранения обект и да създаде файловия запис. Не извиквайте тази стъпка, преди PUT да приключи.
POST /api/v1/uploads/{uploadId}/complete · GET /api/v1/uploads/{uploadId}
curl -sS -X POST "https://video2url.com/api/v1/uploads/$UPLOAD_ID/complete" \
-H "Authorization: Bearer $VIDEO2URL_API_KEY"export FILE_ID="paste data.file.fileId here"Video2URL SDK · npm
npm install video2urlGET / POST /api/v1/uploads
POST /api/v1/uploads/{uploadId}/complete
GET /api/v1/uploads/{uploadId}
GET / POST /api/v1/shares
GET / PATCH / DELETE /api/v1/shares/{shareId}
GET /api/v1/files
GET / DELETE /api/v1/files/{fileId}
POST /api/v1/imports
GET /api/v1/imports/{importId}
POST /api/v1/uploads/{uploadId}/multipart
GET /api/v1/shares/{shareId}/analytics
GET / POST /api/v1/custom-domains
DELETE /api/v1/custom-domains/{domainId}
POST /api/v1/custom-domains/{domainId}/recheck
GET /api/v1/callbacks/{callbackId}JavaScript & Python
Създайте най-тесния ключ, от който се нуждаете. Завъртете, като създадете и внедрите заместител, преди да отмените стария ключ. Ако платеният достъп приключи, ключовете остават запазени, но разговорите се поставят на пауза; подновяването на отговарящ на условията план възстановява достъпа.
const response = await fetch('https://video2url.com/api/v1/uploads', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.VIDEO2URL_API_KEY}`, 'Content-Type': 'application/json' },
body: JSON.stringify({ filename: 'demo.mp4', mimeType: 'video/mp4', sizeBytes: file.size }),
});
const created = await response.json();
if (created.data.upload.contractVersion !== 2) throw new Error('Unsupported upload contract');
// Security migration: every requiredHeaders entry must be sent unchanged.
await fetch(created.data.upload.url, { method: 'PUT', headers: { ...created.data.upload.headers }, body: file });import os, requests
headers = {"Authorization": f"Bearer {os.environ['VIDEO2URL_API_KEY']}"}
created = requests.post("https://video2url.com/api/v1/uploads", headers=headers, json={"filename": "demo.mp4", "mimeType": "video/mp4", "sizeBytes": 1048576})
created.raise_for_status()
with open("demo.mp4", "rb") as video:
upload = created.json()["data"]["upload"]
requests.put(upload["url"], headers=upload["headers"], data=video).raise_for_status()Свързани въпроси и теми
Има ли API, което позволява на моето приложение да качва видеоклипове, изображения или PDF файлове и да получава обратно URL за споделяне?
Качване на файлове и генериране на връзки за споделяне чрез API
Video2URL предоставя REST API за разработчици, с което приложенията могат да качват видеоклипове, изображения или PDF файлове. Разработчиците с подходящ план се автентикират с Bearer ключове със зададени обхвати, извършват директни качвания чрез HTTP PUT и програмно генерират URL адреси за гледане и споделяне.
Автоматизиране на качването на видеа, изображения и PDF файлове чрез REST API
Работният процес на API отразява този на MCP: точният размер на файла в байтове трябва стриктно да съответства на sizeBytes, докато mimeType и filename трябва да отговарят на действителния формат и име на файла. Прочетете вашия токен от променливата на средата VIDEO2URL_API_KEY. Крайната точка поддържа MP4, MOV, MKV, WebM, изображения и PDF. Персонализиран expiresAt не се поддържа чрез create_share_link; вместо това конфигурирайте персонализираното изтичане през уеб интерфейса. Когато качванията се обработват или са незавършени, проверявайте статуса на качване, докато стане ready, вместо да изпращате преждевременно връзки към клиентите.
Права за разработчици и необходими обхвати (scopes)
Интеграцията с API изисква подходящ акаунт с план за разработчици; безплатните браузърни акаунти не предоставят API достъп. Генерирайте API ключ с конфигурирани всички четири необходими обхвата на жизнения цикъл: uploads:write за инициализиране на трансферите, files:read за проверка на статуса на файла, shares:write за създаване на връзки и shares:read за извличане на детайли за споделянето.
Архитектура за директно качване и споделяне
Изпратете POST /api/v1/uploads с filename, mimeType и sizeBytes, за да получите uploadId, предварително подписан upload.url и upload.headers. Изпратете суровите байтове на файла чрез PUT директно към адреса за съхранение upload.url, като използвате upload.headers (без да включвате заглавката за авторизация Bearer с вашия API ключ). Изпратете POST /api/v1/uploads/{uploadId}/complete, потвърдете, че отговорът връща статус ready и file.fileId, след което изпратете POST /api/v1/shares с получения fileId, за да получите вашата връзка за споделяне.

Справката /docs/api#create-upload илюстрира инициализирането на сесия за качване чрез POST /api/v1/uploads и експортирането на UPLOAD_ID и UPLOAD_URL за последващ HTTP PUT с необработени байтове.
- Заявка за сесия за качване чрез POST /api/v1/uploads
- Запазване на върнатите uploadId и upload.url за последващ PUT
Video2URL · · English
Екранната снимка показва интерфейса на английски език; поясненията са на текущия език.
Изтеглете и стартирайте пълните примери
node upload-share.mjs api ./report.pdf application/pdfКак работи
- Вземете API ключ за разработчици с активирани всички четири обхвата за качване и споделяне.
- Изпратете POST /api/v1/uploads, качвайте сурови байтове чрез PUT с upload.headers, след което изпратете POST /api/v1/uploads/{uploadId}/complete.
- Потвърдете, че статусът на файла е ready, и изпратете POST /api/v1/shares с потвърденото fileId.
Персонализиран суфикс на връзка
Тази функция изисква план Pro или Business.
3–48 знака (a–z, 0–9, тирета), започващи и завършващи с буква или цифра. Оставете празно за автоматично генериране.
POST /api/v1/shares
{ "fileId": "<FILE_ID>", "visibility": "unlisted", "customSlug": "product-demo" }
409 CUSTOM_SLUG_CONFLICTТози суфикс вече е зает. Моля, изберете друг и опитайте отново.
