# FAA-Verspätungen

FAA-NAS-Verspätungen in Echtzeit – Ground Delay Programs, Ground Stops, Schließungen und Airspace Flow Programs für US-Flughäfen.



Rufen Sie aktive Verspätungsprogramme des FAA National Airspace System ([**NAS**](https://www.faa.gov/about/office_org/headquarters_offices/ato/service_units/operations/at_delay_info) — ziviler Luftraum der USA) für Flughäfen in den USA und in US-Territorien ab. Verwenden Sie den landesweiten Feed für Betriebs-Dashboards und den flughafenbezogenen Feed, um Abflugtafeln, Crew-Benachrichtigungen und Passagierinformationen zu ergänzen.

Verspätungskategorien:

| Code        | Name                              | Beschreibung                                                                                                       |
| ----------- | --------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| **GDP**     | Ground Delay Program              | Zuflusssteuerung der Ankünfte an einer Einrichtung — enthält Strings für durchschnittliche und maximale Verspätung |
| **GS**      | Ground Stop                       | Zurückhalten von Abflügen zu einer bestimmten Einrichtung                                                          |
| **Closure** | Schließung von Flughafen/Programm | Einrichtung geschlossen oder eingeschränkt                                                                         |
| **AFP**     | Airspace Flow Program             | Verkehrsflussmanagement mit Umleitungen auf ARTCC-Ebene                                                            |

Die Abdeckung beschränkt sich auf Flughäfen im Zuständigkeitsbereich der FAA — die kontinentalen USA, Alaska, Hawaii, Puerto Rico, die Amerikanischen Jungferninseln, Guam und weitere US-Territorien im Pazifik. Für internationale Verspätungsinformationen kombinieren Sie die Daten mit [Flugstatus](/docs/v31/flight-status) und Betriebsdaten der Fluggesellschaften.

**Wichtig:** Die Arrays der Antwort sind immer vorhanden, können aber leer sein — `total_alerts: 0` mit einem `message`-String ist eine gültige Antwort „keine aktiven Programme“, kein Fehler. Speichern Sie Ergebnisse nicht länger als **2–5 Minuten** im Cache — GDP- und GS-Programme ändern sich sehr kurzfristig.

| Endpoint                 | Einsatzzweck                                                           |
| ------------------------ | ---------------------------------------------------------------------- |
| `GET /delays/faa`        | Betriebskarte — alle aktiven GDP-, GS-, Schließungs- und AFP-Meldungen |
| `GET /delays/faa/{icao}` | Flughafendetails — Verspätungen, die einen US-Flughafen betreffen      |

<DocJumpNav>
  <DocJumpLink href="#all-current-faa-delays" icon="solar:earth-bold-duotone">
    Landesweit
  </DocJumpLink>

  <DocJumpLink href="#delays-for-a-specific-airport" icon="solar:map-point-bold-duotone">
    Pro Flughafen
  </DocJumpLink>
</DocJumpNav>

## Alle aktuellen FAA-Verspätungen [#all-current-faa-delays]

Liefert alle aktiven [FAA-NAS](https://www.faa.gov/about/office_org/headquarters_offices/ato/service_units/operations/at_delay_info)-Verspätungen landesweit.

### Anfrage [#request]

<DocRequirements>
  <DocRequirementAuth />
</DocRequirements>

<DocApiPath method="GET" path="/delays/faa" />

Keine Query-Parameter. Liefert die aktuellen Verspätungsprogramme der FAA; die Daten werden bei jeder Anfrage aktualisiert.

### Antwort [#response]

```json
{
  "ground_delays": [
    {
      "airport": "KSFO",
      "airport_name": null,
      "reason": "low ceilings",
      "avg_delay": "34 minutes",
      "max_delay": "1 hour and 25 minutes"
    }
  ],
  "ground_stops": [],
  "closures": [
    {
      "airport": "KJFK",
      "airport_name": null,
      "reason": "!JFK 06/158 JFK AD AP CLSD TO TRANSIENT GA ACFT EXC 24HR PPR ...",
      "begin": "Jun 11 at 16:30 UTC.",
      "reopen": "Jul 22 at 03:59 UTC."
    }
  ],
  "airspace_flow_programs": [],
  "total_alerts": 8,
  "message": null
}
```

| Feld                     | Typ     | Erforderlich | Null?  | Beschreibung                                   |
| ------------------------ | ------- | ------------ | ------ | ---------------------------------------------- |
| `ground_delays`          | array   | **Ja**       | Nie    | Aktive GDP-Einträge                            |
| `ground_stops`           | array   | **Ja**       | Nie    | Aktive Ground Stops                            |
| `closures`               | array   | **Ja**       | Nie    | Schließungen von Flughäfen/Programmen          |
| `airspace_flow_programs` | array   | **Ja**       | Nie    | Airspace Flow Programs der ARTCCs              |
| `total_alerts`           | integer | Nein         | Nie    | Summe aller Meldungszeilen (Standardwert `0`)  |
| `message`                | string  | Nein         | **Ja** | Statustext, wenn keine Verspätungen aktiv sind |

#### Ground Delay (`ground_delays[]`) [#ground-delay-ground_delays]

| Feld           | Typ    | Erforderlich | Null?  | Beschreibung                                                |
| -------------- | ------ | ------------ | ------ | ----------------------------------------------------------- |
| `airport`      | string | **Ja**       | Nie    | ICAO- oder FAA-Kennung des Flughafens                       |
| `airport_name` | string | Nein         | **Ja** | Name des Flughafens, sofern angegeben                       |
| `reason`       | string | **Ja**       | Nie    | Grund der Verspätung (häufig Wetter oder Verkehrsaufkommen) |
| `avg_delay`    | string | Nein         | **Ja** | Durchschnittliche Verspätungsdauer (menschenlesbar)         |
| `max_delay`    | string | Nein         | **Ja** | Maximale Verspätungsdauer                                   |

#### Ground Stop (`ground_stops[]`) [#ground-stop-ground_stops]

| Feld           | Typ    | Erforderlich | Null?  | Beschreibung                          |
| -------------- | ------ | ------------ | ------ | ------------------------------------- |
| `airport`      | string | **Ja**       | Nie    | Betroffener Flughafen                 |
| `airport_name` | string | Nein         | **Ja** | Name des Flughafens, sofern verfügbar |
| `reason`       | string | **Ja**       | Nie    | Grund des Stopps                      |
| `end_time`     | string | Nein         | **Ja** | Erwartetes Ende (UTC)                 |

#### Schließung (`closures[]`) [#closure-closures]

| Feld           | Typ    | Erforderlich | Null?  | Beschreibung                                     |
| -------------- | ------ | ------------ | ------ | ------------------------------------------------ |
| `airport`      | string | **Ja**       | Nie    | Betroffener Flughafen                            |
| `airport_name` | string | Nein         | **Ja** | Name des Flughafens, sofern verfügbar            |
| `reason`       | string | **Ja**       | Nie    | Grund der Schließung (enthält häufig NOTAM-Text) |
| `begin`        | string | Nein         | **Ja** | Beginn der Schließung (UTC, menschenlesbar)      |
| `reopen`       | string | Nein         | **Ja** | Erwarteter Zeitpunkt der Wiedereröffnung         |

#### Airspace Flow Program (`airspace_flow_programs[]`) [#airspace-flow-program-airspace_flow_programs]

| Feld        | Typ    | Erforderlich | Null?  | Beschreibung                                                                           |
| ----------- | ------ | ------------ | ------ | -------------------------------------------------------------------------------------- |
| `facility`  | string | **Ja**       | Nie    | Kennung der ATC-Einrichtung (**ARTCC** — Streckenkontrollzentrale), kein Flughafencode |
| `reason`    | string | **Ja**       | Nie    | Grund des Programms                                                                    |
| `fca_start` | string | Nein         | **Ja** | Beginn der Flow Constrained Area                                                       |
| `fca_end`   | string | Nein         | **Ja** | Ende der Flow Constrained Area                                                         |

**Wichtig:** Airspace Flow Programs verwenden `facility` (ARTCC) statt eines Flughafencodes — kennzeichnen Sie sie in den Texten Ihrer UI eindeutig, damit Benutzer AFP-Zeilen nicht mit flughafenspezifischen Verspätungen verwechseln.

<APIPage document="&#x22;https://api.skylinkapi.com/v3.1/openapi.json&#x22;" operations="[{&#x22;path&#x22;:&#x22;/delays/faa&#x22;,&#x22;method&#x22;:&#x22;get&#x22;}]" />

## Verspätungen für einen bestimmten Flughafen [#delays-for-a-specific-airport]

Liefert aktive [FAA-Verspätungen](https://www.faa.gov/about/office_org/headquarters_offices/ato/service_units/operations/at_delay_info), gefiltert nach einem bestimmten US-Flughafen anhand seines ICAO-Codes. Airspace Flow Programs (auf ARTCC-Ebene) sind vollständig enthalten, da sie den angefragten Flughafen indirekt betreffen können.

### Anfrage [#request-1]

<DocRequirements>
  <DocRequirementAuth />
</DocRequirements>

<DocApiPath method="GET" path="/delays/faa/{icao}" />

| Parameter | Typ    | Erforderlich | Beschreibung                              |
| --------- | ------ | ------------ | ----------------------------------------- |
| `icao`    | string | Ja           | Vierstelliger US-ICAO-Code (z. B. `KJFK`) |

### Antwort [#response-1]

Gleiche Hülle wie bei [Alle aktuellen FAA-Verspätungen](#all-current-faa-delays), wobei die Arrays auf den angefragten Flughafen gefiltert sind (zuzüglich relevanter AFP-Zeilen).

```json
{
  "ground_delays": [],
  "ground_stops": [],
  "closures": [
    {
      "airport": "KJFK",
      "airport_name": null,
      "reason": "!JFK 06/158 JFK AD AP CLSD TO TRANSIENT GA ACFT EXC 24HR PPR ...",
      "begin": "Jun 11 at 16:30 UTC.",
      "reopen": "Jul 22 at 03:59 UTC."
    }
  ],
  "airspace_flow_programs": [],
  "total_alerts": 1,
  "message": null
}
```

<APIPage document="&#x22;https://api.skylinkapi.com/v3.1/openapi.json&#x22;" operations="[{&#x22;path&#x22;:&#x22;/delays/faa/{icao}&#x22;,&#x22;method&#x22;:&#x22;get&#x22;}]" />

## Client-Typen [#client-types]

<DocClientTypes id="v31/faa-delays/delays-types" />

## Integration [#integration]

Fragen Sie [FAA-Verspätungen](https://www.faa.gov/about/office_org/headquarters_offices/ato/service_units/operations/at_delay_info) pro Flughafen regelmäßig ab und führen Sie sie für eine Abflugtafel in einer einheitlichen Meldungsliste zusammen.

Das folgende Beispiel speichert Antworten 2 Minuten im Cache, da sich Verspätungsprogramme bei Wetterereignissen häufig ändern. Jede Anfrage verwendet explizite Timeouts (10 s Verbindungsaufbau / 20 s Lesen). Die Hilfsfunktion führt GDP-, GS-, Schließungs- und AFP-Zeilen in einer einzigen `DelayAlert`-Liste für die Darstellung als Badges zusammen.

<DocExample id="v31/faa-delays/delays-fetch" />

### Hinweise zur Implementierung [#implementation-notes]

**Menschenlesbare Dauern.** `avg_delay` und `max_delay` sind Strings (z. B. `"34 minutes"`) — parsen Sie sie zurückhaltend oder zeigen Sie sie unverändert an.

**Leere Antworten.** `total_alerts: 0` mit gesetztem `message` kann bedeuten, dass landesweit keine Programme aktiv sind — zeigen Sie einen Leerzustand an, kein Fehlerbanner.

## Fehlerantworten [#error-responses]

Gemeinsame Plattformfehler: [Fehlerbehandlung](/docs/errors). Endpoint-spezifisch:

### 422 — ungültige ICAO-Länge [#422--invalid-icao-length]

```json
{
  "detail": [
    {
      "type": "string_too_short",
      "loc": ["path", "icao"],
      "msg": "String should have at least 4 characters"
    }
  ]
}
```

### Integrationsleitfäden [#integration-guides]

| Leitfaden                                                       | Inhalt                                                   |
| --------------------------------------------------------------- | -------------------------------------------------------- |
| [NOTAMs](/docs/v31/notams-integration)                          | Übersichtstabelle, Flugplatzfilter, Prüfung vor dem Flug |
| [FAA-Verspätungen](/docs/v31/faa-delays-integration)            | Landesweiter Überblick, Hub-Dashboard                    |
| [Fehlerbehandlung](/docs/v31/alerts-integration-errors)         | Leere Arrays, Abdeckung nur für die USA                  |
| [Caching & Monitoring](/docs/v31/alerts-integration-production) | TTLs von 5 min für NOTAMs / 2 min für FAA                |

***

Siehe auch: [NOTAMs](/docs/v31/notams) · [Flugstatus](/docs/v31/flight-status) · [Flugpläne](/docs/v31/schedules)