Procházet dokumenty pro vývojáře

Video2URL ·

REST API

Nahrávejte a sdílejte soubory

Tento výukový program vezme jeden místní soubor s názvem demo.mp4 a převede jej na pracovní sdílenou složku URL. Dokončete kroky v pořadí; každá odpověď poskytuje hodnotu použitou v dalším požadavku.

1

Vytvořte a uložte klíč API

Otevřete Nastavení vývojáře, vyberte uploads:write, files:read, sharing:write a share:read a poté vytvořte klíč. Zkopírujte jej nyní – úplné tajemství se zobrazí pouze jednou.

Dostupné rozsahy: uploads:write, files:read, files:write, shares:write, shares:read, domains:read a domains:write.

Očekávaný výsledek:Máte tajemství, které začíná předponou klíče Video2URL. Udržujte to v soukromí.
2

Připravte si terminál

Vložte klíč do proměnné prostředí, aby se neobjevil v každém příkazu nebo v historii shellu. Před stisknutím klávesy Enter nahraďte zástupný symbol.

Terminal
read -s VIDEO2URL_API_KEY
echo "key loaded"
Očekávaný výsledek:Příkaz vypíše načtený klíč, nikoli samotný tajný klíč.
3

Vytvořte úlohu nahrávání

Řekněte Video2URL přesný název souboru, typ MIME a velikost bajtu. To vrátí dočasné R2 upload URL; ještě nenahraje video.

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}'
Očekávaný výsledek:Odpověď JSON obsahující data.uploadId a data.upload.url. Uložte obě hodnoty pro další kroky.
Save response values
export UPLOAD_ID="paste data.uploadId here"
export UPLOAD_URL="paste data.upload.url here"
4

Pošlete bajty videa

Nahrajte demo.mp4 přímo do dočasného URL. K tomuto požadavku PUT nepřidávejte klíč API Video2URL. Použijte Content-Type vrácený odpovědí vytvoření-nahrání. Nahrajte nezpracovaný soubor do předem podepsaného URL pomocí vráceného typu obsahu.

curl · PUT
curl --fail-with-body -X PUT "$UPLOAD_URL" \
  -H "Content-Type: video/mp4" \
  -H "If-None-Match: *" \
  --data-binary @demo.mp4
Očekávaný výsledek:Server pro nahrávání vrátí HTTP 200. Prázdné tělo odpovědi je normální.
5

Dokončete a ověřte nahrávání

Po úspěšném PUT řekněte Video2URL, aby ověřil uložený objekt a vytvořil záznam souboru. Nevolejte tento krok před dokončením 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"
Očekávaný výsledek:Odpověď obsahuje data.file.fileId. Uložit FILE_ID; identifikuje dokončený soubor.
Save FILE_ID
export FILE_ID="paste data.file.fileId here"
6

Vytvořte poslední sdílení URL

Vytvořte neuvedený odkaz ze souboru FILE_ID. Neuvedené znamená, že jej může otevřít kdokoli s URL, ale není umístěn ve veřejném adresáři.

  • Název je volitelný.
  • Heslo je volitelné.
  • Viditelnost je volitelná.
  • Výchozí nastavení viditelnosti je neuvedené.

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\"}"
Očekávaný výsledek:Odpověď obsahuje záznam o sdílení a URL. Otevřete SHARE_URL v soukromém okně prohlížeče a ověřte to.
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

Vytvořte nejužší klíč, který potřebujete. Otočte vytvořením a nasazením náhrady před odvoláním starého klíče. Pokud placený přístup skončí, klíče zůstanou uloženy, ale hovory se pozastaví; obnovení způsobilého plánu obnoví přístup.

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()

Související otázky a témata

Existuje API, které mé aplikaci umožní nahrávat videa, obrázky nebo PDF a získat zpět URL ke sdílení?

Nahrávání souborů a generování odkazů ke sdílení přes API

Video2URL poskytuje vývojářské REST API pro aplikace, které chtějí nahrávat videa, obrázky nebo PDF. Způsobilí vývojáři se autentizují pomocí tokenů Bearer s vymezeným rozsahem oprávnění, provádějí přímá nahrávání přes HTTP PUT a programově generují URL adresy stránek pro zobrazení ke sdílení.

Automatizace nahrávání videí, obrázků a souborů PDF přes REST API

Pracovní postup API zrcadlí MCP: přesná délka souboru v bajtech musí přesně odpovídat sizeBytes, zatímco mimeType a filename musí odpovídat skutečnému formátu a názvu souboru. Načtěte svůj token z proměnné prostředí VIDEO2URL_API_KEY. Koncový bod podporuje MP4, MOV, MKV, WebM, obrázky a PDF. Vlastní parametr expiresAt není prostřednictvím create_share_link podporován; vlastní vypršení platnosti nakonfigurujte na webovém rozhraní. Když se nahrávání zpracovávají nebo ještě nejsou dokončena, dotazujte se na stav nahrávání, dokud nebude ready, namísto odesílání předčasných odkazů klientům.

Vývojářská oprávnění a požadované rozsahy (scopes)

Integrace API vyžaduje způsobilý tarif vývojářského účtu; bezplatné účty pro prohlížeč přístup k API neposkytují. Vygenerujte klíč API nakonfigurovaný se všemi čtyřmi požadovanými rozsahy životního cyklu: uploads:write pro inicializaci přenosů, files:read pro ověření stavu souboru, shares:write pro vytváření odkazů a shares:read pro načtení podrobností o sdílení.

Architektura přímého nahrávání a sdílení

Odešlete POST /api/v1/uploads s parametry filename, mimeType a sizeBytes a získejte uploadId, předem podepsané upload.url a upload.headers. Odešlete nezpracované bajty souboru přes PUT přímo na úložiště upload.url pomocí upload.headers (bez autorizační hlavičky Bearer s vaším klíčem API). Odešlete POST /api/v1/uploads/{uploadId}/complete, ověřte, že odpověď vrací stav ready a file.fileId, a poté odešlete POST /api/v1/shares s fileId pro získání odkazu ke sdílení.

Dokumentace /docs/api#create-upload znázorňuje inicializaci relace nahrávání přes POST /api/v1/uploads a export proměnných UPLOAD_ID a UPLOAD_URL pro následný HTTP PUT nezpracovaných bajtů.

  1. Vyžádat relaci nahrávání přes POST /api/v1/uploads
  2. Uložit vrácené hodnoty uploadId a upload.url pro následný PUT

Video2URL · · English

Snímek obrazovky zachycuje anglické rozhraní; popisky odpovídají aktuálnímu jazyku.

Stáhněte a spusťte kompletní příklady

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

Jak to funguje

  1. Získejte vývojářský klíč API se všemi čtyřmi povolenými rozsahy pro nahrávání a sdílení.
  2. Odešlete POST /api/v1/uploads, proveďte PUT nezpracovaných bajtů pomocí upload.headers a poté odešlete POST /api/v1/uploads/{uploadId}/complete.
  3. Ověřte, že stav souboru je ready, a odešlete POST /api/v1/shares s potvrzeným fileId.

Vlastní koncovka odkazu

Tato funkce vyžaduje tarif Pro nebo Business.

3–48 znaků (a–z, 0–9, pomlčky), musí začínat a končit písmenem nebo číslicí. Nechte prázdné pro automatické vygenerování.

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

409 CUSTOM_SLUG_CONFLICT

Tato koncovka je již obsazena. Vyberte jinou a zkuste to znovu.