IMPORTANT

default

markdown

# ⭐ 重要：天行数据找不到火车 API？请使用聚合数据！

## 📋 问题说明

你反映在天行数据平台找不到"火车票务查询"接口，这是正常的。

**原因**：
- 天行数据的火车 API 可能已下架或调整
- 各平台 API 会经常调整，这是正常现象

---

## ✅ 解决方案：使用聚合数据 ⭐⭐⭐⭐⭐

### 为什么推荐聚合数据？

| 特性 | 聚合数据 | 天行数据 |
|------|---------|---------|
| **火车 API** | ✅ 稳定运营 | ❓ 可能已下架 |
| **免费额度** | 100 次/天 | 100 次/天（如有） |
| **数据质量** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| **推荐度** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |

---

## 🚀 立即行动：5 分钟搞定

### 步骤 1：注册聚合数据（2 分钟）

1. **访问**：https://www.juhe.cn
2. **注册**：点击右上角"注册"
3. **登录**：用手机号或邮箱登录

### 步骤 2：申请火车 API（2 分钟）

1. **搜索**：在 API 市场搜索"火车"或"票务"
2. **找到**："火车票务查询"或"12306 车次查询"
3. **申请**：点击"立即申请"（免费，立即生效）
4. **获取 Key**：在控制台复制 API Key

### 步骤 3：测试查询（1 分钟）

```bash
cd /root/.openclaw/workspace/travel/scripts/train_schedule

# 查询北京→上海
python query.py --from 北京 --to 上海 --api juhe --key YOUR_JUHE_KEY
```

---

## 📁 已更新的文件

所有文档和脚本已更新为**优先推荐聚合数据**：

```
scripts/train_schedule/
├── QUICKSTART.md       # ⭐ 已更新，推荐聚合数据
├── ALTERNATIVES.md     # ⭐ 新增，替代方案说明
├── query.py            # ⭐ 已更新，优化聚合数据支持
├── update_cache.sh     # 批量更新脚本
└── README.md           # 完整技术文档
```

---

## 💡 快速使用指南

### 查询示例

```bash
# 北京→西安
python query.py --from 北京 --to 西安 --api juhe --key YOUR_JUHE_KEY

# 北京→上海
python query.py --from 北京 --to 上海 --api juhe --key YOUR_JUHE_KEY

# 西安→宝鸡
python query.py --from 西安 --to 宝鸡 --api juhe --key YOUR_JUHE_KEY
```

### 批量缓存

```bash
# 缓存 35 条热门线路
./update_cache.sh YOUR_JUHE_KEY
```

---

## 📊 聚合数据 API 详情

### API 信息

- **名称**：火车票务查询
- **文档**：https://www.juhe.cn/docs/api/id/18
- **免费额度**：100 次/天
- **价格**：超出后 ¥0.01-0.02/次
- **数据源**：12306 官方

### 返回格式

```json
{
    "error_code": 0,
    "reason": "查询成功",
    "result": {
        "list": [
            {
                "train_no": "G655",
                "from_station_name": "北京西",
                "to_station_name": "西安北",
                "start_time": "07:38",
                "end_time": "12:38",
                "lishi": "05:00"
            }
        ]
    }
}
```

---

## ⚠️ 常见问题

### Q1: 找不到"火车票务查询"怎么办？

**A**: 尝试以下关键词搜索：
- "12306"
- "火车"
- "高铁"
- "车次"

如仍找不到，可能是：
- 分类调整（在"交通出行"或"生活服务"分类下）
- 暂时下架（联系客服咨询）

### Q2: 聚合数据 API 稳定吗？

**A**: 聚合数据是老牌 API 服务商，火车 API 已运营多年，稳定性好。

### Q3: 100 次/天够用吗？

**A**: 
- **个人使用**：完全够用
- **旅行规划**：配合缓存，可查询 50+ 条线路
- **高频使用**：可申请多个账号或购买付费套餐

---

## 🎯 下一步

1. **立即注册聚合数据**：https://www.juhe.cn
2. **申请火车 API**
3. **测试查询**：北京→上海
4. **批量缓存**：热门线路

---

## 📞 需要帮助？

如果有任何问题，请告诉我：
- 注册问题
- API 申请问题
- 查询失败
- 其他技术问题

我会立即帮你解决！

---

*最后更新：2026-03-14*
*维护者：Travel Agent*

Uploading file...

Edit message:

Cancel

Editing IMPORTANT