爱回收设备估价价格查询 API 接口全解析（含标准 JSON 返回示例）

原创

Anzexi58

修改于 2026-07-21 17:31:50

1170

文章被收录于专栏：API接口开发API接口开发

一、接口基础简介

接口基础信息

请求方式：HTTPS POST，请求体 JSON
返回格式：标准 JSON
鉴权规则：请求头携带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": [
            "上门回收",
            "邮寄回收",
            "门店当面回收",
            "新机以旧换新抵扣"
        ]
    }
}

四、核心返回字段释义

通用状态层
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 返回仅为预估价。

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

api-key

爱回收设备估价价格查询 API 接口全解析（含标准 JSON 返回示例）

爱回收设备估价价格查询 API 接口全解析（含标准 JSON 返回示例）

一、接口基础简介

接口基础信息

二、接口入参示例（请求 JSON）

三、标准成功返回完整 JSON 示例

四、核心返回字段释义

五、高频异常返回 JSON 示例

1. 签名校验失败（App-Key/Secret 错误）

2. 设备型号不存在 / 参数不匹配

3. 调用频次超限限流

4. 接口权限未开通

六、开发接入注意事项

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