API REST DE PRODUCCIÓN · v1

Construir descargas con YTSave

Resolver una URL de medios públicos, seleccionar un formato exacto, crear un trabajo asíncrono y entregar el resultado firmado a tu usuario. La misma cadena de producción limitada alimenta el sitio web YTSave.

YTSaveClientJSON sobre HTTPSTraballos asíncronosCredenciales con alcance

Inicio rápido

YTSave maneja o host d'API identificando primero credenciales activadas por soporte. Sigue con un punto d'acceso asignato a inquilino y mantien en vista un camino de llamada solo de servidor.

URL del inquilinohttps://ytsave.app

AutenticaciónX-API-Key: ys_live_…

Perfil de clienteYTSaveClient

Versión APIv1

# Available only after support activation
export YTSAVE_API_KEY="issued-after-review"

curl -X POST https://ytsave.app/v1/resolve \
  -H "X-API-Key: $YTSAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/watch?v=VIDEO_ID"}'

Ta explicar a seguridat d'as Credenciales, YTSave separa l'almacenamiento secreto en o servidor d'a incrustación de paquetes en o cliente. Un registro d'evidencia no da logs públicos ni repositorios un lugar propio.

Resolver un enlace

YTSave maneja a operación de Resolver primer identificando detección de fuente. Sigue con formatos d'una URL presentada y no mantiene salidas inventadas en vista.

PUBLICAR/v1/resolveÁmbito: resolver

Campo	Tipo	Requerito	Descripción
`url`	URL HTTPS	Sí	Página de medios públicos u autorizaus ta analizar.
`tenant`	cadena	No	Dominio d'inquilino asignato. Normalment se omite.

{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

Ta esplicar o identificador de formato, YTSave separa o valor retornau sin cambiar d'a disponibilidad por enlace. Un registro d'evidencia no da a suya propia lugar ta una etiqueta de calidad suposada.

Crear y seguir un traballo de descarga

Ta la creación de Traballo, YTSave empieza con preparación asíncrona. O suyo rexistro d'evidencia empareja-lo con una petición HTTP corta y acaba con execución limitada de trallador.

PUBLICAR/v1/jobsÁmbito: emplegos

Campo	Tipo	Requerito	Descripción
`url`	URL HTTPS	Sí	Se envió la misma fuente normalizada para resolver.
`format_id`	cadena	Sí	Un ID exacto d'a respuesta de resolución.
`tenant`	cadena	No	Dominio d'inquilino asignato. Normalment se omite.

curl -X POST https://ytsave.app/v1/jobs \
  -H "X-API-Key: $YTSAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/watch?v=VIDEO_ID","format_id":"18"}'

1202 AceptauGuardar job_id.

2Estato de la encuestaGET /v1/jobs/{job_id} con a mesma clave.

3ListoAbrir l'URL de descarga firmada.

Estado	Significato	Acción de cliente
`queued`	Admitiu ta la cola limitada.	Votar de nuevo con retroceso.
`extracting`	Refrescando os metadatos u a ruta d'a fuente.	Continuar a consultar.
`processing`	Descargando, remuxeando u fusionando.	Amostrar o progreso d'o servidor.
`ready`	La descarga firmada está disponible.	Envia o URL o usuario.
`failed`	Error estructurau de terminal.	Leer `error_code`. Torna a intentar solo quan se aconseye.
`expired`	Se quitó o resultado temporal.	Crear un puesto nuevo.

curl https://ytsave.app/v1/jobs/JOB_ID \
  -H "X-API-Key: $YTSAVE_API_KEY"

YTSave fa que o sondeo de Traballos sea fácil de escanear. A página empieza con una espera inicial d'un segundo, pasa a un retroceso limitado, y indica claramente entrega temporal firmada.

Erros previsibles

Ta Error contract, YTSave revisa un sobre non 2xx antes d'una ID de solicitud de soporte. Iste registro de evidenzia tamién fa clara a maneya previsible d'o cliente.

{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "category": "rate_limited",
    "message": "Too many requests. Please try again shortly.",
    "retryable": true,
    "details": {"retry_after_seconds": 20}
  },
  "request_id": "…"
}

HTTP	Significato tipico	Acción
400	URL no válida, cuerpo u formato no disponible.	Corrixir a solicitud. Resolver de nueu ta formatos.
401	Clau faltosa, invalida, caducada u con alcán incorrecto.	Verificar a credencial d'o servidor.
403	La política d'inquilino u d'orixe rechazó a demanda.	No saltar a política. Contacta con o soporte.
404	Traba desconocida u caducada.	Crear un nuevo traballo si ye apropiato.
429	Limite de solicitud u traba activa alcanzato.	Honor `retry_after_seconds`.
503	Cola/capacidad u orixe temporalment indisponible.	Reintentar con retroceso exponencial y jitter.

Contrato operativo

YTSave emite una cuota operativa con cada aprobación ta protexer o consumidor de la API y os servicios de medios ascendents.

Utiliza lògica d'aplicación idempotente y nunca empieces traballos duplicaus ta o mesmo clic d'usuario.
Cache resolve metadatos brevemente, pero siempre trata las URLs de descarga firmadas como que caducan.
Usar retroceso exponencial limitado con jitter ta 429, 503 y errores que se pueden reintentar.
Procesar solo medios públicos u medios que yes autorizado a accedir.
Guarda os IDs de solicitud y os IDs de traballo en logs operativos privaus. No registres URLs presentadas innecesariament.

YTSave maneja l'acceso a Schema identificando primero a activación antes d'a exploración. Sigue con a autenticación asignada y mantiene en vista as formas de solicitud documentadas. Referencia OpenAPI

ACCESO REVISATO POR OPERADOR

Solicita o tuyo clave API

Documenta el consumidor de la API, su estimación mensual de solicitudes y los requisitos de plataforma soportados. YTSave revisa si resolver, enviar el trabajo o ambos están justificados antes de emitir una clave visible una vez.

Solicitar acceso API As claves son d'ámbito de inquilino, revocables y emitidas a traviés d'o formulario de contacto. Os scripts anónimos no pueden executar traballos de descargador.