# 航司状态更新通知

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

当你需要响应航司可用性变化时，使用这个 webhook。

### 触发时机

当航司在 `Active`、`Maintenance` 和 `Inactive` 之间切换时，Atlas 会发送 `airline.status`。

### 收到后建议处理

When you receive this event:

* 更新内部航司可用性状态
* 调整搜索缓存或路由策略
* 对维护中或不可用航司暂停预订流程

### 推送方式

Atlas 会向你已注册的 webhook 地址发起 `POST` 请求。

### 建议优先读取的字段

* `type`
* `data.airline`
* `data.airlineStatus`

### 航司状态值

* `Active`
* `Maintenance`
* `Inactive`

### 典型载荷

```json
{
  "data": {
    "airline": ["TO", "HV"],
    "airlineStatus": "Active"
  },
  "status": -1,
  "type": "airline.status"
}
```

### 说明

* `status` 是内部字段，不要作为业务判断依据
* 这是运营事件，不是订单级事件
* `Maintenance` 和 `Inactive` 应视为暂不可售

{% tabs %}
{% tab title="字段说明" %}
**data**

* **类型：** Object
* **是否必填：** 是
* **说明：** 包含航司代码和对应状态。
* **默认值：** 无
* **示例：**

  ```json
  {
    "airline": ["TO", "HV"],
    "airlineStatus": "Active"
  }
  ```

**data.airline**

* **类型：** String 数组
* **是否必填：** 是
* **说明：** 本次状态更新涉及的航司代码列表。
* **默认值：** 无
* **示例：** `["TO", "HV"]`

**data.airlineStatus**

* **类型：** String
* **是否必填：** 是
* **说明：** 航司当前运行状态。
* **可选值：**
  * `Active` = 正常可用
  * `Maintenance` = 维护中
  * `Inactive` = 不可用
* **默认值：** 无
* **示例：** `"Active"`

**status**

* **类型：** Integer
* **是否必填：** 是
* **说明：** 返回状态，仅供 Atlas 内部使用。
* **默认值：** 无
* **示例：** `-1`

**type**

* **类型：** String
* **是否必填：** 是
* **说明：** 事件类型。
* **固定值：** `airline.status`
* **默认值：** 无
* **示例：** `"airline.status"`
  {% endtab %}

{% tab title="示例" %}

```json
{
  "data":{
     "airline":["TO","HV"],
     "airlineStatus":"Active"},
  "status":-1,
  "type":"airline.status"
}
```

{% endtab %}
{% endtabs %}

### 相关页面

* [Webhook 概览](https://resources.atriptech.com/api-wen-dang/ji-cheng-zhi-nan/webhook-gai-lan)
* [搜索错误](https://resources.atriptech.com/api-wen-dang/pai-zhang-yu-zhi-chi/errors-handing/sou-suo-cuo-wu)