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.
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.
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.
read -s VIDEO2URL_API_KEY
echo "key loaded"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 -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"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 --fail-with-body -X PUT "$UPLOAD_URL" \
-H "Content-Type: video/mp4" \
-H "If-None-Match: *" \
--data-binary @demo.mp4Completa 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 -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
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.
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()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.
- Sol·licitar sessió de càrrega mitjançant POST /api/v1/uploads
- 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/pdfCom funciona
- Obtén una clau d'API de desenvolupador amb tots quatre àmbits de càrrega i de compartició activats.
- Envia POST /api/v1/uploads, fes un PUT dels bytes purs utilitzant upload.headers i després envia POST /api/v1/uploads/{uploadId}/complete.
- 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.
POST /api/v1/shares
{ "fileId": "<FILE_ID>", "visibility": "unlisted", "customSlug": "product-demo" }
409 CUSTOM_SLUG_CONFLICTAquest sufix ja està ocupat. Trieu-ne un altre i torneu-ho a provar.
