API de alojamiento de video para desarrolladores

Qué cubre la API

La interfaz refleja lo que puedes hacer en el panel. Puedes leer datos de cuenta y almacenamiento, pedir un servidor de subida y enviar un archivo, importar un video desde una URL, listar e inspeccionar archivos, moverlos y renombrarlos, crear carpetas, buscar videos y gestionar la cola de subida remota. Algunos extras permiten adjuntar una imagen de portada o subtítulos desde una dirección remota.

Las solicitudes son GET o POST HTTP normales. Tu clave API va en un parámetro key y está en los ajustes de tu cuenta. Cada respuesta es JSON con un mensaje, un código de estado, la hora del servidor y un resultado. Un estado 429 significa que superaste el límite de 10 solicitudes por segundo; contacta con soporte si necesitas más.

Integraciones habituales

Flujos de publicación que envían un video renderizado directamente desde un servidor de compilación, herramientas de contenido que importan un enlace desde una hoja de cálculo, plugins que listan la biblioteca de un creador en una web y scripts de monitorización que vigilan el estado de la codificación. Los clientes oficiales de PHP y Python figuran como próximamente, así que por ahora llamas a los endpoints directamente como se muestra abajo.

Haz tu primera llamada

1. 1Inicia sesión y copia tu clave API desde la página de ajustes de la cuenta.
2. 2Llama al endpoint de información de cuenta para confirmar que la clave funciona y ver tu almacenamiento y saldo.
3. 3Pide un servidor de subida con su endpoint y anota la dirección que devuelve.
4. 4Envía el archivo a esa dirección como multipart form data. La respuesta incluye el código de archivo, un enlace de reproducción y uno de inserción.
5. 5Consulta el endpoint de comprobación de archivo, o lista los archivos, para saber cuándo termina el procesamiento.

Ejemplos con endpoints reales

curl: datos de cuenta y subida

La primera llamada comprueba la clave. La segunda envía un archivo a la dirección del servidor devuelta por la llamada de servidor de subida.

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: importar un video desde una URL

Añade una tarea de subida remota e imprime el código de archivo. Usa urlencode en la dirección de origen.

<?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';

Comprobar un archivo con JavaScript

Funciona en Node 18 o posterior y en un navegador, siempre que mantengas la clave en el lado del servidor.

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

Buenas prácticas

Mantén la clave fuera del código del lado del cliente, porque quien la vea puede actuar como tu cuenta. Respeta el límite de 10 solicitudes por segundo poniendo las llamadas en cola y esperando ante una respuesta 429. Guarda el código de archivo devuelto por una subida, ya que cualquier otra llamada se refiere al archivo por ese código.

Las subidas grandes se envían mejor desde un servidor con conexión estable. Para archivos que ya están en línea, prefiere la importación por URL, que usa la conexión del servidor y responde de inmediato con un código de tarea.

Gestión de errores en la práctica

Comprueba tanto el estado HTTP como el campo status dentro del cuerpo JSON y registra el texto del mensaje, que suele explicar qué falló. Trata un código de archivo ausente o una clave caducada como un fallo grave, y una respuesta 429 como señal para esperar y reintentar. Al crear tareas por lotes, guarda localmente cada código de archivo devuelto para que un script que se caiga pueda reanudar sin subir nada dos veces.

Lo que la API no hace

No hay documentado ningún callback webhook, así que la finalización se comprueba consultando periódicamente. La respuesta de subida documentada da el código de archivo y los enlaces, y las bibliotecas cliente oficiales aún no están publicadas. Si necesitas una función que falta, díselo a soporte en la página de contacto.

FileHost.net frente a otros

¿Evalúas alojamientos para una integración? Compara lo que expone cada uno.

Ver todas las comparativas

Herramientas y guías relacionadas