API de vídeosGuías
Actualizar filtro de tráfico
Desvía el tráfico no deseado — país equivocado, dispositivo equivocado, proxies — a un vídeo de respaldo.
El filtro de tráfico analiza a cada espectador y, cuando no cumple tus reglas, le muestra el vídeo de respaldo en lugar del real. Las reglas se combinan: un espectador debe pasar todas las listas configuradas para ver el vídeo principal.
Esto es un merge-patch: envía solo las claves que quieres cambiar y todo lo demás conserva su valor guardado.
Solo Brasil, bloquear 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..." } }'Las claves
| Clave | Tipo | Define |
|---|---|---|
enabled | booleano | Interruptor general del filtro |
fallback_video_id | string | Vídeo que se muestra a los espectadores filtrados |
token | string | Token compartido que una página puede presentar para saltarse el filtro |
languages | array de strings | Idiomas del navegador permitidos |
countries | array de strings | Países permitidos |
devices | array de strings | Clases de dispositivo permitidas |
query_params | array de strings | Parámetros de consulta que debe llevar la URL de la página |
block_proxy | booleano | Filtra el tráfico de proxy/VPN |
Los arrays reemplazan la lista guardada en lugar de combinarse con ella: enviar
"countries": ["BR"] sobrescribe lo que hubiera, así que envía siempre la lista
completa que quieres.