Une API d'hébergement vidéo pour développeurs

Ce que couvre l'API

L'interface reprend ce que vous pouvez faire dans le tableau de bord. Vous pouvez lire les détails du compte et le stockage, demander un serveur d'envoi et envoyer un fichier, importer une vidéo par URL, lister et inspecter les fichiers, les déplacer et les renommer, créer des dossiers, rechercher des vidéos et gérer la file d'envoi à distance. Quelques extras permettent d'associer une image d'accueil ou des sous-titres depuis une adresse distante.

Les requêtes sont de simples GET ou POST HTTP. Votre clé API se place dans un paramètre key et se trouve dans les paramètres de votre compte. Chaque réponse est un JSON avec un message, un code de statut, l'heure du serveur et un résultat. Un statut 429 signifie que vous avez atteint la limite de 10 requêtes par seconde ; contactez l'assistance si vous avez besoin de plus.

Intégrations courantes

Des flux de publication qui envoient une vidéo rendue directement depuis un serveur de build, des outils de contenu qui importent un lien depuis un tableur, des plugins qui listent la bibliothèque d'un créateur sur un site et des scripts de surveillance qui suivent l'état de l'encodage. Les clients officiels PHP et Python sont annoncés prochainement : pour l'instant, appelez les endpoints directement, comme ci-dessous.

Faites votre premier appel

1. 1Connectez-vous et copiez votre clé API depuis la page des paramètres du compte.
2. 2Appelez le endpoint d'infos du compte pour vérifier que la clé fonctionne et voir votre stockage et votre solde.
3. 3Demandez un serveur d'envoi avec le endpoint dédié et notez l'adresse renvoyée.
4. 4Postez le fichier à cette adresse en multipart form data. La réponse contient le code du fichier, un lien de visionnage et un lien d'intégration.
5. 5Interrogez le endpoint de vérification, ou listez les fichiers, pour savoir quand le traitement est terminé.

Exemples avec de vrais endpoints

curl : infos compte et envoi

Le premier appel vérifie la clé. Le second envoie un fichier à l'adresse du serveur renvoyée par l'appel du serveur d'envoi.

curl "https://filehost.net/api/account/info?key=YOUR_API_KEY"

curl "https://filehost.net/api/upload/server?key=YOUR_API_KEY"

curl -X POST -F 'api_key=YOUR_API_KEY' -F '[email protected]' \
  "https://filehost.net/api/upload/server/01?key=YOUR_API_KEY"

PHP : importer une vidéo par URL

Ajoute une tâche d'envoi distant et affiche le code du fichier. Utilisez urlencode sur l'adresse source.

<?php
$key = 'YOUR_API_KEY';
$src = urlencode('https://example.com/video.mp4');
$res = json_decode(file_get_contents(
    "https://filehost.net/api/upload/url?key=$key&url=$src"
), true);
echo $res['result']['filecode'] ?? 'failed';

JavaScript : vérifier un fichier

Fonctionne avec Node 18 ou plus récent et dans un navigateur, tant que la clé reste côté serveur.

const key = process.env.FILEHOST_KEY;
const code = 'FILE_CODE';
const r = await fetch(
  `https://filehost.net/api/file/check?key=${key}&file_code=${code}`
);
const data = await r.json();
console.log(data.result[0].status);

Bonnes pratiques

Gardez la clé hors du code côté client, car quiconque la voit peut agir en votre nom. Respectez la limite de 10 requêtes par seconde en mettant les appels en file et en patientant après une réponse 429. Conservez le code de fichier renvoyé par un envoi, car tous les autres appels désignent un fichier par ce code.

Les gros envois se font de préférence depuis un serveur à connexion stable. Pour les fichiers déjà en ligne, préférez l'import par URL, qui utilise la connexion du serveur et répond aussitôt avec un code de tâche.

Gérer les erreurs en pratique

Vérifiez à la fois le statut HTTP et le champ status dans le corps JSON, et journalisez le message, qui explique généralement ce qui n'a pas marché. Considérez un code de fichier manquant ou une clé expirée comme un échec définitif, et une réponse 429 comme un signal d'attendre et de réessayer. Pour les traitements par lots, conservez localement chaque code de fichier retourné afin qu'un script interrompu puisse reprendre sans rien envoyer deux fois.

Ce que l'API ne fait pas

Aucun callback webhook n'est documenté : la fin du traitement se vérifie donc par interrogation régulière. La réponse d'envoi documentée donne le code du fichier et les liens, et les bibliothèques clientes officielles ne sont pas encore publiées. S'il vous manque une fonctionnalité, signalez-le à l'assistance via la page de contact.

FileHost.net face à la concurrence

Vous comparez des hébergeurs pour une intégration ? Comparez ce que chacun expose.

Toutes les comparaisons

Outils et guides associés