# 二手车出售人电话查询 API：按车辆 ID 取出售人手机号

做二手车详情页，"联系出售人"是转化链路里最关键的一步。车源列表（`usedcar.list`）能让你拿到每一辆车的 `dataId`，但车主电话不会直接给出来——`usedcar.sellerphone` 把这个环节单独做成一个 GET 接口：**传一个车辆 ID（dataId）就能查回该车辆的出售人联系手机号**。

计费口径：**拿到可用号码才收费，0.2 元/次**。当 `dataId` 无效、查不到电话、或号码暂不可用（已失效）时，返回失败（JSON 的 `code != 0` 分支），不扣费、不写扣费流水、不累加调用次数。详见第九节。

- ``api.xujian.tech``
- `V`：``xujian_cq``

## 接口速览

| 关键事实 | 说明 |
|------|------|
| 接口地址 | `https://api.xujian.tech/openapi/usedcar/sellerphone` |
| 接口编码 | `usedcar.sellerphone` |
| 请求方式 | GET |
| 鉴权方式 | 请求头 `X-API-Key`，不做签名、时间戳或加密 |
| 必填参数 | `dataId`（车辆 ID，取自 `usedcar.list` 返回的车辆 `dataId`） |
| 可选参数 | `infoid`（`dataId` 的历史别名，两者等价） |
| 返回字段 | `phone`（出售人联系手机号） |
| 计价 | 按次计费，**0.2 元/次** |
| 不计费场景 | 服务未启用或未配置、鉴权失败、余额不足、`dataId` 缺失或非法、未查询到电话、**号码暂不可用** |
| 建议超时 | 15 秒以上（`costMs` 为真实耗时） |

> 本接口与 `usedcar.list`（车源列表）配套使用：先用车源列表拿到每辆车的 `dataId`，再用本接口取该车辆的出售人电话，挂到详情页的"联系出售人"按钮上。

## 一、这个接口能做什么

只做一件事：**输入车辆 ID，输出该车辆的出售人联系手机号**。返回结构极简，就是一个 `phone` 字符串，方便你直接拼到"电话咨询 / 联系出售人"的交互里。

> 重要提示：出售人电话由上游实时返回，有四点务必注意：① 该号码为<strong>虚拟号码（隐私号 / 中间号）</strong>，并非出售人真实直拨号码；② **号码有效期较短**，请在用户实际使用（点击「联系出售人」）前**实时查询**，不要长期缓存或提前批量拉取后反复使用，否则容易拿到已失效的号码；③ **不是所有车辆都能查到号码**——部分车源上游未收录电话，会走失败分支且不收费；④ **并非所有号码都正确**——数据来自互联网公开信息，可能存在空号、错号、停用或登记有误的情况，平台不保证号码的可用性与准确性。当号码暂不可用（如已失效）时，接口会直接返回失败且不收费。

## 二、请求参数

| 参数名 | 位置 | 必填 | 类型 | 默认值 | 示例 | 说明 |
|--------|------|------|------|--------|------|------|
| `X-API-Key` | Header | 是 | String | — | — | 开发者 API Key |
| `dataId` | Query | **是** | String | — | 60335237 | 车辆 ID，取 `usedcar.list` 返回的 `dataId`；缺失或取到参数时空返回失败且**不计费** |
| `infoid` | Query | 否 | String | — | 60335237 | `dataId` 的历史别名，口径完全一致；仅当 `dataId` 为空时生效，新接入请直接用 `dataId` |

> `dataId` 从哪里来：`usedcar.list` 车源列表每条车源都带一个 `dataId` 字段（车辆 ID）。本接口只认这个 ID；如果传的不是列表返回的 `dataId`，或该车辆没有可用的出售人电话，会返回失败且不收费。

## 三、返回字段

### 3.1 顶层 data 字段

| 字段 | 类型 | 说明 |
|------|------|------|
| `dataId` | String | 本次查询使用的车辆 ID（原样回显） |
| `phone` | String | 出售人联系手机号（号码可用且取到时返回） |
| `apiCode` | String | `usedcar.sellerphone` |
| `apiName` | String | 二手车出售人电话查询 |
| `chargeType` | String | `PER_CALL` |
| `balance` | BigDecimal | 扣费后余额（元） |
| `costMs` | Long | 本次调用耗时（毫秒） |

## 四、调用示例

### 4.1 curl

```bash
curl -s -G "https://api.xujian.tech/openapi/usedcar/sellerphone" \
  --data-urlencode "dataId=60335237" \
  -H "X-API-Key: 你的APIKey"
```

