> For the complete documentation index, see [llms.txt](https://resources.atriptech.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://resources.atriptech.com/api-wen-dang/pai-zhang-yu-zhi-chi/errors-handing/sou-suo-cuo-wu.md).

# 搜索错误

{% 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` 过期，重新发起智能搜索

### 相关页面

* [搜索](/api-wen-dang/readme/yu-ding-liu-cheng-gai-lan/sou-suo.md)
* [预订 API](/api-wen-dang/api-can-kao/yu-ding-api.md)
* [财务](/api-wen-dang/pai-zhang-yu-zhi-chi/faqs/atlas-api-finance.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://resources.atriptech.com/api-wen-dang/pai-zhang-yu-zhi-chi/errors-handing/sou-suo-cuo-wu.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.