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

Compilar downloads com Social Video Saver

As credenciais de produção permanecem desativadas até que o caso de uso proposto seja aprovado em uma revisão de suporte.

SocialSaverWorkspaceJSON sobre HTTPSTrabalhos assíncronosCredenciais com escopo

Início rápido

Uma exibição de várias fontes apresenta, em seguida, um ponto de extremidade de locatário atribuído e explica um caminho de chamada somente para o servidor.

URL do locatáriohttps://socialvideosaver.com

AutenticaçãoX-API-Key: pending_activation_…

Perfil do clienteSocialSaverWorkspace

Versão da APIv1

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

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

Ele não mostra nenhum pacote de cliente incorporando o próximo e não obscurece nenhum log público ou repositório.

Resolver um link

A detecção de fonte é o ponto de partida para a operação Resolve no SocialVideoSaver. Uma visualização de várias fontes apresenta então formatos de um URL enviado e explica nenhuma saída inventada.

POST/v1/resolveEscopo: resolver

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

Ele mostra a disponibilidade por link ao lado e não obscurece nenhum rótulo de qualidade adivinhado. Ele mostra a disponibilidade por link ao lado e não obscurece nenhum rótulo de qualidade adivinhado.

Criar e acompanhar um trabalho de download

O SocialVideoSaver aborda a criação de trabalhos por meio de uma preparação assíncrona, depois de uma solicitação HTTP curta.

POST/v1/jobsÂmbito: empregos

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

1202 AceitoSalvar delivery_job.

2Status da enqueteGET /v1/jobs/{delivery_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://socialvideosaver.com/v1/jobs/DELIVERY_JOB \
  -H "X-API-Key: $SVS_WORKSPACE_KEY"

Sua visualização de várias fontes compara o backoff limitado. A entrega assinada temporária continua sendo a verificação final.

Erros previsíveis

No SocialVideoSaver, um envelope não 2xx vem primeiro ao explicar o contrato de erro. Essa exibição de várias fontes segue com um ID de solicitação de suporte e fecha no manuseio previsível do 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 SocialVideoSaver analisa a demanda projetada entre redes antes de atribuir limites à integração aprovada.

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.

A ativação antes da exploração é o ponto de partida para o acesso ao esquema no SocialVideoSaver.

ACESSO REVISADO PELO OPERADOR

Ativar através do suporte

Resuma o produto entre redes, a demanda mensal projetada e todos os provedores sociais no escopo. O SocialVideoSaver ativa apenas as capacidades de análise ou trabalho solicitadas e armazena um hash em vez do token.

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.