### 4.2 Java

```java
HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://api.xujian.tech/openapi/usedcar/sellerphone?dataId=60335237"))
        .header("X-API-Key", apiKey)
        .timeout(Duration.ofSeconds(15))
        .GET()
        .build();

String json = HttpClient.newHttpClient()
        .send(request, HttpResponse.BodyHandlers.ofString(StandardCharsets.UTF_8))
        .body();
```

### 4.3 Python

```python
import requests


def get_seller_phone(api_key: str, data_id: str) -> str | None:
    """按车辆 dataId 取出售人电话；查不到返回 None（不扣费）"""
    resp = requests.get(
        "https://api.xujian.tech/openapi/usedcar/sellerphone",
        params={"dataId": data_id},
        headers={"X-API-Key": api_key},
        timeout=15,
    )
    result = resp.json()
    if result.get("code") != 0:
        print("查询失败（不收费）：", result.get("msg"))
        return None
    return result["data"]["phone"]
```

### 4.4 JavaScript

```javascript
const params = new URLSearchParams({ dataId: "60335237" });

const { code, msg, data } = await fetch(
  `https://api.xujian.tech/openapi/usedcar/sellerphone?${params}`,
  { headers: { "X-API-Key": API_KEY } }
).then((r) => r.json());

if (code === 0) {
  console.log("出售人电话：", data.phone, "（展示前请做拨打校验）");
} else {
  console.warn("查询失败（不收费）：", msg);
}
```

## 五、返回示例

```json
{
  "code": 0,
  "msg": "success",
  "data": {
    "dataId": "60335237",
    "phone": "17882983314",
    "apiCode": "usedcar.sellerphone",
    "apiName": "二手车出售人电话查询",
    "chargeType": "PER_CALL",
    "balance": 99.8000,
    "costMs": 410
  }
}
```

号码暂不可用时（不计费）：

```json
{
  "code": 500,
  "msg": "未查询到可用的出售人电话（号码暂不可用），本次调用不计费",
  "data": null
}
```

参数缺失时（不计费）：

```json
{
  "code": 500,
  "msg": "dataId 不能为空（取 usedcar.list 返回的车辆 dataId）",
  "data": null
}
```

## 六、落地实践

### 6.1 详情页挂"联系出售人"按钮

```python
def render_contact(api_key: str, car: dict) -> dict:
    """车源详情页：拿到车辆 dataId 后尝试取出售人电话"""
    phone = get_seller_phone(api_key, car["dataId"])
    if phone:
        return {"can_contact": True, "phone": phone,
                "tip": "请在工作时间拨打，若无法接通可换其他方式联系出售人"}
    return {"can_contact": False, "phone": None,
            "tip": "该车辆暂未提供可用电话，可先收藏或在线沟通"}
```

### 6.2 与车源列表串联（先拿 dataId 再取电话）

```python
def fetch_listing_with_phone(api_key: str, province: int, city: int | None = None) -> list:
    """先拉车源列表，再对首屏车辆批量取出售人电话"""
    cars = list_used_cars(api_key, province, city)        # usedcar.list
    for car in cars[:5]:                                   # 取前 5 辆做详情
        car["sellerPhone"] = get_seller_phone(api_key, car["dataId"])  # usedcar.sellerphone
    return cars
