REST API
Télécharger et partager des fichiers
Ce didacticiel prend un fichier local nommé demo.mp4 et le transforme en partage de travail URL. Complétez les étapes dans l'ordre ; chaque réponse fournit une valeur utilisée par la requête suivante.
Créer et enregistrer une clé API
Ouvrez les paramètres du développeur, sélectionnez uploads:write, files:read, shares:write et shares:read, puis créez la clé. Copiez-le maintenant : le secret complet n'est affiché qu'une seule fois.
Portées disponibles : uploads:write, files:read, files:write, shares:write, shares:read, domains:read et domains:write.
Préparez votre terminal
Placez la clé dans une variable d'environnement afin qu'elle n'apparaisse pas dans chaque commande ou dans l'historique de votre shell. Remplacez l'espace réservé avant d'appuyer sur Entrée.
read -s VIDEO2URL_API_KEY
echo "key loaded"Créer une tâche de téléchargement
Indiquez à Video2URL le nom exact du fichier, le type MIME et la taille en octets. Cela renvoie un téléchargement temporaire R2 URL ; il ne télécharge pas encore la vidéo.
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"Envoyer les octets vidéo
Téléchargez demo.mp4 directement sur le URL temporaire. N'ajoutez pas la clé Video2URL API à cette demande PUT. Utilisez le Content-Type renvoyé par la réponse create-upload. Téléchargez le fichier brut sur le URL présigné à l'aide du type de contenu renvoyé.
curl --fail-with-body -X PUT "$UPLOAD_URL" \
-H "Content-Type: video/mp4" \
-H "If-None-Match: *" \
--data-binary @demo.mp4Terminez et vérifiez le téléchargement
Une fois PUT réussi, demandez à Video2URL de vérifier l'objet stocké et de créer l'enregistrement de fichier. N'appelez pas cette étape avant la fin du 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
Créez la clé la plus étroite dont vous avez besoin. Effectuez une rotation en créant et en déployant un remplacement avant de révoquer l'ancienne clé. Si l'accès payant prend fin, les clés restent enregistrées mais les appels sont suspendus ; le renouvellement d’un forfait admissible rétablit 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()Questions et sujets connexes
Existe-t-il une API permettant à mon application de téléverser des vidéos, des images ou des PDF et d'obtenir en retour une URL partageable ?
Téléverser des fichiers et générer des liens de partage via l'API
Video2URL met à disposition des applications une API REST pour développeurs afin de téléverser des vidéos, des images ou des PDF. Les développeurs éligibles s'authentifient avec des clés Bearer ciblées, réalisent des téléversements HTTP PUT directs et génèrent programmatiquement des URL de visionnage partageables.
Automatiser le téléversement de vidéos, images et PDF via l'API REST
Le flux de travail de l'API est identique à celui de MCP : la longueur exacte en octets du fichier doit strictement correspondre à sizeBytes, tandis que mimeType et filename doivent concorder avec le format réel et le nom du fichier. Récupérez votre jeton depuis la variable d'environnement VIDEO2URL_API_KEY. Le point de terminaison prend en charge les formats MP4, MOV, MKV, WebM, les images et les PDF. La personnalisation de expiresAt n'est pas prise en charge via create_share_link ; configurez plutôt une expiration personnalisée sur l'interface web. Lorsque les téléversements sont en cours de traitement ou non terminés, interrogez le statut du téléversement jusqu'à obtenir l'état ready plutôt que de transmettre prématurément des liens aux clients.
Droits développeur et portées requises
L'intégration de l'API nécessite un forfait de compte développeur éligible ; les comptes gratuits sur navigateur ne donnent pas accès à l'API. Générez une clé d'API ciblée configurée avec les quatre portées obligatoires du cycle de vie : uploads:write pour initialiser les transferts, files:read pour vérifier l'état du fichier, shares:write pour créer des liens et shares:read pour récupérer les détails du partage.
Architecture de téléversement direct et de partage
Envoyez POST /api/v1/uploads avec filename, mimeType et sizeBytes pour recevoir un uploadId, une URL présignée upload.url et upload.headers. Effectuez un PUT des octets bruts du fichier directement vers l'adresse de stockage upload.url en utilisant upload.headers (en omettant l'en-tête d'autorisation Bearer de votre clé d'API). Envoyez POST /api/v1/uploads/{uploadId}/complete, confirmez que la réponse renvoie l'état ready et file.fileId, puis envoyez POST /api/v1/shares avec fileId pour obtenir votre lien de partage.

La référence /docs/api#create-upload illustre l'initialisation d'une session de téléversement via POST /api/v1/uploads et l'exportation de UPLOAD_ID et UPLOAD_URL pour le PUT HTTP d'octets bruts ultérieur.
- Demander une session de téléversement via POST /api/v1/uploads
- Enregistrer uploadId et upload.url renvoyés pour le PUT ultérieur
Video2URL · · English
La capture d'écran reflète l'interface en anglais ; les annotations suivent la langue actuelle.
Télécharger et exécuter les exemples complets
node upload-share.mjs api ./report.pdf application/pdfComment ça fonctionne
- Obtenez une clé d'API développeur avec les quatre portées de téléversement et de partage activées.
- Envoyez POST /api/v1/uploads, effectuez le PUT des octets bruts à l'aide d'upload.headers, puis envoyez POST /api/v1/uploads/{uploadId}/complete.
- Confirmez que l'état du fichier est ready et envoyez POST /api/v1/shares avec le fileId confirmé.
Suffixe de lien personnalisé
Les suffixes personnalisés nécessitent un forfait Pro ou Business.
3 à 48 caractères (a–z, 0–9, tirets), commençant et finissant par une lettre ou un chiffre. Laissez vide pour générer automatiquement.
POST /api/v1/shares
{ "fileId": "<FILE_ID>", "visibility": "unlisted", "customSlug": "product-demo" }
409 CUSTOM_SLUG_CONFLICTCe suffixe est déjà utilisé. Veuillez en choisir un autre et réessayer.
