# 搜索错误

{% hint style="info" %}
遇到 API 接入问题时，可登录 [Eva](https://www.atriptech.com/) 寻求帮助。
{% endhint %}

当 `search.do`、`smartSearch.do` 或 `getOffers.do` 失败时，使用这个页面。

### 高频错误码

#### `102` Illegal request param

一个或多个搜索字段不合法。

**常见原因**

* No adult passenger
* Too many passengers
* Invalid city code
* Missing `fromDate` or `retDate`
* Bad date format

**处理建议**

* Validate trip type
* Validate passenger counts
* Validate city and airport codes
* Use `YYYYMMDD` for dates

#### `107` Insufficient balance

账户余额低于要求阈值。

**处理建议**

* Top up the account
* Re-run the search after balance is updated

#### `108` Route restricted / system limitations

Atlas 已关闭该航线或流程的销售。

**处理建议**

* Retry later
* Check with Atlas if this route should be available

#### `110` Too many concurrent requests

搜索 QPS 超过限制。

**处理建议**

* Throttle request bursts
* Add retry and queue control
* Contact Atlas if higher throughput is required

#### `112` 或 `127` Search timeout

搜索未在规定时间内完成。

**处理建议**

* Retry the search
* Reduce burst load
* Use smart search or polling when applicable

#### `123` Too many requests but too few paid orders

搜索量相对已支付订单过高。

**处理建议**

* Reduce unnecessary search traffic
* Avoid synthetic or duplicate search bursts

#### `124` Unsupported settlement currency

该币种不支持结算。

**处理建议**

* Switch to the account settlement currency

#### `126` `requestId` does not exist or has already ended

智能搜索的 `requestId` 无效或已过期。

**处理建议**

* Start a new smart search
* Use the new `requestId`

### 快速排查清单

1. 检查必填字段和日期格式
2. 检查余额和结算币种
3. 确认航线是否支持
4. 检查并发和重试策略
5. 如果 `requestId` 过期，重新发起智能搜索

### 相关页面

* [搜索](https://resources.atriptech.com/api-wen-dang/ji-cheng-zhi-nan/yu-ding-liu-cheng-gai-lan/sou-suo)
* [预订 API](https://resources.atriptech.com/api-wen-dang/api-can-kao/yu-ding-api)
* [财务](https://resources.atriptech.com/api-wen-dang/pai-zhang-yu-zhi-chi/faqs/atlas-api-finance)