REST API
Lataa ja jaa tiedostoja
Tämä opetusohjelma ottaa yhden paikallisen tiedoston nimeltä demo.mp4 ja muuttaa sen toimivaksi osuudeksi URL. Suorita vaiheet järjestyksessä; jokainen vastaus antaa seuraavan pyynnön käyttämän arvon.
Luo ja tallenna API-avain
Avaa Kehittäjäasetukset, valitse uploads:write, files:read, shares:write ja shares:read ja luo avain. Kopioi se nyt – koko salaisuus näytetään vain kerran.
Käytettävissä olevat API-käyttöoikeusalueet: uploads:write, files:read, files:write, shares:write, shares:read, domains:read, domains:write
Valmistele terminaali
Aseta avain ympäristömuuttujaan, jotta se ei näy jokaisessa komennossa tai komentotulkkihistoriassasi. Vaihda paikkamerkki ennen Enter-näppäintä.
read -s VIDEO2URL_API_KEY
echo "key loaded"Luo lähetystyö
Kerro Video2URL:lle tarkka tiedostonimi, MIME-tyyppi ja tavukoko. Tämä palauttaa väliaikaisen R2-latauksen URL; se ei lataa videota vielä.
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"Lähetä videotavut
Lataa demo.mp4 suoraan väliaikaiseen URL:ään. Älä lisää avainta Video2URL API tähän PUT-pyyntöön. Käytä Create-upload-vastauksen palauttamaa sisältötyyppiä. Lataa raakatiedosto valmiiksi allekirjoitettuun URL-tiedostoon käyttämällä palautettua sisältötyyppiä.
curl --fail-with-body -X PUT "$UPLOAD_URL" \
-H "Content-Type: video/mp4" \
-H "If-None-Match: *" \
--data-binary @demo.mp4Viimeistele ja vahvista lataus
Kun PUT onnistuu, pyydä Video2URL:tä vahvistamaan tallennettu objekti ja luomaan tiedostotietue. Älä kutsu tätä vaihetta ennen kuin PUT on valmis.
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
Luo kapein tarvitsemasi avain. Kierrä luomalla ja ottamalla käyttöön korvaava, ennen kuin peruutat vanhan avaimen. Jos maksullinen käyttö päättyy, avaimet pysyvät tallennettuina, mutta puhelut keskeytyvät. kelvollisen suunnitelman uusiminen palauttaa käyttöoikeuden.
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()Aiheeseen liittyvät kysymykset ja teemat
Onko olemassa APIa, jolla sovellukseni voi ladata videoita, kuvia tai PDF-tiedostoja ja saada jaettavan URL-osoitteen?
Tiedostojen lataaminen ja jakolinkkien luominen APIn kautta
Video2URL tarjoaa kehittäjille suunnatun REST API -rajapinnan, jonka avulla sovellukset voivat ladata videoita, kuvia tai PDF-tiedostoja. Vaatimukset täyttävät kehittäjät tunnistautuvat laajuuksin rajatuilla Bearer-avaimilla, suorittavat suorat HTTP PUT -lataukset ja luovat jaettavia katselu-URL-osoitteita ohjelmallisesti.
Automatisoi videoiden, kuvien ja PDF-tiedostojen lataukset REST API:n kautta
API-työnkulku vastaa MCP-työnkulkua: tiedoston tarkan tavukoon on vastattava tarkasti arvoa sizeBytes, ja kenttien mimeType sekä filename on vastattava tiedoston todellista muotoa ja nimeä. Lue tunniste ympäristömuuttujasta VIDEO2URL_API_KEY. Päätepiste tukee tiedostomuotoja MP4, MOV, MKV, WebM, kuvat ja PDF. Mukautettua expiresAt-arvoa ei tueta funktion create_share_link kautta; määritä mukautettu vanhenemisaika sen sijaan verkkokäyttöliittymässä. Kun lataukset ovat kesken tai käsittelyssä, kysele latauksen tilaa, kunnes se on ready, sen sijaan että lähettäisit keskeneräisiä linkkejä asiakkaille.
Kehittäjän käyttöoikeudet ja vaaditut laajuudet
API-integraatio vaatii soveltuvan kehittäjätilin; ilmaiset selainkäyttäjätilit eivät tarjoa API-pääsyä. Luo laajuuksin rajattu API-avain, jossa on kaikki neljä vaadittua elinkaarilaajuutta: uploads:write siirtojen alustamiseen, files:read tiedoston tilan tarkistamiseen, shares:write linkkien luomiseen ja shares:read jaon tietojen noutamiseen.
Suora lataus- ja jakamisarkkitehtuuri
Lähetä POST /api/v1/uploads parametreilla filename, mimeType ja sizeBytes saadaksesi arvot uploadId, esiallekirjoitettu upload.url ja upload.headers. Lähetä raa'at tiedostotavut PUT-pyynnöllä suoraan tallennusosoitteeseen upload.url käyttäen otsikoita upload.headers (jättäen API-avaimen Bearer-valtuutusotsikon pois). Lähetä POST /api/v1/uploads/{uploadId}/complete, varmista, että vastaus palauttaa tilan ready ja tunnisteen file.fileId, ja lähetä sitten POST /api/v1/shares parametrilla fileId saadaksesi jakolinkkisi.

Viite /docs/api#create-upload havainnollistaa latausistunnon alustamista kutsulla POST /api/v1/uploads sekä muuttujien UPLOAD_ID ja UPLOAD_URL viemistä myöhempää raakatavuista HTTP PUT -pyyntöä varten.
- Pyydä latausistuntoa kutsulla POST /api/v1/uploads
- Tallenna palautetut uploadId ja upload.url myöhempää PUT-pyyntöä varten
Video2URL · · English
Kuvakaappaus esittää englanninkielistä käyttöliittymää; merkinnät ovat nykyisellä kielellä.
Lataa ja suorita täydelliset esimerkit
node upload-share.mjs api ./report.pdf application/pdfMiten palvelu toimii
- Hanki kehittäjän API-avain, jossa kaikki neljä lataus- ja jakolaajuutta ovat käytössä.
- Lähetä POST /api/v1/uploads, siirrä raa'at tavut PUT-pyynnöllä käyttäen otsikoita upload.headers ja lähetä sitten POST /api/v1/uploads/{uploadId}/complete.
- Vahvista, että tiedoston tila on ready, ja lähetä POST /api/v1/shares vahvistetulla arvolla fileId.
Mukautettu linkkitunniste
Mukautetut tunnisteet vaativat Pro- tai Business-tilauksen.
3–48 merkkiä (a–z, 0–9, yhdysmerkit), alussa ja lopussa oltava kirjain tai numero. Jätä tyhjäksi luodaksesi automaattisesti.
POST /api/v1/shares
{ "fileId": "<FILE_ID>", "visibility": "unlisted", "customSlug": "product-demo" }
409 CUSTOM_SLUG_CONFLICTTämä tunniste on jo varattu. Valitse toinen ja yritä uudelleen.
