实战代码解析：item_get——获取某鱼商品详情接口

import time, requests, hashlib, hmac, urllib.parse

APP_KEY = '你的app_key'APP_SECRET = '你的app_secret'ITEM_ID = '698765432109876543'  # 示例商品def sign(params: dict) -> str:
    """HMAC-SHA256 小写 32 位"""
    params = {k: v for k, v in params.items() if v is not None}
    query = '&'.join([f'{k}={urllib.parse.quote(str(v), safe="")}'
                      for k, v in sorted(params.items())])
    raw = f'{APP_SECRET}{query}{APP_SECRET}'
    return hmac.new(APP_SECRET.encode(), raw.encode(),
                    digestmod=hashlib.sha256).hexdigest().lower()def item_get(item_id, fields=None):
    params = {
        'method': 'xianyu.item.get',
        'app_key': APP_KEY,
        'timestamp': int(time.time() * 1000),
        'version': '2.0',
        'format': 'json',
        'item_id': item_id,
        'fields': fields or ''
    }
    params['sign'] = sign(params)
    url = 'https://api.xianyu.com/router/rest'
    resp = requests.post(url, data=params, timeout=10)
    result = resp.json()
    if result.get('code') != 200:
        raise RuntimeError(result.get('message'))
    return result['data']['item']if __name__ == '__main__':
    detail = item_get(ITEM_ID, 'title,price,condition,pics,video_url,seller_nick')
    print('标题:', detail['title'])
    print('价格:', detail['price']['current'])
    print('成色:', detail['condition'])
    print('视频:', detail.get('video_url'))

public class XianyuItemGet {
    private static final String APP_KEY  = "你的app_key";
    private static final String APP_SEC  = "你的app_secret";
    private static final String GATEWAY  = "https://api.xianyu.com/router/rest";

    public static JSONObject getItem(String itemId) throws Exception {
        Map<String, String> params = new HashMap<>();
        params.put("method", "xianyu.item.get");
        params.put("app_key", APP_KEY);
        params.put("timestamp", String.valueOf(System.currentTimeMillis()));
        params.put("version", "2.0");
        params.put("format", "json");
        params.put("item_id", itemId);
        params.put("sign", sign(params));

        FormBody.Builder body = new FormBody.Builder();
        params.forEach(body::add);
        Request req = new Request.Builder()
                .url(GATEWAY)
                .post(body.build())
                .build();
        try (Response resp = new OkHttpClient().newCall(req).execute()) {
            JSONObject json = JSON.parseObject(resp.body().string());
            if (!"200".equals(json.getString("code")))
                throw new RuntimeException(json.getString("message"));
            return json.getJSONObject("data").getJSONObject("item");
        }
    }

    private static String sign(Map<String, String> params) {
        String query = params.entrySet().stream()
                .sorted(Map.Entry.comparingByKey())
                .map(e -> e.getKey() + URLEncoder.encode(e.getValue(), StandardCharsets.UTF_8))
                .collect(Collectors.joining("&"));
        String raw = APP_SEC + query + APP_SEC;
        return Hex.encodeHexString(DigestUtils.sha256(raw)).toLowerCase();
    }

    public static void main(String[] args) throws Exception {
        JSONObject item = getItem("698765432109876543");
        System.out.println("标题：" + item.getString("title"));
        System.out.println("价格：" + item.getJSONObject("price").getBigDecimal("current"));
    }}