得物详情 API｜支持实时价格、成色、鉴别服务数据

接口名称：得物详情 API
核心能力：获取商品基础信息、多规格 SKU 实时价格、成色信息、鉴别服务标签、库存状态、图集、销量行情
适用场景
1. 潮品实时价格监控，价格异动预警
2. 竞品数据分析，批量行情采集
3. ERP 系统自动上架，同步商品素材
4. 比价平台、潮品数据分析工具
优势：结构化 JSON 数据，相比爬虫更稳定，无需频繁适配页面改版

二、接口调用文档

1. 请求基础信息

请求地址：xxx
请求方式：POST
数据格式：JSON
编码：UTF-8

2. 请求入参

表格

参数名	类型	是否必填	说明
item_id	string	是	得物商品 ID
timestamp	string	是	时间戳，用于签名校验
sign	string	是	接口签名
source	int	否	数据来源渠道，区分现货 / 鉴别商品

3. 返回核心字段示例

复制代码

{
    "code":200,
    "msg":"success",
    "data":{
        "title":"商品标题",
        "brand":"品牌",
        "cover_img":"主图链接",
        "detail_imgs":["详情图url"],
        "sku_list":[
            {
                "sku_id":"SKU编号",
                "size":"尺码",
                "price":"实时售价",
                "condition":"成色",
                "stock":"库存数量",
                "identify_service":"鉴别服务标识"
            }
        ],
        "sale_volume":"商品销量",
        "market_ref_price":"市场参考价"
    }
}

sku_list \[\].condition：成色描述，全新 / 95 新等
sku_list \[\].identify_service：鉴别服务标签，是否支持得物鉴别

三、调用示例代码

Python

复制代码

import requests
import json

url = "接口地址"
payload = {
    "item_id": "12345678",
    "timestamp": "1750000000",
    "sign": "签名串"
}
headers = {"Content-Type": "application/json"}
resp = requests.post(url, data=json.dumps(payload), headers=headers)
result = resp.json()
print(json.dumps(result, indent=2, ensure_ascii=False))

Java

复制代码

import okhttp3.*;
public class DewuDetailApiDemo {
    public static void main(String[] args) throws Exception {
        OkHttpClient client = new OkHttpClient();
        String reqJson = "{\"item_id\":\"12345678\",\"timestamp\":\"1750000000\",\"sign\":\"签名串\"}";
        RequestBody body = RequestBody.create(reqJson, MediaType.get("application/json;charset=utf-8"));
        Request request = new Request.Builder().url("接口地址").post(body).build();
        try(Response res = client.newCall(request).execute()){
            System.out.println(res.body().string());
        }
    }
}

四、常见调用问题

签名校验失败：服务器时间和本地时间差值过大，建议误差控制在 60s 内
403 无权限：账号未开通接口权限或 IP 触发限流，降低并发请求
成色 / 鉴别字段为空：部分普通商品不提供二手成色、鉴别信息
图片访问 403：CDN 防盗链，需要处理请求头 Referer