Selaa kehittäjien asiakirjoja

Video2URL ·

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.

1

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

Odotettu tulos:Sinulla on salaisuus, joka alkaa avaimen etuliitteellä Video2URL. Pidä se yksityisenä.
2

Valmistele terminaali

Aseta avain ympäristömuuttujaan, jotta se ei näy jokaisessa komennossa tai komentotulkkihistoriassasi. Vaihda paikkamerkki ennen Enter-näppäintä.

Terminal
read -s VIDEO2URL_API_KEY
echo "key loaded"
Odotettu tulos:Komento tulostaa avaimen ladatun, ei itse salaisuutta.
3

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
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}'
Odotettu tulos:JSON-vastaus, joka sisältää data.uploadId:n ja data.upload.url.:n Tallenna molemmat arvot seuraavia vaiheita varten.
Save response values
export UPLOAD_ID="paste data.uploadId here"
export UPLOAD_URL="paste data.upload.url here"
4

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 · PUT
curl --fail-with-body -X PUT "$UPLOAD_URL" \
  -H "Content-Type: video/mp4" \
  -H "If-None-Match: *" \
  --data-binary @demo.mp4
Odotettu tulos:Latauspalvelin palauttaa HTTP 200. Tyhjä vastausteksti on normaalia.
5

Viimeistele 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
curl -sS -X POST "https://video2url.com/api/v1/uploads/$UPLOAD_ID/complete" \
  -H "Authorization: Bearer $VIDEO2URL_API_KEY"
Odotettu tulos:Vastaus sisältää data.file.fileId. Tallenna FILE_ID; se tunnistaa valmiin tiedoston.
Save FILE_ID
export FILE_ID="paste data.file.fileId here"
6

Luo lopullinen jako URL

Luo piilotettu linkki kohteesta FILE_ID. Listaamaton tarkoittaa, että kuka tahansa, jolla on URL, voi avata sen, mutta sitä ei sijoiteta julkiseen hakemistoon.

  • Otsikko on valinnainen.
  • Salasana on valinnainen.
  • Näkyvyys on valinnainen.
  • Näkyvyys on oletusarvoisesti piilotettu.

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\"}"
Odotettu tulos:Vastaus sisältää osuustietueen ja URL. Tarkista se avaamalla SHARE_URL yksityisessä selainikkunassa.
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

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.

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

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.

  1. Pyydä latausistuntoa kutsulla POST /api/v1/uploads
  2. 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/pdf

Miten palvelu toimii

  1. Hanki kehittäjän API-avain, jossa kaikki neljä lataus- ja jakolaajuutta ovat käytössä.
  2. 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.
  3. 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.

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

409 CUSTOM_SLUG_CONFLICT

Tämä tunniste on jo varattu. Valitse toinen ja yritä uudelleen.