https://api.nexscope.ai/alibaba1688/productDetailEjecutar 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/alibaba1688/productDetail |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
offerId | string | obligatorio | 1688 ID producto en formato entero positivo; las cadenas deben ser utilizadas para evitar la pérdida de precisión en grandes números; longitud máxima 1000 |
country | string | opcional | Campo de compatibilidad ascendente; normalmente se omite para esta habilidad Ejemplo: en |
currency | string | opcional | Código de moneda de tres letras, como `USD`, `HKD`; el servidor lo convertirá a mayúsculas; la longitud máxima es 3 |
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 (79 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
errcode | integer | opcional | Situación de las empresas de pasarela; `200` indica éxito |
errmsg | string | opcional | Mensaje de pasarela; el éxito es `ok` |
offerId | string | opcional | 1688 ID del producto |
subject | string | opcional | Título chino |
subjectTrans | string | opcional | Campo de cabecera de extensión hacia arriba, puede estar vacío o igual que `subject` |
description | string | opcional | Detalles del producto en chino, a menudo conteniendo HTML |
descriptionTrans | string | opcional | Campo de extensión hacia arriba, puede faltar |
categoryId | string | opcional | ID de categoría actual |
topCategoryId | string | opcional | ID de categoría de primer nivel |
secondCategoryId | string | opcional | ID de categoría secundaria |
thirdCategoryId | string | opcional | ID de categoría de tercer nivel |
categoryName | string | opcional | Categoría, puede estar faltando |
status | string | opcional | Estado del producto |
createDate | string | opcional | Tiempo de creación del producto |
productUrl | string | opcional | 1688 producto de promoción enlace |
sourceType | string | opcional | Fuente de datos, actualmente `1688` |
type | string | opcional | Estilo de resultado, actualmente `productDetail` |
costToken | integer | opcional | La llamada consume token; la respuesta actual exitosa es `1000` |
productImage | object | opcional | Imagen original: `images[]`, `whiteImage` |
productImageTrans | object | opcional | El campo de imagen extendido tiene la misma estructura que arriba y puede estar faltando. |
mainVideo | string | opcional | Dirección principal de vídeo |
detailVideo | string | opcional | Dirección de vídeo detallada |
productAttributes | array | opcional | Atributos del producto: `attributeId`, `attributeName`, `attributeNameTrans`, `value`, `valueTrans` |
sellingPoints | array | opcional | Punto de venta del producto, puede estar vacío |
skuList | array | opcional | SKU, especificaciones, inventario, precio y SKU fotos, ver la tabla de abajo para más detalles |
saleInfo | object | opcional | Inventario, precios por niveles, información sobre ventas por unidad y distribución, véase el cuadro siguiente |
shippingInfo | object | opcional | Por favor, consulte la tabla a continuación para obtener detalles sobre el lugar de envío, el tiempo de entrega y el producto/SKU peso de pieza. |
companyName | string | opcional | Nombre del proveedor/almacenamiento |
sellerOpenId | string | opcional | ID cifrado del comerciante |
sellerDataInfo | object | opcional | Servicios al vendedor e indicadores de transacción, por favor vea la tabla de abajo para más detalles |
sellerMixSetting | object | opcional | Ajustes mixtos por lotes: `generalHunpi`, `mixAmount`, `mixNumber` |
channelPrice | object | opcional | Canal SKU Precio: `skuPrices[].skuId/currentPrice` |
promotion | object | opcional | Información de comercialización: `hasPromotion`, `promotionType` |
minOrderQuantity | integer | opcional | Cantidad mínima |
batchNumber | integer | opcional | Un lote de cantidad |
productCargoNumber | string | opcional | Número del producto |
soldOut | string | opcional | Ventas de productos |
isJxhy | boolean | opcional | Si se debe seleccionar fuentes de suministro |
isSelect | boolean | opcional | Si debe ser transfronterizo Seleccionar paleta |
tradeScore | string | opcional | Calificación de las transacciones de productos |
offerIdentities | array | opcional | Identificación del producto o del comerciante |
tags | array | opcional | Etiquetas de servicio: `key`, `value` |
certificates | array | opcional | Certificado: `certificateName`, `certificateCode`, `certificatePhotoList[]` |
invoiceInfo | object | opcional | Factura: `supportOnlineInvoice`, `supportFastInvoice`, `invoiceTypes[]`, `taxpayerType` |
skuId | string | opcional | SKU ID |
specId | string | opcional | ID de especificación |
cargoNumber | string | opcional | SKU número del artículo |
amountOnSale | integer | opcional | Existencias |
price | string | opcional | SKU precio (RMB); en el nuevo modelo de precio minorista, es el precio mayorista cuando la cantidad de compra es mayor o igual a 2 piezas. La semántica del modelo de producto antiguo se combinan con la escalera y el orden de pre-previsual juicios. |
retailPrice | string | opcional | SKU precio al por menor (RMB), aplicable a la compra de la cantidad de 1 unidad; falta si la corriente no tiene un precio al por menor |
foreignCurrencyRetailPrice | number | opcional | SKU precio de venta al por menor en moneda extranjera, aplicable a la cantidad de compra 1 unidad; falta cuando no se solicita ninguna moneda, no se vende precio de venta o falla de conversión |
promotionPrice | string | opcional | precio de comercialización |
consignPrice | string | opcional | Precio de dropshipping; el campo de compatibilidad obsoleto puede faltar |
attributes | array | opcional | SKU atributo; contiene nombre, valor e imagen opcional |
fenxiaoPriceInfo | object | opcional | `offerPrice`、`onePiecePrice`、`foreignCurrencyPrice`、`foreignCurrencyPromotionPrice` |
amountOnSale | integer | opcional | Total inventario de mercancías |
retailPrice | string | opcional | Precio de venta al por menor a nivel de producto (RMB), aplicable a la cantidad de compra de 1 pieza; falta si la operación anterior no tiene un precio de venta al por menor |
foreignCurrencyRetailPrice | number | opcional | Precio de venta al por menor en moneda extranjera aplicable a la cantidad de compra 1 unidad; falta cuando no se solicita ninguna moneda, no se vende el precio o no se produce la conversión |
quoteType | integer | opcional | `0` no tiene SKU y se base en la cantidad del producto; `1` se basa en SKU especificaciones; `2` tiene SKU y se basa en la cantidad del producto |
priceRanges | array | opcional | Precios al por mayor por categorías: `startQuantity`, `price`, `promotionPrice`, `foreignCurrencyPrice`, `foreignCurrencyPromotionPrice` |
unitInfo | object | opcional | Unidad de campo `unit` y campo de extensión `transUnit` |
fenxiaoSaleInfo | object | opcional | `startQuantity`、`offerPrice`、`onePiecePrice`、`onePieceFreePostage` |
sendGoodsAddressText | string | opcional | Lugar de envío |
shippingTimeGuarantee | string | opcional | Garantía de entrega |
weight | number | opcional | Peso del producto, unidad kg |
officialWeight | number | opcional | Peso medido oficial en kg |
pkgSizeSource | string | opcional | Fuente de datos sobre el peso del producto |
skuShippingInfoList | array | opcional | SKU especificaciones logísticas; `weight` unidad es g, otras dimensiones son unidad cm |
skuShippingDetails | array | opcional | SKU peso en pieza; `weight`/`officialWeight`/`aiWeight` unidad kg, dimensiones unidad cm |
tradeMedalLevel | string | opcional | Medalla de Comercio al Vendedor |
compositeServiceScore | string | opcional | Puntos de servicio integrales |
logisticsExperienceScore | string | opcional | Puntos de experiencia logística |
disputeComplaintScore | string | opcional | Puntos de resolución de litigios |
offerExperienceScore | string | opcional | Puntos de experiencia en productos |
consultingExperienceScore | string | opcional | Puntos de consulta |
afterSalesExperienceScore | string | opcional | Puntos de retorno o de intercambio de experiencias |
repeatPurchasePercent | string | opcional | Tasa de devolución del vendedor |
collect30DayWithin48HPercent | string | opcional | Tasa de recogida en los últimos 30 días y 48 horas |
qualityRefundWithin30Day | string | opcional | Tipo de reembolso de calidad en los últimos 30 días |
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.