Bla gjennom utviklerdokumentasjon

Video2URL ·

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.

1

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.

Forventet resultat:Du har en hemmelighet som begynner med nøkkelprefikset Video2URL. Hold den privat.
2

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.

Terminal
read -s VIDEO2URL_API_KEY
echo "key loaded"
Forventet resultat:Kommandoen skriver ut nøkkelen som er lastet inn, ikke selve hemmeligheten.
3

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
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}'
Forventet resultat:Et JSON-svar som inneholder data.uploadId og data.upload.url. Lagre begge verdiene for de neste trinnene.
Save response values
export UPLOAD_ID="paste data.uploadId here"
export UPLOAD_URL="paste data.upload.url here"
4

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 · PUT
curl --fail-with-body -X PUT "$UPLOAD_URL" \
  -H "Content-Type: video/mp4" \
  -H "If-None-Match: *" \
  --data-binary @demo.mp4
Forventet resultat:Opplastingsserveren returnerer HTTP 200. En tom svartekst er normalt.
5

Fullfø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
curl -sS -X POST "https://video2url.com/api/v1/uploads/$UPLOAD_ID/complete" \
  -H "Authorization: Bearer $VIDEO2URL_API_KEY"
Forventet resultat:Svaret inneholder data.file.fileId. Lagre FILE_ID; det identifiserer den fullførte filen.
Save FILE_ID
export FILE_ID="paste data.file.fileId here"
6

Opprett den endelige delingen URL

Opprett en ikke-oppført lenke fra FILE_ID. Ikke-oppført betyr at alle med URL kan åpne den, men den plasseres ikke i en offentlig katalog.

  • Tittelen er valgfri.
  • Passord er valgfritt.
  • Synlighet er valgfritt.
  • Synlighet er som standard satt til ikke oppført.

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\"}"
Forventet resultat:Svaret inneholder delingsoppføringen og URL. Åpne SHARE_URL i et privat nettleservindu for å bekrefte det.
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

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.

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

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.

  1. Be om opplastingsøkt via POST /api/v1/uploads
  2. 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/pdf

Slik fungerer det

  1. Skaff en utvikler-API-nøkkel med alle fire opplastings- og delings-scopes aktivert.
  2. Send POST /api/v1/uploads, PUT rå byte ved hjelp av upload.headers, og send deretter POST /api/v1/uploads/{uploadId}/complete.
  3. 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.

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

409 CUSTOM_SLUG_CONFLICT

Dette suffikset er allerede i bruk. Vennligst velg et annet og prøv igjen.