```

### 6.3 三个注意点

1. **号码可能不可用**：号码暂不可用时接口直接失败不收费，调用方应把"联系出售人"做降级（隐藏按钮 / 改用在线沟通）。
2. **不要直接用号码做群呼**：出售人电话是个人隐私，展示与拨打应遵守相关法规，建议仅在该用户主动点击"联系出售人"后按需取用。
3. **使用前请实时查询、勿长缓存**：号码为虚拟号码、有效期较短，不要提前批量拉取或长期缓存后反复使用，否则很可能拿到已失效号码；如确需缓存，也只缓存极短时间（分钟级），且仅在即将展示给用户前取用。

## 七、实践建议

1. **dataId 来自车源列表**：本接口不独立检索车辆，必须先用车源列表（`usedcar.list`）拿到 `dataId` 再查。
2. **失败分支（code ≠ 0）即"没查到"**：号码暂不可用、dataId 无效都会走这个分支，不扣费，按"暂不可联系"处理即可。
3. **展示前务必做拨打校验**：返回的是虚拟号码，可能出现空号 / 停用 / 错号，且数据来自互联网公开信息、可能包含错误数据，给用户的提示要到位，避免"点开是空号"的体验。
4. **配合参数与估价做完整链路**：车源列表选品 → 车型参数（`usedcar.param`）展示 → 价格评估（`usedcar.price`）定价 → 本接口引导联系出售人。

## 八、错误码与排查

| code | msg（示例） | 处理建议 |
|------|-------------|----------|
| 0 | success | 调用成功 |
| 500 | 缺少请求头 X-API-Key / API Key 无效 / 已停用 | 检查请求头与 Key 状态 |
| 500 | 余额不足，请先充值 | 充值后重试，余额不足不扣费 |
| 500 | 二手车服务未启用 / 未配置 | 稍后重试；不计费 |
| 500 | dataId 不能为空（取 usedcar.list 返回的车辆 dataId） | 补齐 `dataId`；不计费 |
| 500 | 未查询到可用的出售人电话（号码暂不可用），本次调用不计费 | 该车辆号码暂不可用，换其他车辆或稍后重试；**不计费** |
| 500 | 数据服务暂时不可用（请求上游超时或网络异常），本次调用不计费 | 稍后重试；**不计费** |

## 九、计费与接入

| 项目 | 说明 |
|------|------|
| 单价 | **0.2 元/次** |
| 计费方式 | 按次计费，调用前校验余额，**返回可用号码才计一次** |
| 不计费场景 | 服务未启用或未配置、鉴权失败、余额不足、`dataId` 缺失或非法、未查询到电话、号码暂不可用 |
| 建议超时 | 15 秒以上 |

接入流程：注册开发者账号 → 控制台创建 API Key → 请求头带上 `X-API-Key` 即可调用，无需签名或加密。控制台可查看调用量、扣费流水与余额。

> 服务站点：`api.xujian.tech`（纯文本域名，不做跳转）。接口试用、数据与充值咨询可在控制台提交工单，或联系 V`xujian_cq`。

> 边界说明：本接口返回的出售人电话是平台可查的联系方式快照，号码可能出现空号、停用等情况，平台不保证其可用性与接通率；实际联系与交易请以车商与实车为准。调用方应遵守个人隐私相关法律法规，仅在用户主动发起联系时按需取用。

## 十、小结

出售人电话这类接口的价值在于"临门一脚"：一个车辆 ID、一次调用，就能把"联系出售人"按钮从灰变亮，直接拉高转化。真正要花心思的不是调用，而是**号码可用性降级**与**隐私合规**。

使用时要记住：

- **dataId 必填**，且必须来自 `usedcar.list` 返回的车辆 `dataId`；
- **号码可能不可用 / 不准确**：号码暂不可用时接口返回失败且不收费；数据来自互联网，可能有空号、错号或登记有误；
- **展示前做拨打校验**，给用户的提示要到位；
- **遵守隐私合规**，仅在用户主动联系时取用号码；
- **查不到电话走失败分支且不扣费**；
- **使用前实时查询、勿长缓存**：号码有效期较短，建议在用户点击「联系出售人」前实时取用，不要提前批量拉取或长期缓存。

配套接口：`usedcar.list`（0.01 元/次）先拿车源与 dataId；`usedcar.param`（0.2 元/次）取该车完整配置参数；`usedcar.price`（0.50 元/次）给某辆车估个价。想做完整的"选品 → 看配置 → 定价 → 联系出售人"链路，四个接口正好串起来。

二手车出售人电话查询 API：按车辆 ID 取出售人手机号 做二手车详情页，"联系出售人"是转化链路里最关键的一步。车源列表（usedcar.list）能让你拿到每一辆车的 dataId，但车主电话不会直接给出来——usedcar.sellerphone 把这个环节单独做成一个 GET 接口：传一个车辆 ID（dataId）就能查回该车辆的出售人联系手机号。 计费口径：拿到可用号码才收费，0.2 

二手车出售人电话查询 API：按车辆 ID 取出售人手机号

编程语言

二手车出售人电话查询API，输入车辆ID即可获取虚拟联系号码，0.2元/次仅成功计费。与车源列表接口配套使用，适用于详情页"联系出售人"按钮场景，支持Java、Python等多语言调用。

JavaScript

Python

JSON

Java

热销域名限时优惠，新客首年免费！


domain

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

二手车出售人电话查询 API：按车辆 ID 取出售人手机号-腾讯云开发者社区-腾讯云

二手车出售人电话查询 API：按车辆 ID 取出售人手机号

二手车出售人电话查询 API：按车辆 ID 取出售人手机号

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