En el mercado de intercambios de segunda mano, la plataforma Xianyu de Alibaba Group se ha destacado por su ambiente comunitario y su modelo de transacciones, atrayendo una gran cantidad de usuarios. Para mejorar aún más la experiencia del usuario y aumentar la transparencia de las transacciones, se han lanzado varias interfaces de programación de aplicaciones (API), entre ellas la API de detalles de productos.
Resumen de la API de Detalles de Productos de Xianyu
La API de detalles de productos de Xianyu permite a los usuarios y desarrolladores obtener información detallada sobre un producto, incluyendo descripción, imágenes, precio y estado de la transacción. Este servicio mejora la comprensión del usuario sobre el producto, facilitando decisiones más informadas durante el proceso de compra.
Características Principales
- Exhibición completa de información: proporciona detalles completos del producto, incluyendo texto e imágenes, precios y condicioens de transacción.
- Actualización en tiempo real: asegura que la información del producto sea siempre la más reciente, reflejando el estado actual de la transacción.
- Mejora de la confianza: mostrar detalles transparentes ayuda a establecer una mayor confianza entre compradores y vendedores.
Funciones y Usos de la API
Las principales funciones de la API de detalles de productos incluyen:
- Obtener información básica del producto: como título, precio, ubicación y volumen de ventas.
- Recuperar datos descriptivos: incluyendo detalles adicionales y características únicas del producto.
- Acceder a imágenes del producto: como fotos principales y secundarias.
- Consultar clasificaciones del producto: categorías y subcategorías asociadas al artículo.
Los usos principales de esta API son:
- Proporcionar datos detallados del producto para mejorar la experiencia del usuario en aplicaciones de terceros.
- Desarrollar sistemas basados en recomendaciones o comparaciones de precios.
- Ayudar a los comerciantes a analizar mejor sus inventarios y optimizar estrategias de marketing.
- Ofrecer una mayor variedad de información sobre los productos para facilitar la finalización de transaccoines.
Parámetros y Valores de Retorno
Los parámetros requeridos para realizar consultas incluyen el ID del producto y cadenas de cifrado necesarias. El ID del producto es obligatorio y sirve para identificar específicamente el artículo deseado.
Los valores devueltos contienen:
codigo: código de estado que indica si la solicitud fue exitosa.
mensaje: mensaje de respuesta que describe el resultado de la solicitud.
datos: conjunto de datos devueltos con detalles del producto o mensajes de error.
Ejemplo de Llamada a la API
A continuación se muestra un ejemplo de cómo utilizar Python para interactuar con la API:
# coding:utf-8
"""
Compatibilidad con Python 2.x y Python 3.x
Requisito: pip install requests
"""
from __future__ import print_function
import requests
# URL de solicitud con parámetros codificados por defecto
url = "https://api-gw.onebound.cn/goodfish/item_get/?key=<su_apiKey>&secret=<su_apiSecret>&num_iid=750828541223"
headers = {
"Accept-Encoding": "gzip",
"Connection": "close"
}
if __name__ == "__main__":
response = requests.get(url, headers=headers)
data = response.json()
print(data)
Ejemplo de Respuesta
{
"producto": {
"categoria_id": "50025441",
"fecha_creacion": "2023-11-23 18:11:14",
"descripcion": "Libro usado legítimo\n\n[Proceso de compra]: Haga clic en 'Quiero comprar' → Comprar ahora\n------------------\n[Estado del libro]: Señalado en el título!! Libro usado o nuevo. [Condición del libro usado]: [Legítimo] Entre 8 y 9 de nueva condición, puede tener anotaciones y no incluye accesorios adicionales, como CD. Los libros de ficción literaria generalmente no tienen sobrecubiertas ni cintas promocionales. Las páginas internas pueden amarillear debido a su antigüedad, pero no afectan la lectura. Con inventario abundante, se enviará el mejor disponible. Si necesita uno sin anotaciones o completamente nuevo, comuníquese con atención al cliente (con costo adicional).\n------------------\n[Venta de otros libros]: Debido a limitaciones, muchos libros no están listados. Pregunte a soporte para más opciones.\n[Tiempos de envío]: Envío normal el mismo día, máximo dentro de 48 horas.\n[Insatisfacción]: Criterios de calidad pueden variar; contacte a soporte para soluciones adecuadas. (Evaluaciones negativas automáticas no serán atendidas)\n------------------\n☆ Vendedor confiable, garantía de calidad, reembolso por daños.\n☆ Me gusta y sigue para envío prioritario!\n☆ No se aceptan devoluciones sin razón o rechazos, cubriendo costos de envío y retorno.\n☆ ¡Feliz compra~!\n[Purpose del libro usado]: Ahorra papel, reduce emisiones de carbono; reutiliza recursos; fomenta el aprecio por los libros.\n[Título del libro] Entiende Profundamente Sistemas de Computadoras (Edición Original Tercera)",
"imagenes_descripcion": [],
"enlace_detalle": "https://market.m.taobao.com/app/idleFish-F2e/fish-pc/web/detail.html?id=750828541223",
"costo_envio": "0.00",
"imagenes_producto": [
{
"ruta": "http://img.alicdn.com/bao/uploaded/i2/O1CN01K60ZCj1uz3gvjDGlS_!!0-fleamarket.jpg"
},
{
"ruta": "http://img.alicdn.com/bao/uploaded/i2/O1CN01WOptWa1uz3gwkdnqs_!!0-fleamarket.jpg"
}
],
"ubicacion": "Dongguan",
"vendedor_nick": "Monasterio Wu Kong",
"cantidad_disponible": "1976",
"identificador_producto": "750828541223",
"precio_original": "5.91",
"imagen_principal": "http://img.alicdn.com/bao/uploaded/i2/O1CN01K60ZCj1uz3gvjDGlS_!!0-fleamarket.jpg",
"costo_envio_postal": "0.00",
"precio_actual": "5.91",
"precio_promocional": "5.91",
"propiedades_imagenes": {
"propiedad_imagen": []
},
"alias_propiedades": "-1:-1:Python Programación desde Cero;-1:-2:Java Pensamiento Orientado a Objetos (4ª Edición);-1:-3:Código Completo (2ª Edición);-1:-4:Introducción a Algoritmos (Tercera Edición);-1:-5:C++ Primer (5ª Edición en Chino);-1:-6:Entiende Profundamente Sistemas de Computadoras (Edición Original Tercera);-1:-7:C Primer Plus Sexta Edición en Chino;-1:-8:Aprende Java en 21 Días (5ª Edición);-1:-9:C++ Primer Plus Sexta Edición en Chino;-1:-10:Primera Línea de Código Android (2ª Edición);-1:-11:Grandes Estructuras de Datos;-1:-12:Aprendizaje Profundo;-1:-13:Estructuras de Datos (Versión en C);-1:-14:Diseño Avanzado de JavaScript (3ª Edición);-1:-15:Lenguaje de Programación C (Segunda Edición);-1:-16:Redes de Computadoras (6ª Edición);-1:-17:C Primer Plus Quinta Edición en Chino;-1:-18:Análisis del Código Fuente de STL;-1:-19:Effective C++ (Tercera Edición);-1:-20:Más libros técnicos disponibles bajo consulta",
"propiedades": [],
"imagenes_propiedades": [],
"listado_propiedades": {
"-1:-1": "Título: Python Programación desde Cero",
"-1:-2": "Título: Java Pensamiento Orientado a Objetos (4ª Edición)",
"-1:-3": "Título: Código Completo (2ª Edición)",
"-1:-4": "Título: Introducción a Algoritmos (Tercera Edición)",
"-1:-5": "Título: C++ Primer (5ª Edición en Chino)",
"-1:-6": "Título: Entiende Profundamente Sistemas de Computadoras (Edición Original Tercera)"
},
"nombre_categoria": "-1:-1:Título: Python Programación desde Cero;-1:-2:Título: Java Pensamiento Orientado a Objetos (4ª Edición);-1:-3:Título: Código Completo (2ª Edición);-1:-4:Título: Introducción a Algoritmos (Tercera Edición);-1:-5:Título: C++ Primer (5ª Edición en Chino);-1:-6:Título: Entiende Profundamente Sistemas de Computadoras (Edición Original Tercera)",
"categoria_raiz_id": "50050324",
"identificador_vendedor": "2216791486107",
"informacion_vendedor": {
"ciudad": "Dongguan",
"nivel": "B",
"nick": "Monasterio Wu Kong",
"calificacion": 100,
"notas": ""
},
"variantes": {
"variante": [
{
"precio_original": 23.61,
"precio_actual": 23.61,
"caracteristicas": "-1:-1",
"nombre_caracteristicas": "-1:-1:Título: Python Programación desde Cero",
"existencias": "98",
"id_variante": "5349677003242"
},
{
"precio_original": 17.61,
"precio_actual": 17.61,
"caracteristicas": "-1:-2",
"nombre_caracteristicas": "-1:-2:Título: Java Pensamiento Orientado a Objetos (4ª Edición)",
"existencias": "98",
"id_variante": "5349677003243"
}
]
},
"titulo": "Libro usado legítimo",
"videos": [],
"_ddf": "app",
"verificacion_formato": "ok",
"ventas": 0,
"productos_relacionados": []
}