Parcourir la documentation des développeurs

Video2URL ·

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.

1

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.

Résultat attendu :Vous disposez d'un secret qui commence par le préfixe de clé Video2URL. Gardez-le privé.
2

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.

Terminal
read -s VIDEO2URL_API_KEY
echo "key loaded"
Résultat attendu :La commande imprime la clé chargée, pas le secret lui-même.
3

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
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}'
Résultat attendu :Une réponse JSON contenant data.uploadId et data.upload.url. Enregistrez les deux valeurs pour les étapes suivantes.
Save response values
export UPLOAD_ID="paste data.uploadId here"
export UPLOAD_URL="paste data.upload.url here"
4

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 · PUT
curl --fail-with-body -X PUT "$UPLOAD_URL" \
  -H "Content-Type: video/mp4" \
  -H "If-None-Match: *" \
  --data-binary @demo.mp4
Résultat attendu :Le serveur de téléchargement renvoie HTTP 200. Un corps de réponse vide est normal.
5

Terminez 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
curl -sS -X POST "https://video2url.com/api/v1/uploads/$UPLOAD_ID/complete" \
  -H "Authorization: Bearer $VIDEO2URL_API_KEY"
Résultat attendu :La réponse contient data.file.fileId. Enregistrez FILE_ID ; il identifie le fichier finalisé.
Save FILE_ID
export FILE_ID="paste data.file.fileId here"
6

Créer le partage final URL

Créez un lien non répertorié à partir de FILE_ID. Non répertorié signifie que toute personne possédant le URL peut l'ouvrir, mais il n'est pas placé dans un répertoire public.

  • Le titre est facultatif.
  • Le mot de passe est facultatif.
  • La visibilité est facultative.
  • La visibilité par défaut est non répertoriée.

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\"}"
Résultat attendu :La réponse contient l'enregistrement de partage et URL. Ouvrez SHARE_URL dans une fenêtre de navigateur privé pour le vérifier.
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

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.

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

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.

  1. Demander une session de téléversement via POST /api/v1/uploads
  2. 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/pdf

Comment ça fonctionne

  1. Obtenez une clé d'API développeur avec les quatre portées de téléversement et de partage activées.
  2. Envoyez POST /api/v1/uploads, effectuez le PUT des octets bruts à l'aide d'upload.headers, puis envoyez POST /api/v1/uploads/{uploadId}/complete.
  3. 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.

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

409 CUSTOM_SLUG_CONFLICT

Ce suffixe est déjà utilisé. Veuillez en choisir un autre et réessayer.