爱回收设备估价价格查询 API 接口全解析(含标准 JSON 返回示例)
一、接口基础简介
接口基础信息
官方估价核心接口:设备回收实时询价 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 返回仅为预估价。