Apenas visualização — ativação necessária

Compilar downloads com QuickT

QuickT documenta como um cliente móvel se comunicaria com o serviço. Ele não pode enviar trabalho de produção até que o suporte aprove o design e habilite o acesso restrito.

QuicktRouteJSON sobre HTTPSTrabalhos assíncronosCredenciais com escopo

Início rápido

Para o host da API, QuickT verifica credenciais ativadas por suporte antes de um endpoint de locatário atribuído. Esta visualização pronta para dispositivo também torna claro um caminho de chamada apenas para servidor.

URL do locatáriohttps://quickt.io

AutenticaçãoX-API-Key: pending_activation_…

Perfil do clienteQuicktRoute

Versão da 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 a segurança das credenciais em torno do armazenamento secreto do lado do servidor. Sua visualização pronta para dispositivos não compara nenhuma incorporação de pacote do cliente. Nenhum registro público ou repositório permanece como a verificação final.

Resolver um link

Para a operação Resolve, QuickT verifica a detecção da fonte antes dos formatos de uma URL enviada. Esta visualização pronta para dispositivo também deixa claros os resultados não inventados.

POST/v1/resolveEscopo: resolver

Campo	Tipo	Necessário	Descrição
`route_source`	URL HTTPS	Sim	Página de mídia pública ou autorizada para analisar.
`tenant`	string	Não.	Domínio do locatário atribuído. Geralmente omitido.

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

QuickT organiza o identificador de formato em torno do valor retornado sem alterações. Sua visualização pronta para o dispositivo compara a disponibilidade por link. Nenhum rótulo de qualidade estimada permanece como a verificação final.

Criar e acompanhar um trabalho de download

Para explicar a criação de Jobs, QuickT separa a preparação assíncrona de uma requisição HTTP curta. Uma visualização pronta para dispositivo dá à execução do trabalhador limitado seu próprio espaço.

POST/v1/jobsÂmbito: empregos

Campo	Tipo	Necessário	Descrição
`route_source`	URL HTTPS	Sim	A mesma fonte normalizada foi submetida para resolver.
`route_format`	string	Sim	Um ID exato da resposta de resolução.
`tenant`	string	Não.	Domínio do locatário atribuído. Geralmente omitido.

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 AceitoSalvar route_job.

2Status da enqueteGET /v1/jobs/{route_job} com a mesma chave.

3Pronto.Abrir a URL de download assinada.

Estado	Significado	Ação do cliente
`queued`	Admitido na fila limitada.	Sondagem novamente com recuo.
`extracting`	Atualizando metadados da fonte ou rota.	Continue a pesquisar.
`processing`	Baixando, remuxing ou mesclando.	Exibir o progresso do servidor.
`ready`	Download assinado disponível.	Envie a URL para o usuário.
`failed`	Erro estruturado do terminal.	Leia `error_code`. Repita somente quando aconselhado.
`expired`	Saída temporária foi removida.	Crie um novo trabalho.

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

A espera inicial de um segundo é o ponto de partida para a sondagem de Job em QuickT. Uma visualização pronta para o dispositivo então apresenta recuo limitado e explica a entrega temporariamente assinada.

Erros previsíveis

Para o contrato de Erro, QuickT começa com um envelope não 2xx. Sua visualização pronta para o dispositivo associa isso a um ID de solicitação de suporte e termina com um tratamento previsível pelo 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	Acção
400	URL inválido, corpo ou formato indisponível.	Corrija a solicitação. Resolva novamente para formatos.
401	Chave ausente, inválida, expirada ou com escopo errado.	Verifique a credencial do lado do servidor.
403	O inquilino ou a política de origem rejeitou a solicitação.	Não ignore a política. Entre em contato com o suporte.
404	Trabalho desconhecido ou expirado.	Crie um novo trabalho, se apropriado.
429	Limite de solicitações ou trabalhos ativos atingido.	Honra. `retry_after_seconds`.
503	Fila/capacidade ou upstream temporariamente indisponível.	Tentar novamente com recuo exponencial e jitter.

Contrato operacional

O QuickT escolhe limites de cliente móvel durante a aprovação para que as redes de criadores e a API permaneçam responsivas.

Use lógica de aplicação idempotente e nunca inicie trabalhos duplicados para o mesmo clique do usuário.
Armazene em cache os metadados de resolução brevemente, mas sempre trate URLs de download assinados como expirados.
Use recuo exponencial limitado com jitter para 429, 503 e erros retráteis.
Processe apenas mídia pública ou mídia à qual você está autorizado a acessar. DRM e controles de acesso não são contornados.
Mantenha IDs de solicitação e IDs de tarefa em logs operacionais privados. Não registre URLs enviadas desnecessariamente.

Para acesso ao Esquema, QuickT verifica a ativação antes da exploração e antes da autenticação atribuída. Esta visualização pronta para o dispositivo também torna claras as formas de solicitação documentadas.

ACESSO REVISADO PELO OPERADOR

Ativar através do suporte

Descreva a experiência móvel, sua expectativa de tráfego e as redes de criadores que ela necessita. QuickT usa essa informação para atribuir análise e permissões de fila antes de revelar o segredo uma vez.

Solicitar ativação As chaves são limitadas ao locatário, revogáveis e emitidas através do formulário de contato. Scripts anônimos não podem executar trabalhos de download.