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

Compilar downloads com Insto

Insto apresenta um modelo de integração de mídia visual para avaliação. Análise ao vivo e solicitações de trabalho permanecem indisponíveis até que o suporte conceda autorização com escopo de locatário.

InstoMediaJSON sobre HTTPSTrabalhos assíncronosCredenciais com escopo

Início rápido

Para o host da API, Insto começa com credenciais ativadas por suporte. Sua revisão de download combina isso com um endpoint de locatário atribuído e termina com um caminho de chamada apenas para servidor.

URL do locatáriohttps://insto.app

AutenticaçãoX-API-Key: pending_activation_…

Perfil do clienteInstoMedia

Versão da APIv1

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

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

Insto apresenta três pontos práticos para a segurança das credenciais. Primeiro vem o armazenamento secreto no lado do servidor. A revisão do download cobre então a ausência de incorporação de pacotes no cliente. Seu ponto final é a ausência de logs ou repositórios públicos.

Resolver um link

Para a operação Resolver, Insto começa com a detecção da fonte. Sua revisão de download combina isso com formatos de uma URL submetida e termina sem saídas inventadas.

POST/v1/resolveEscopo: resolver

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

Insto apresenta três pontos práticos para o identificador de formato. Primeiro vem o valor retornado sem alterações. A revisão do download cobre então a disponibilidade por link. Seu ponto final é a ausência de rótulo de qualidade estimada.

Criar e acompanhar um trabalho de download

Insto organiza a criação de Tarefas em torno da preparação assíncrona. Sua revisão de download compara uma solicitação HTTP curta. A execução limitada do trabalhador permanece a verificação final.

POST/v1/jobsÂmbito: empregos

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

1202 AceitoSalvar prepare_id.

2Status da enqueteGET /v1/jobs/{prepare_id} 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://insto.app/v1/jobs/PREPARE_ID \
  -H "X-API-Key: $INSTO_MEDIA_TOKEN"

Em Insto, uma espera inicial de um segundo ocorre primeiro ao explicar a sondagem de trabalho. Essa revisão de download segue com retrocesso limitado e encerra na entrega temporária assinada.

Erros previsíveis

Para explicar o contrato de Erro, Insto separa um envelope não 2xx de um ID de solicitação de suporte. Uma revisão de download oferece um manuseio previsível ao cliente em seu próprio lugar.

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

Insto ajusta os limites de chamadas ao caso de uso de mídia visual e às redes que o cliente aprovado irá contatar.

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 Schema, Insto começa com ativação antes da exploração. Sua revisão de download combina isso com autenticação atribuída e termina com formatos de solicitação documentados.

ACESSO REVISADO PELO OPERADOR

Ativar através do suporte

Descreva o produto de mídia visual, o uso mensal previsto e os tipos de postagem que você planeja gerenciar. Insto concede apenas os escopos necessários de análise ou preparação e nunca armazena o token legível.

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.