义乌购平台店铺商品接口开发指南
接口概述
义乌购平台提供RESTful风格的店铺商品查询接口,支持获取指定店铺下的所有商品信息,包括商品基础信息、价格、库存等数据。
点击获取key和secret
接口地址
https://api.yiwugo.com/store/products
请求方法
GET
请求参数
参数名类型必填说明store_idstring是店铺IDpageint否分页页码(默认1)page_sizeint否每页数量(默认20,最大100)access_tokenstring是授权令牌
返回示例
{"code": 200,"data": {"products": [{"product_id": "P10086","name": "创意文具套装","price": 15.8,"stock": 500,"images": ["https://xxx.com/img1.jpg"],"specs": {"color":["红","蓝"],"size":["S","M"]}}],"total": 1,"current_page": 1}
}
错误码
-
400: 参数错误
-
401: 认证失败
-
404: 店铺不存在
-
500: 服务器错误
Java调用示例
public class YiwuProductApi {private static final String API_URL = "https://api.yiwugo.com/store/products";public static JSONObject getStoreProducts(String storeId, String token) throws IOException {HttpGet request = new HttpGet(API_URL + "?store_id=" + storeId + "&access_token=" + token);try (CloseableHttpResponse response = HttpClients.createDefault().execute(request)) {String json = EntityUtils.toString(response.getEntity());return new JSONObject(json);}}
}
Python调用示例
import requestsdef get_store_products(store_id, token):params = {'store_id': store_id,'access_token': token}response = requests.get('https://api.yiwugo.com/store/products', params=params)return response.json()
注意事项
-
需要提前申请开发者账号获取access_token
-
高频调用需遵守限流规则(100次/分钟)
-
商品数据缓存建议不超过1小时
-
敏感字段需做脱敏处理