Прегледайте документите за програмисти

Video2URL ·

REST API

Качвайте и споделяйте файлове

Този урок взема един локален файл с име demo.mp4 и го превръща в работещ дял URL. Изпълнете стъпките по ред; всеки отговор доставя стойност, използвана от следващата заявка.

1

Създайте и запазете API ключ

Отворете настройките за разработчици, изберете uploads:write, files:read, shares:write и shares:read, след което създайте ключа. Копирайте го сега - пълната тайна се показва само веднъж.

Налични обхвати: uploads:write, files:read, files:write, shares:write, shares:read, domains:read и domains:write.

Очакван резултат:Имате тайна, която започва с префикса на ключа Video2URL. Пазете го лично.
2

Подгответе своя терминал

Поставете ключа в променлива на средата, така че да не се появява във всяка команда или в хронологията на обвивката ви. Заменете контейнера, преди да натиснете Enter.

Terminal
read -s VIDEO2URL_API_KEY
echo "key loaded"
Очакван резултат:Командата отпечатва зареден ключ, а не самата тайна.
3

Създайте задание за качване

Кажете на Video2URL точното име на файла, типа MIME и размера на байта. Това връща временно R2 качване URL; все още не качва видеоклипа.

POST /api/v1/uploads

curl
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}'
Очакван резултат:JSON отговор, съдържащ data.uploadId и data.upload.url. Запазете и двете стойности за следващите стъпки.
Save response values
export UPLOAD_ID="paste data.uploadId here"
export UPLOAD_URL="paste data.upload.url here"
4

Изпратете видео байтовете

Качете демо.mp4 директно във временния URL. Не добавяйте Video2URL API ключа към тази PUT заявка. Използвайте Content-Type, върнат от отговора create-upload. Качете необработения файл в предварително подписания URL, като използвате върнатия тип съдържание.

curl · PUT
curl --fail-with-body -X PUT "$UPLOAD_URL" \
  -H "Content-Type: video/mp4" \
  -H "If-None-Match: *" \
  --data-binary @demo.mp4
Очакван резултат:Сървърът за качване връща HTTP 200. Празното тяло на отговора е нормално.
5

Завършете и проверете качването

След като PUT успее, кажете на Video2URL да провери съхранения обект и да създаде файловия запис. Не извиквайте тази стъпка, преди PUT да приключи.

POST /api/v1/uploads/{uploadId}/complete · GET /api/v1/uploads/{uploadId}

curl
curl -sS -X POST "https://video2url.com/api/v1/uploads/$UPLOAD_ID/complete" \
  -H "Authorization: Bearer $VIDEO2URL_API_KEY"
Очакван резултат:Отговорът съдържа data.file.fileId. Запазване на FILE_ID; той идентифицира завършения файл.
Save FILE_ID
export FILE_ID="paste data.file.fileId here"
6

Създайте последното споделяне URL

Създайте скрита връзка от FILE_ID. Нерегистриран означава, че всеки с URL може да го отвори, но той не е поставен в публична директория.

  • Заглавието не е задължително.
  • Паролата не е задължителна.
  • Видимостта не е задължителна.
  • Видимостта по подразбиране е скрита.

POST /api/v1/shares · GET / DELETE /api/v1/shares/{shareId}

curl
curl -sS -X POST https://video2url.com/api/v1/shares \
  -H "Authorization: Bearer $VIDEO2URL_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"fileId\":\"$FILE_ID\",\"visibility\":\"unlisted\"}"
Очакван резултат:Отговорът съдържа записа за споделяне и URL. Отворете SHARE_URL в частен прозорец на браузъра, за да го потвърдите.
Open SHARE_URL
export SHARE_URL="paste the returned share URL here"
open "$SHARE_URL" # macOS; use xdg-open on Linux

Video2URL SDK · npm

npm
npm install video2url
REST API
GET / 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}
README

JavaScript & Python

Създайте най-тесния ключ, от който се нуждаете. Завъртете, като създадете и внедрите заместител, преди да отмените стария ключ. Ако платеният достъп приключи, ключовете остават запазени, но разговорите се поставят на пауза; подновяването на отговарящ на условията план възстановява достъпа.

JavaScript
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 });
Python
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 с необработени байтове.

  1. Заявка за сесия за качване чрез POST /api/v1/uploads
  2. Запазване на върнатите uploadId и upload.url за последващ PUT

Video2URL · · English

Екранната снимка показва интерфейса на английски език; поясненията са на текущия език.

Изтеглете и стартирайте пълните примери

node upload-share.mjs api ./report.pdf application/pdf

Как работи

  1. Вземете API ключ за разработчици с активирани всички четири обхвата за качване и споделяне.
  2. Изпратете POST /api/v1/uploads, качвайте сурови байтове чрез PUT с upload.headers, след което изпратете POST /api/v1/uploads/{uploadId}/complete.
  3. Потвърдете, че статусът на файла е ready, и изпратете POST /api/v1/shares с потвърденото fileId.

Персонализиран суфикс на връзка

Тази функция изисква план Pro или Business.

3–48 знака (a–z, 0–9, тирета), започващи и завършващи с буква или цифра. Оставете празно за автоматично генериране.

REST API
POST /api/v1/shares
{ "fileId": "<FILE_ID>", "visibility": "unlisted", "customSlug": "product-demo" }

409 CUSTOM_SLUG_CONFLICT

Този суфикс вече е зает. Моля, изберете друг и опитайте отново.