一、接口基础简介
接口基础信息
官方估价核心接口：设备回收实时询价 API）
- 请求地址：o0b.cn/anzexi
- 请求方式：HTTPS POST，请求体 JSON
- 返回格式：标准 JSON
- 鉴权规则：请求头携带App-Key、毫秒时间戳Timestamp、HMAC-SHA256 加密Sign签名
- 核心能力：传入设备品类、品牌、型号、存储、成色、功能状态等参数，实时返回官方回收估价、报价有效期、质检规则、渠道补贴，是二手数码回收、以旧换新业务核心数据源。
主流落地业务场景
- 电商以旧换新系统：商城商品页嵌入估价功能，新机抵扣旧机价格
- 线下门店回收收银系统：到店手机 / 电脑快速自动估价，统一报价标准
- 二手回收小程序 / APP：用户自助选机成色，一键查询回收价
- 企业资产处置工具：批量办公数码设备统一估价、台账统计
- 数码比价 SaaS：整合各平台回收价，给用户闲置出售参考
二、接口入参示例（请求 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": [ "上门回收", "邮寄回收", "门店当面回收", "新机以旧换新抵扣" ] } }
四、核心返回字段释义
- 通用状态层
- code：0 = 询价成功；非 0 代表参数 / 权限 / 限流异常
- requestId：请求流水号，用于日志排查
- 设备基础信息 device_info
- 记录本次估价设备完整型号、存储、成色，用于前端展示
- 价格核心 price_info（业务核心）
- base_recycle_price：基础回收底价
- channel_subsidy：渠道专属补贴（商城 / 门店活动）
- final_recycle_price：用户最终到手回收价
- advance_deposit：邮寄回收预付定金
- 报价有效期 valid_rule
- 报价仅 2 小时有效，过期需重新调用接口询价
- 质检与结算 inspection_rule
- 标注质检周期、打款时效、故障扣款标准，用于前端告知用户
五、高频异常返回 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" }
六、开发接入注意事项
- 价格字段为浮点数字，前端展示统一保留 2 位小数；
- support_service为数组，需做空值判断，避免解析报错；
- 报价存在有效期，过期估价 ID 无法创建回收订单，需重新询价；
- 接口有 QPS 限制，批量批量估价需增加请求间隔；
- 仅企业认证账号可开通接口，个人无权限调用，禁止爬虫非法抓取报价；
- 最终成交价格以实物质检结果为准，API 返回仅为预估价。
