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

Construir downloads com QuickDL

QuickDL permite que desenvolvedores inspecionem o modelo compacto de solicitação antes da ativação. O suporte deve validar o produto antes que uma chave privada e cota se tornem utilizáveis.

QuickDlJobsJSON sobre HTTPSTrabalhos assíncronosCredenciais com escopo

Início rápido

Em QuickDL, credenciais ativadas por suporte vêm primeiro ao explicar o host da API. Essa utilidade compacta segue com um endpoint de locatário atribuído e termina em um caminho de chamada apenas para servidor.

URL do locatáriohttps://quickdl.app

AutenticaçãoX-API-Key: pending_activation_…

Perfil do clienteQuickDlJobs

Versão da APIv1

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

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

O QuickDL lida com a segurança de credenciais identificando primeiro o armazenamento secreto do lado do servidor. Em seguida, não incorpora nenhum pacote no cliente e não mantém logs públicos ou repositórios visíveis.

Resolver um link

No QuickDL, a detecção de fonte vem primeiro ao explicar a operação Resolve. Essa utilidade compacta segue com formatos de uma URL submetida e encerra sem saídas inventadas.

POST/v1/resolveEscopo: resolver

Campo	Tipo	Necessário	Descrição
`public_link`	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
}

QuickDL lida com o identificador de Formato identificando primeiro o valor retornado sem alterações. Segue com disponibilidade por link e não mantém nenhum rótulo de qualidade estimada visível.

Criar e acompanhar um trabalho de download

A utilidade compacta do QuickDL revisa a preparação assíncrona para a criação de Job. Ela mostra uma breve requisição HTTP a seguir e não obscurece a execução do trabalhador vinculado.

POST/v1/jobsÂmbito: empregos

Campo	Tipo	Necessário	Descrição
`public_link`	URL HTTPS	Sim	A mesma fonte normalizada foi submetida para resolver.
`download_option`	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://quickdl.app/v1/jobs \
  -H "X-API-Key: $QUICKDL_JOB_KEY" \
  -H "Content-Type: application/json" \
  -d '{"public_link":"https://www.youtube.com/watch?v=VIDEO_ID","download_option":"18"}'

1202 AceitoSalvar quick_job.

2Status da enqueteGET /v1/jobs/{quick_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://quickdl.app/v1/jobs/QUICK_JOB \
  -H "X-API-Key: $QUICKDL_JOB_KEY"

QuickDL apresenta três pontos práticos para pesquisa de emprego. Primeiro vem uma espera inicial de um segundo. A utilidade compacta então cobre o recuo limitado. Seu ponto final é a entrega temporária assinada.

Erros previsíveis

QuickDL aborda o contrato de erro através de um envelope não 2xx, depois um ID de solicitação de suporte. A utilidade compacta mantém o manuseio previsível do cliente explícito.

{
  "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

QuickDL concede uma cota compacta e específica para o cliente que suporta a integração sem desestabilizar os serviços de origem.

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.

Em QuickDL, ativação antes da exploração vem primeiro ao explicar o acesso ao Esquema. Essa utilidade compacta segue com autenticação atribuída e termina em formatos de solicitação documentados.

ACESSO REVISADO PELO OPERADOR

Ativar através do suporte

Forneça ao QuickDL o nome da integração, o volume mensal esperado e as fontes necessárias. Identifique as operações que o servidor realizará para que a aprovação produza uma chave única e de escopo restrito.

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.