REST API
Last opp og del filer
Denne veiledningen tar én lokal fil med navnet demo.mp4 og gjør den om til en fungerende delt deling URL. Fullfør trinnene i rekkefølge; hvert svar angir en verdi som brukes av neste forespørsel.
Opprett og lagre en API-nøkkel
Åpne utviklerinnstillingene, velg uploads:write, files:read, shares:write og shares:read, og opprett deretter nøkkelen. Kopier den nå – hele hemmeligheten vises bare én gang.
Tilgjengelige omfang: uploads:write, files:read, files:write, shares:write, shares:read, domains:read og domains:write.
Klargjør terminalen din.
Plasser nøkkelen i en miljøvariabel slik at den ikke vises i alle kommandoer eller i skallhistorikken din. Erstatt plassholderen før du trykker Enter.
read -s VIDEO2URL_API_KEY
echo "key loaded"Opprett en opplastingsjobb
Gi Video2URL det nøyaktige filnavnet, MIME-typen og bytestørrelsen. Dette returnerer en midlertidig R2-opplasting URL; videoen lastes ikke opp ennå.
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"Send videobytene
Last opp demo.mp4 direkte til den midlertidige URL. Ikke legg til Video2URL API-nøkkelen i denne PUT-forespørselen. Bruk innholdstypen som returneres av create-upload-svaret. Last opp rådfilen til den forhåndsbestemte URL ved hjelp av den returnerte innholdstypen.
curl --fail-with-body -X PUT "$UPLOAD_URL" \
-H "Content-Type: video/mp4" \
-H "If-None-Match: *" \
--data-binary @demo.mp4Fullfør og bekreft opplastingen.
Etter at PUT lykkes, ber du Video2URL bekrefte det lagrede objektet og opprette filoppføringen. Ikke kall dette trinnet før PUT er ferdig.
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
Opprett den smaleste nøkkelen du trenger. Roter ved å opprette og distribuere en erstatning før du tilbakekaller den gamle nøkkelen. Hvis betalt tilgang avsluttes, forblir nøklene lagret, men anrop settes på pause. Fornyelse av en kvalifisert plan gjenoppretter tilgangen.
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()Relaterte spørsmål og emner
Finnes det et API som lar appen min laste opp videoer, bilder eller PDF-er og få en delbar URL tilbake?
Opplasting av filer og generering av delingslenker via API
Video2URL tilbyr et REST-API for utviklere slik at applikasjoner kan laste opp videoer, bilder eller PDF-er. Kvalifiserte utviklere autentiserer med avgrensede Bearer-nøkler, utfører direkte HTTP PUT-opplastinger og genererer delbare visnings-URL-er programmatisk.
Automatiser video-, bilde- og PDF-opplastinger via REST API
API-arbeidsflyten speiler MCP: nøyaktig fillengde i byte må samsvare strengt med sizeBytes, mens mimeType og filename må tilsvare faktisk filformat og filnavn. Les tokenet ditt fra miljøvariabelen VIDEO2URL_API_KEY. Endepunktet støtter MP4, MOV, MKV, WebM, bilder og PDF. Tilpasset expiresAt støttes ikke via create_share_link; konfigurer tilpasset utløp i webgrensesnittet i stedet. Når opplastinger behandles eller er uferdige, spør etter opplastingsstatus frem til ready i stedet for å sende ut lenker til klienter for tidlig.
Utviklerrettigheter og påkrevde scopes
API-integrasjon krever et kvalifisert utviklerabonnement; gratis nettleserkontoer gir ikke API-tilgang. Generer en avgrenset API-nøkkel konfigurert med alle fire påkrevde livssyklus-scopes: uploads:write for å initialisere overføringer, files:read for å verifisere filstatus, shares:write for å opprette lenker og shares:read for å hente delingsdetaljer.
Direkte opplastings- og delingsarkitektur
Send POST /api/v1/uploads med filename, mimeType og sizeBytes for å motta en uploadId, forhåndssignert upload.url og upload.headers. PUT rå fil-byte direkte til lagringens upload.url ved hjelp av upload.headers (uten API-nøkkelens Bearer-autorisasjonshode). Send POST /api/v1/uploads/{uploadId}/complete, bekreft at responsen returnerer status ready og file.fileId, og send deretter POST /api/v1/shares med fileId for å få delingslenken din.

Referansen /docs/api#create-upload illustrerer initialisering av en opplastingsøkt via POST /api/v1/uploads og eksport av UPLOAD_ID og UPLOAD_URL for påfølgende råbyte HTTP PUT.
- Be om opplastingsøkt via POST /api/v1/uploads
- Lagre returnert uploadId og upload.url for påfølgende PUT
Video2URL · · English
Skjermbildet gjenspeiler det engelske grensesnittet; merknader følger gjeldende språk.
Last ned og kjør fullstendige eksempler
node upload-share.mjs api ./report.pdf application/pdfSlik fungerer det
- Skaff en utvikler-API-nøkkel med alle fire opplastings- og delings-scopes aktivert.
- Send POST /api/v1/uploads, PUT rå byte ved hjelp av upload.headers, og send deretter POST /api/v1/uploads/{uploadId}/complete.
- Bekreft at filstatusen er ready og send POST /api/v1/shares med den bekreftede fileId.
Egendefinert lenkesuffiks
Egendefinerte suffikser krever et Pro- eller Business-abonnement.
3–48 tegn (a–z, 0–9, bindestrek), må starte og slutte med en bokstav eller et tall. La stå tomt for automatisk generering.
POST /api/v1/shares
{ "fileId": "<FILE_ID>", "visibility": "unlisted", "customSlug": "product-demo" }
409 CUSTOM_SLUG_CONFLICTDette suffikset er allerede i bruk. Vennligst velg et annet og prøv igjen.
