爱回收设备估价价格查询 API 接口全解析（含标准 JSON 返回示例）
# 一、接口基础简介 # 接口基础信息 1. 请求方式：HTTPS POST，请求体 JSON 1. 返回格式：标准 JSON 1. 鉴权规则：请求头携带App-Key、毫秒时间戳Timestamp、HMAC-SHA256 加密Sign签名 # 二、接口入参示例（请求 JSON） ``` { "category": "phone", "brand": "Apple", "model": "iPhone 15 Pro", "storage": "256GB", "color": "黑色钛金属", "appearance_level": "A", "screen_status": "normal", "battery_health": "92%", "is_original": true, "has_repair": false, "channel_id": "store_official_001" } ``` 参数简要说明： - category：设备类型 phone 手机 /pad 平板 /laptop 笔记本 - appearance_level：成色等级 A 九成新 / B 八成新 / C 七成新 / D 破损 - screen_status：屏幕正常 / 漏液 / 碎裂 - is_original：是否原装无拆修 # 三、标准成功返回完整 JSON 示例 ``` { "code": 0, "msg": "success", "requestId": "AIH202607211702008966", "data": { "valuation_id": "VAL260721000896", "device_info": { "category": "phone", "brand": "Apple", "model": "iPhone 15 Pro", "storage": "256GB", "color": "黑色钛金属", "appearance": "九成新(A级)", "battery_health": "92%" }, "price_info": { "base_recycle_price": 5200.00, "channel_subsidy": 180.00, "final_recycle_price": 5380.00, "advance_deposit": 100.00, "currency": "CNY" }, "valid_rule": { "valid_minutes": 120, "expire_time": "2026-07-21 19:02:00" }, "inspection_rule": { "inspect_cycle": "24小时内完成质检", "pay_time": "质检无误2小时内打款", "deduction_desc": "屏幕碎裂扣800元、主板维修扣1500元" }, "support_service": [ "上门回收", "邮寄回收", "门店当面回收", "新机以旧换新抵扣" ] } } ``` # 四、核心返回字段释义 1. **通用状态层** 1. code：0 = 询价成功；非 0 代表参数 / 权限 / 限流异常 1. requestId：请求流水号，用于日志排查 1. **设备基础信息 device_info** 1. 记录本次估价设备完整型号、存储、成色，用于前端展示 1. **价格核心 price_info（业务核心）** - base_recycle_price：基础回收底价 - channel_subsidy：渠道专属补贴（商城 / 门店活动） - final_recycle_price：用户最终到手回收价 - advance_deposit：邮寄回收预付定金 1. **报价有效期 valid_rule** 1. 报价仅 2 小时有效，过期需重新调用接口询价 1. **质检与结算 inspection_rule** 1. 标注质检周期、打款时效、故障扣款标准，用于前端告知用户 # 五、高频异常返回 JSON 示例 # 1. 签名校验失败（App-Key/Secret 错误） ``` { "code": 10001, "msg": "签名校验不通过，请核对App-Secret与时间戳", "requestId": "AIH202607211705001122" } ``` # 2. 设备型号不存在 / 参数不匹配 ``` { "code": 20003, "msg": "无对应设备型号，请核对brand、model参数", "requestId": "AIH202607211706002233" } ``` # 3. 调用频次超限限流 ``` { "code": 429, "msg": "接口调用频率超出限制，请30秒后重试", "requestId": "AIH202607211707003344" } ``` # 4. 接口权限未开通 ``` { "code": 10005, "msg": "当前应用未开通设备估价接口权限", "requestId": "AIH202607211708004455" } ``` # 六、开发接入注意事项 1. 价格字段为浮点数字，前端展示统一保留 2 位小数； 1. support_service为数组，需做空值判断，避免解析报错； 1. 报价存在有效期，过期估价 ID 无法创建回收订单，需重新询价； 1. 接口有 QPS 限制，批量批量估价需增加请求间隔； 1. 仅企业认证账号可开通接口，个人无权限调用，禁止爬虫非法抓取报价； 1. 最终成交价格以实物质检结果为准，API 返回仅为预估价。
