URL de medios de TikTok: dominios y prefijos de URL verificados
La API for Business de TikTok descarga los medios de las publicaciones desde URL: video_url, custom_thumbnail_url y photo_images. Cada URL debe estar en un dominio o prefijo de URL cuya propiedad la app de desarrollador haya verificado. Un dominio se verifica con un registro DNS TXT y un prefijo con un archivo de firma colocado bajo él, mediante /business/property/add/ y /business/property/verify/ con el ID de la app y su secret.
easyCoexistence sirve tus medios a TikTok desde su propio prefijo de URL verificado: publish_tiktok_post acepta un enlace HTTPS de Claude, ChatGPT o tu propio código y transmite el archivo desde él cuando TikTok lo descarga, así que tu dominio no necesita verificación.
Desde entonces, TikTok rechaza las URL de video que no estén en un dominio o prefijo de URL verificado.
Desde entonces, los endpoints de propiedades de URL también exigen el secret de la app de desarrollador.
Valores de property_type: 1 para un dominio, 2 para un prefijo de URL.
Valores de property_status: pending, verified y not verified, este último cuando el intento falló y hay que repetirlo.
Los desarrolladores que publicaron videos antes de esa fecha tienen los dominios de esas URL de video configurados como verificados automáticamente.
El tamaño máximo de imagen que acepta /business/comment/image/upload/, como datos de formulario multiparte, para un comentario o una respuesta.
¿Qué URL descarga TikTok?
Cada campo de medios de los dos endpoints de publicación es una URL que TikTok obtiene por sí mismo tras aceptar la llamada, así que el archivo debe seguir accesible hasta que termine la descarga:
video_url: el video, que TikTok recomienda mantener válido al menos 30 minutos.custom_thumbnail_url: una imagen que se usa como portada del video.photo_images: hasta 35 imágenes para una publicación de fotos.- Tiempo de espera: TikTok da una hora a la descarga y, después, la publicación falla con
video_pull_failedophoto_pull_failed.
¿Cuál es la diferencia entre un dominio y un prefijo de URL?
Lo que demuestras que posees y, por tanto, qué URL cuentan como verificadas. Un dominio sirve para medios en un host que posees o controlas; un prefijo sirve para una carpeta en un host donde solo puedes subir archivos. Estas son las reglas de TikTok para cada tipo de propiedad:
| Domain | URL prefix | |
|---|---|---|
| What it is | A site you own, such as example.com or a subdomain | https:// plus a host, a path and a final /, such as https://www.example.com/videos/ |
| Proof | A DNS TXT record holding the signature | A file named file_name, holding the signature, uploaded under the prefix |
| Covers | URLs on the domain and its subdomains | URLs that begin with the prefix |
| Leaves out | The parent: verifying video.example.com leaves example.com unverified | Sibling paths: /folder/user/ leaves /folder/public/ unverified |
| Redirects | Not applicable | Not followed; a prefix answering 3xx is invalid |
¿Cómo se verifica una propiedad?
Mediante dos llamadas que se autentican con el app_id y el secret de la app de desarrollador en lugar de un token de cuenta, con la prueba colocada entre ambas:
- Alta: POST /business/property/add/ con
url_property_meta, que contieneproperty_typey url; la respuesta devuelve signature, además defile_namepara un prefijo, conproperty_status0. - Demostración: coloca la firma en un registro DNS TXT para un dominio, o en un archivo público llamado
file_name, con una única extensión .txt, bajo un prefijo. - Verificación: POST /business/property/verify/ con el mismo
url_property_meta;property_status1 significa verificada y 2 significa que el intento falló.
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/property/add/' \
-H 'Content-Type: application/json' \
-d '{
"app_id": "<APP_ID>",
"secret": "<APP_SECRET>",
"url_property_meta": { "property_type": 2, "url": "https://media.example.com/tiktok/" }
}'
# data.url_property_info: url, property_type, property_status (0), signature, file_name¿Cómo se listan o eliminan propiedades?
GET /business/property/list/ con app_id y secret devuelve url_property_info_list, con cada entrada que incluye property_type, url, property_status, signature y file_name. Los subdominios de un dominio verificado cuentan como verificados sin una llamada propia, pero aparecen en el listado solo si se añadieron. POST /business/property/delete/ con app_id, secret y url_property_meta elimina una propiedad que la app ya no posee ni controla.
¿Puedes subir un archivo en lugar de una URL?
No para publicaciones. La Accounts API publica solo desde URL, incluidos los borradores, y su único endpoint de carga, /business/comment/image/upload/, recibe una imagen de comentario como datos de formulario multiparte, en JPG, JPEG, WebP o PNG de hasta 5 MB, y devuelve un image_uri para un comentario o una respuesta. La carga de archivos por fragmentos corresponde a la Content Posting API en developers.tiktok.com, una API distinta con sus propias apps, donde el método de transferencia se llama FILE_UPLOAD.
¿Qué pasa con una URL que no está verificada?
TikTok se niega a publicar desde ella. La referencia de la API for Business establece la regla para videos y fotos, pero no define un código de respuesta propio para este caso, así que lee el código y el mensaje de la respuesta. La Content Posting API en developers.tiktok.com llama al mismo caso url_ownership_unverified, con HTTP 403. Para probar el endpoint de video antes de verificar ninguna propiedad, TikTok publica una URL de video de prueba que no necesita verificación:
https://sf16-va.tiktokcdn.com/obj/eden-va2/uvpapzpbxjH-aulauvJ-WV[[/ljhwZthlaukjlkulzlp/3min.mp4¿Cómo easyCoexistence lleva tus medios a TikTok?
A través de un prefijo de URL verificado propio, https://easycoexistence.com/api/social/media/. publish_tiktok_post acepta tu enlace HTTPS, rechaza http:// antes de enviar nada y entrega a TikTok un enlace bajo ese prefijo, con un token firmado que identifica tu archivo, caduca a las 6 horas y conserva la extensión del archivo. Cuando TikTok lo obtiene, easyCoexistence verifica el token, confirma que tu enlace usa HTTPS en una dirección pública y transmite el archivo directamente desde tu enlace, incluidas las peticiones de rango y las redirecciones, sin almacenarlo. Si tu enlace falla, TikTok no puede descargar el archivo y la publicación falla.
Your link: https://cdn.example.com/videos/launch.mp4
Sent to TikTok: https://easycoexistence.com/api/social/media/<SIGNED_TOKEN>.mp4Errores comunes
- Verificar un subdominio y alojar los archivos en su dominio padre. Un video.example.com verificado cubre sus propios subdominios, no example.com en sí.
- Servir el archivo de firma del prefijo mediante una redirección. TikTok no sigue redirecciones para un prefijo de URL y trata una respuesta 3xx como inválida.
- Guardar el archivo de firma como name.txt.txt. TikTok espera que el nombre coincida con file_name, con una única extensión .txt.
- Borrar el archivo justo después de la llamada de publicación. TikTok lo descarga después, durante hasta una hora, y la publicación falla si el enlace deja de funcionar.
De US$ 9 a US$ 0.75 por conexión al mes, bajando a medida que añades conexiones, con los primeros 3 días gratis.
Preguntas frecuentes
¿Por qué TikTok exige URL de medios verificadas?
TikTok dice que verificar la propiedad de las URL de video le ayuda a cumplir sus políticas sobre contenido protegido por derechos de autor y seguridad de los usuarios.
¿Un dominio de TikTok verificado cubre sus subdominios?
Sí. Los subdominios de un dominio verificado cuentan como verificados, aunque /business/property/list/ solo los muestra si se añadieron.
¿La API for Business de TikTok puede publicar desde un enlace de S3 o CDN?
Sí, cuando el enlace está bajo un dominio o prefijo de URL que la app ha verificado, como un prefijo en un bucket o una ruta de CDN que controlas.
¿Las publicaciones de fotos también necesitan URL verificadas?
Sí. El endpoint de fotos de TikTok establece que las publicaciones de fotos no pueden publicarse desde URL de fotos no verificadas.
Sigue leyendo
Conecta tu primer canal en dos minutos.
Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.
- 3 días gratis
- Cancela cuando quieras
- Solo APIs oficiales
- Monitorizado 24/7
Verificado el