义乌购平台店铺商品接口开发指南

Ace_31750887762025-06-18 15:43

接口概述

义乌购平台提供RESTful风格的店铺商品查询接口，支持获取指定店铺下的所有商品信息，包括商品基础信息、价格、库存等数据。

接口地址

arduino 复制代码

https://api.yiwugo.com/store/products

请求方法

GET

请求参数

参数名类型必填说明store_idstring是店铺IDpageint否分页页码(默认1)page_sizeint否每页数量(默认20,最大100)access_tokenstring是授权令牌

返回示例

css 复制代码

{
  "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调用示例

typescript 复制代码

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调用示例

csharp 复制代码

import requests

def 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小时
敏感字段需做脱敏处理