随着电子商务的飞速发展,API接口已经成为各个电商平台与外部开发者进行数据交互的主要手段。本文将重点介绍唯品会常用的两个API接口:关键字搜索API和获取商品详情数据API,以及它们如何帮助电商开发者进行高效的数据交互。
一、关键字搜索API
关键字搜索API是唯品会提供的用于商品搜索的核心API。它允许开发者根据用户输入的关键字进行商品搜索,从而获取相关商品信息。该API的使用流程如下:
1、调用接口
首先,开发者需要向唯品会申请API密钥,并使用该密钥进行身份验证。然后,通过调用唯品会提供的API接口,将用户输入的关键字作为参数传递给服务器。扫码即可获取api测试key
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
key | String | 是 | 调用key(必须以GET方式拼接在URL中) |
secret | String | 是 | 调用密钥 |
api_name | String | 是 | API接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等] |
cache | String | 否 | [yes,no]默认yes,将调用缓存的数据,速度比较快 |
result_type | String | 否 | [json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读 |
lang | String | 否 | [cn,en,ru]翻译语言,默认cn简体中文 |
version | String | 否 | API版本 |
2、服务器处理
唯品会的服务器接收到关键字后,会根据预设的算法对关键字进行匹配和排序。这个过程中,服务器会综合考虑商品名称、描述、价格等多种因素,以确定搜索结果的相关性和排序顺序。
3、返回结果
服务器将处理后的结果返回给开发者。通常情况下,返回结果包括商品ID、名称、描述、价格等信息。开发者可以根据这些信息展示给用户相应的搜索结果。
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
num_iid |
Bigint | 0 | 969908-145512642 | 宝贝ID |
title |
String | 0 | 男童白底满印熊猫大侠短袖包屁衣 | 宝贝标题 |
desc_short |
String | 0 | 商品简介 | |
price |
Float | 0 | 49.00 | 价格 |
total_price |
Float | 0 | 0 | |
suggestive_price |
Float | 0 | 0 | |
orginal_price |
Float | 0 | 109.00 | 原价 |
nick |
String | 0 | 掌柜昵称 | |
num |
Int | 0 | ||
min_num |
Int | 0 | 0 | |
detail_url |
String | 0 | http://www.vip.com/detail-969908-145512642.html | 宝贝链接 |
pic_url |
String | 0 | 宝贝图片 | |
brand |
String | 0 | 功夫熊猫 | 品牌名称 |
brandId |
Int | 0 | 品牌ID | |
rootCatId |
Int | 0 | 顶级分类ID | |
cid |
Int | 0 | ||
crumbs |
Mix | 0 | [] | |
created_time |
String | 0 | ||
modified_time |
String | 0 | ||
delist_time |
String | 0 | ||
desc |
String | 0 | |
|
desc_img |
Mix | 0 | ["//a.vpimg3.com/upload/merchandise/other/440246/KFP-8523077W00-6.jpg"] | 描述图片 |
item_imgs |
Mix | 0 | [] | 商品图片 |
item_weight |
String | 0 | ||
item_size |
String | 0 | ||
location |
String | 0 | 发货地 | |
post_fee |
Float | 0 | 物流费用 | |
express_fee |
Float | 0 | 快递费用 | |
ems_ |