Solo vista previa — activación requerida

Compile las descargas con QuickT

QuickT documenta cómo un cliente móvil se comunicaría con el servicio y no puede enviar trabajo de producción hasta que el soporte técnico apruebe el diseño y habilite el acceso con ámbito.

QuicktRouteJSON sobre HTTPSTrabajos asíncronosCredenciales con alcance

Inicio rápido

Para el host de API, QuickT comprueba las credenciales activadas por el soporte técnico antes de un punto final de inquilino asignado.

URL del inquilinohttps://quickt.io

AutenticaciónX-API-Key: pending_activation_…

Perfil del clienteQuicktRoute

Versión de APIv1

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

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

QuickT organiza la seguridad de credenciales en torno al almacenamiento secreto del lado del servidor. Su vista lista para dispositivos no compara la incrustación de paquetes de clientes.

Resolver un enlace

Para la operación de resolución, QuickT comprueba la detección de origen antes de los formatos de una URL enviada. Esta vista preparada para dispositivos también hace que no haya salidas inventadas claras.

POST/v1/resolveAlcance: resolver

sobre el terreno	Tipo de	Necesarios	Descripción de la actividad
`route_source`	URL HTTPS	Sí	Página de medios pública o autorizada a analizar.
`tenant`	cadena	No	Dominio de inquilino asignado. Por lo general, se omite.

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

QuickT organiza el identificador de formato en torno al valor devuelto sin cambios. Su vista preparada para dispositivos compara la disponibilidad por enlace.

Crear y seguir un trabajo de descarga

Para explicar la creación de trabajos, QuickT separa la preparación asíncrona de una solicitud HTTP corta. Una vista lista para dispositivos le da a la ejecución de trabajadores limitados su propio lugar.

POST/v1/jobsAlcance: empleos

sobre el terreno	Tipo de	Necesarios	Descripción de la actividad
`route_source`	URL HTTPS	Sí	La misma fuente normalizada sometida a resolver.
`route_format`	cadena	Sí	Un ID exacto de la respuesta de resolución.
`tenant`	cadena	No	Dominio de inquilino asignado. Por lo general, se omite.

curl -X POST https://quickt.io/v1/jobs \
  -H "X-API-Key: $QUICKT_ROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"route_source":"https://www.youtube.com/watch?v=VIDEO_ID","route_format":"18"}'

1202 AceptadasGuardar route_job.

2Estado de la encuestaGET /v1/jobs/{route_job} con la misma clave.

3ListoAbra la URL de descarga firmada.

Situación actual	Significado	Acción del cliente
`queued`	Admitido en la cola acotada.	Encuesta de nuevo con retroceso.
`extracting`	Actualización de metadatos de origen o ruta.	Continúa encuestando.
`processing`	Descargar, remuxar o fusionar.	Mostrar el progreso del servidor.
`ready`	Descarga firmada está disponible.	Envía la URL al usuario.
`failed`	Error estructurado de terminal.	Leer `error_code`Vuelva a intentarlo solo cuando se le indique.
`expired`	Se eliminó la salida temporal.	Crea un nuevo trabajo.

curl https://quickt.io/v1/jobs/ROUTE_JOB \
  -H "X-API-Key: $QUICKT_ROUTE_TOKEN"

La espera inicial de un segundo es el punto de partida para la sondeo de trabajos en QuickT. A continuación, una vista preparada para dispositivos presenta el backoff limitado y explica la entrega firmada temporal.

Errores predecibles

Para el contrato Error, QuickT comienza con un sobre no 2xx, su vista preparada para dispositivos lo empareja con un ID de solicitud de soporte y termina con un manejo predecible del 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	Significado típico	Medidas
400	URL, cuerpo o formato no disponible no válido.	Corrija la solicitud. Vuelva a resolver los formatos.
401	Falta clave, no válida, caducada o con alcance incorrecto.	Compruebe la credencial del lado del servidor.
403	La directiva de inquilino o de origen rechazó la solicitud.	No elude la política. Contacte con el soporte.
404	Trabajo desconocido o caducado.	Cree un nuevo trabajo si es apropiado.
429	Se alcanzó el límite de solicitudes o trabajos activos.	Honor `retry_after_seconds`.
503	Cola/capacidad o upstream temporalmente no disponible.	Vuelva a intentarlo con retroceso exponencial y fluctuación.

Contrato de explotación

QuickT elige los límites de cliente móvil durante la aprobación para que las redes de creadores y la API sigan respondiendo.

Utilice la lógica de aplicación idempotente y nunca inicie trabajos duplicados para el mismo clic del usuario.
La caché resuelve los metadatos brevemente, pero siempre trata las URL de descarga firmadas como si expiraran.
Usar retroceso exponencial acotado con jitter para 429, 503 y errores reintentables.
Procesa solo medios públicos o medios a los que estás autorizado a acceder, sin omitir los controles de acceso ni DRM.
Mantenga los ID de solicitud y los ID de trabajo en registros operativos privados. No registre las URL enviadas innecesariamente.

Para el acceso de esquema, QuickT comprueba la activación antes de la exploración antes de la autenticación asignada. Esta vista preparada para dispositivos también hace que las formas de solicitud documentadas sean claras.

ACCESO REVISADO POR EL OPERADOR

Activar a través de soporte

Describe la experiencia móvil, su expectativa de tráfico y las redes de creadores que necesita.QuickT utiliza esa información para asignar permisos de análisis y cola antes de revelar el secreto una vez.

Solicitar activación de cuenta Las claves están limitadas al ámbito del inquilino, son revocables y se emiten a través del formulario de contacto.