API de vídeosGuias
Atualizar filtro de tráfego
Direcione o tráfego indesejado — país errado, dispositivo errado, proxies — para um vídeo substituto.
O filtro de tráfego inspeciona cada espectador e, quando ele não atende às suas regras, serve o vídeo substituto no lugar do real. As regras se combinam: o espectador precisa passar por todas as listas configuradas para ver o vídeo principal.
Isto é um merge-patch: envie só as chaves que você quer alterar, e todo o resto mantém o valor salvo.
Só Brasil, bloqueando proxies
curl -X PATCH https://api.vturb.com/v1/videos/{id} \
-H "Authorization: Bearer vt_..." \
-H "Content-Type: application/json" \
-d '{ "traffic_filter": { "enabled": true, "countries": ["BR"], "block_proxy": true, "fallback_video_id": "66f2..." } }'As chaves
| Chave | Tipo | Define |
|---|---|---|
enabled | booleano | Interruptor geral do filtro |
fallback_video_id | string | Vídeo servido aos espectadores filtrados |
token | string | Token compartilhado que uma página pode apresentar para contornar o filtro |
languages | array de strings | Idiomas de navegador permitidos |
countries | array de strings | Países permitidos |
devices | array de strings | Classes de dispositivo permitidas |
query_params | array de strings | Parâmetros de query que a URL da página precisa ter |
block_proxy | booleano | Filtra o tráfego de proxy/VPN |
Arrays substituem a lista salva em vez de se mesclarem com ela: enviar
"countries": ["BR"] sobrescreve o que estava lá, então sempre envie a lista
completa que você quer.