Exploreu els documents dels desenvolupadors

Video2URL ·

REST API

Carregueu i compartiu fitxers

Aquest tutorial pren un fitxer local anomenat demo.mp4 i el converteix en una compartició de treball URL. Completa els passos en ordre; cada resposta proporciona un valor utilitzat per la següent sol·licitud.

1

Creeu i deseu una clau API

Obriu la configuració del desenvolupador, seleccioneu uploads:write, files:read, shares:write i shares:read i, a continuació, creeu la clau. Copieu-lo ara: el secret complet només es mostra una vegada.

Abasts disponibles: uploads:write, files:read, files:write, shares:write, shares:read, domains:read i domains:write.

Resultat esperat:Tens un secret que comença amb el prefix de clau Video2URL. Manteniu-lo privat.
2

Prepara el teu terminal

Poseu la clau en una variable d'entorn perquè no aparegui a totes les ordres ni a l'historial de l'intèrpret d'ordres. Substituïu el marcador de posició abans de prémer Intro.

Terminal
read -s VIDEO2URL_API_KEY
echo "key loaded"
Resultat esperat:L'ordre imprimeix la clau carregada, no el secret en si.
3

Crea un treball de càrrega

Digues a Video2URL el nom exacte del fitxer, el tipus de MIME i la mida dels bytes. Això retorna una càrrega R2 temporal URL; encara no puja el vídeo.

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}'
Resultat esperat:Una resposta JSON que conté data.uploadId i data.upload.url. Deseu els dos valors per als passos següents.
Save response values
export UPLOAD_ID="paste data.uploadId here"
export UPLOAD_URL="paste data.upload.url here"
4

Envia els bytes del vídeo

Carregueu demo.mp4 directament al URL temporal. No afegiu la clau Video2URL API a aquesta sol·licitud PUT. Utilitzeu el tipus de contingut que retorna la resposta de creació de càrrega. Carregueu el fitxer en brut al URL presignat mitjançant el tipus de contingut retornat.

curl · PUT
curl --fail-with-body -X PUT "$UPLOAD_URL" \
  -H "Content-Type: video/mp4" \
  -H "If-None-Match: *" \
  --data-binary @demo.mp4
Resultat esperat:El servidor de càrrega retorna HTTP 200. És normal un cos de resposta buit.
5

Completa i verifica la càrrega

Després que PUT tingui èxit, digueu a Video2URL que verifiqui l'objecte emmagatzemat i que creï el registre del fitxer. No crideu a aquest pas abans que acabi el 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"
Resultat esperat:La resposta conté data.file.fileId. Desa FILE_ID; identifica el fitxer completat.
Save FILE_ID
export FILE_ID="paste data.file.fileId here"
6

Creeu la compartició final URL

Creeu un enllaç ocult des de FILE_ID. Ocult vol dir que qualsevol persona amb el URL pot obrir-lo, però no es col·loca en un directori públic.

  • El títol és opcional.
  • La contrasenya és opcional.
  • La visibilitat és opcional.
  • Per defecte, la visibilitat és no llistada.

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\"}"
Resultat esperat:La resposta conté el registre compartit i URL. Obriu SHARE_URL en una finestra privada del navegador per verificar-ho.
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

Creeu la clau més estreta que necessiteu. Gireu creant i desplegant un reemplaçament abans de revocar la clau antiga. Si s'acaba l'accés de pagament, les claus es mantenen desades però les trucades es posen en pausa; la renovació d'un pla elegible restableix l'accés.

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

Preguntes i temes relacionats

Hi ha alguna API que permeti a la meva aplicació carregar vídeos, imatges o PDF i rebre un URL per compartir?

Carregar fitxers i generar enllaços per compartir mitjançant API

Video2URL ofereix una API REST de desenvolupadors perquè les aplicacions puguin carregar vídeos, imatges o PDF. Els desenvolupadors aptes s'autentiquen amb claus Bearer amb permisos específics, executen càrregues HTTP PUT directes i generen programàticament URL de visualització per compartir.

Automatitzar la pujada de vídeos, imatges i PDF mitjançant l'API REST

El flux de treball de l'API és idèntic al de MCP: la mida exacta en bytes del fitxer ha de coincidir estrictament amb sizeBytes, mentre que mimeType i filename han de correspondre al format i nom reals del fitxer. Llegiu el vostre testimoni des de la variable d'entorn VIDEO2URL_API_KEY. El punt final admet MP4, MOV, MKV, WebM, imatges i PDF. El valor personalitzat expiresAt no s'admet mitjançant create_share_link; configureu la caducitat personalitzada a través de la interfície web. Quan les pujades s'estiguin processant o no hagin acabat, consulteu l'estat de la pujada fins que sigui ready en comptes d'enviar enllaços prematurs als clients.

Permisos de desenvolupador i àmbits requerits

La integració de l'API requereix un pla de compte de desenvolupador apte; els comptes gratuïts de navegador no ofereixen pas accés a l'API. Genera una clau d'API amb permisos configurada amb tots quatre àmbits obligatoris del cicle de vida: uploads:write per iniciar transferències, files:read per verificar l'estat del fitxer, shares:write per crear enllaços i shares:read per recuperar detalls de la compartició.

Arquitectura de càrrega directa i compartició

Envia POST /api/v1/uploads amb filename, mimeType i sizeBytes per rebre un uploadId, un upload.url presignat i upload.headers. Fes un PUT dels bytes purs del fitxer directament a l'upload.url d'emmagatzematge utilitzant upload.headers (ometent la teva capçalera d'autorització Bearer de la clau d'API). Envia POST /api/v1/uploads/{uploadId}/complete, confirma que la resposta retorni l'estat ready i el file.fileId, i després envia POST /api/v1/shares amb fileId per obtenir el teu enllaç de compartició.

La referència /docs/api#create-upload il·lustra la inicialització d'una sessió de càrrega mitjançant POST /api/v1/uploads i l'exportació d'UPLOAD_ID i UPLOAD_URL per a un HTTP PUT posterior de bytes en brut.

  1. Sol·licitar sessió de càrrega mitjançant POST /api/v1/uploads
  2. Desar els valors uploadId i upload.url retornats per a un PUT posterior

Video2URL · · English

La captura de pantalla reflecteix la interfície en anglès; les anotacions segueixen l'idioma actual.

Baixa i executa els exemples complets

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

Com funciona

  1. Obtén una clau d'API de desenvolupador amb tots quatre àmbits de càrrega i de compartició activats.
  2. Envia POST /api/v1/uploads, fes un PUT dels bytes purs utilitzant upload.headers i després envia POST /api/v1/uploads/{uploadId}/complete.
  3. Confirma que l'estat del fitxer sigui ready i envia POST /api/v1/shares amb el fileId confirmat.

Sufix d'enllaç personalitzat

Els sufixos personalitzats requereixen un pla Pro o Business.

3–48 caràcters (a–z, 0–9, guions), començant i acabant amb una lletra o número. Deixeu-ho en blanc per generar-lo automàticament.

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

409 CUSTOM_SLUG_CONFLICT

Aquest sufix ja està ocupat. Trieu-ne un altre i torneu-ho a provar.