https://api.nexscope.ai/tiktok/shop/product/detailEjecutar esta API
Envía una solicitud JSON para ejecutar esta API y recibir los datos de respuesta documentados.
Endpoint
| Método | POST |
| Ruta | https://api.nexscope.ai/tiktok/shop/product/detail |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
productInput | string | obligatorio | TikTok HTTPS producto URL (el anfitrión debe ser `tiktok.com` o su subdominio, el puerto debe ser omitido o `443`, la ruta debe contener consecutiva `product/<19-digit ID>`), o ID del producto de 19 dígitos. ID del producto debe ser pasado como una cadena para evitar la pérdida de precisión numérica. |
region | string | opcional | Códigos de los sitios de la maleta: `US`, `GB`, `ID`, `MY`, `TH`, `VN`. `PH`, `SG`, `DE`, `FR`, `IT`, `ES`. Ejemplo: US |
Respuesta de ejemplo
Estructura de respuesta de la plataforma. code 0 indica éxito o aceptación; data contiene el resultado de negocio.
No hay un ejemplo de respuesta publicado para esta API. Consulta los campos de respuesta siguientes.
Campos de respuesta
Referencia de campos de respuesta (20 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
errcode | integer | opcional | Código de la situación empresarial; `200` indica éxito. |
errmsg | string | opcional | Mensaje sobre el estado de las empresas; `ok` sobre el éxito. |
data | array | opcional | Array de producto arreglado; 1 elemento se fija cuando tiene éxito. |
total | integer | opcional | Fijo a `1` sobre el éxito. |
costToken | integer | opcional | Consumir token. |
type | string | opcional | Fijo a `tableListWorkbenches`. |
columns | array | opcional | Definiciones de columnas generadas en base a los campos de nivel superior del producto. |
productId | string | opcional | Identificación del producto. |
status | integer | opcional | Código de estado del producto de plataforma; no puede utilizarse solo para determinar la capacidad de venta. |
title | string | opcional | Título del producto. |
category | object | opcional | Nombre de la categoría e identificación. |
pricing | object | opcional | Moneda, precio de venta, precio original, descuento y precio campos originales. |
sales | object | opcional | Exponga la cantidad vendida y los campos de venta. |
inventory | object | opcional | Total inventario, SKU, atributos de venta, SKU precios y selecciones predeterminadas. |
media | object | opcional | Imagen URL y metadatos de imagen. |
seller | object | opcional | Identificador de tienda, nombre, calificación, región y campos de tienda disponibles. |
reviews | object | opcional | Perfil público de comentarios, puede estar vacío. |
shipping | object | opcional | Módulo de logística y distribución, puede estar vacío. |
actions | object | opcional | Estado de la adición, la compra y la colección. |
additional | object | opcional | Las promociones, los beneficios de los usuarios y otros módulos de productos legibles por el ser humano pueden ser grandes. |
Respuestas
| Código | Descripción |
|---|---|
| 200 | Respuesta HTTP predeterminada tanto para el éxito como para muchos errores de negocio. Solo el código JSON externo 0 indica éxito o aceptación asíncrona; consulta data para obtener el resultado. |
| 429 | Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente. |
| 503 | La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente. |
| Opcional | X-Nexscope-Http-Status: semantic asigna estados HTTP a los errores de negocio gestionados por el controlador en las rutas de ejecución y tareas. Los fallos previos a la autenticación, como la ausencia de una clave API (code 11209), pueden seguir devolviendo HTTP 200 antes de esta asignación. Comprueba siempre el código JSON externo; las solicitudes malformadas y los fallos de infraestructura también pueden devolver respuestas HTTP distintas de 200. |
Fuente de datos, vigencia y limitaciones
La fuente, la vigencia, la cobertura, los límites de frecuencia y las notas de estimación no se especifican en esta definición de API salvo que aparezcan en la documentación de campos de solicitud o respuesta anterior. No supongas datos oficiales del mercado ni actualización en tiempo real cuando no estén documentados explícitamente.