Aller au contenu
GET/api/hazard/plane-crashes/1 crédit

Accidents d’avion

Un jeu de données enregistré d’accidents aériens, avec un récit de chacun, qui remonte aux années 1920. C’est un registre d’événements historiques et non un calcul astrologique ; il est proposé à côté des endpoints de thème pour qu’on puisse dresser directement un thème à partir de l’heure et du lieu d’un accident. Filtrez avec `country`, `region`, `aircraft`, `operator`, `crash_cause`, `flight_phase` et `flight_type`, tous en correspondance par sous-chaîne insensible à la casse, avec `start_date` et `end_date` sur la date de l’accident, et avec `min_fatalities`. `sort` accepte 'newest' (par défaut), 'oldest', 'name_asc' et 'name_desc' sur le type d’appareil, ainsi que 'fatalities_desc' ou 'fatalities_asc'. La pagination se fait avec `page` et `itemsPerPage` : cinquante résultats par page par défaut, cinq cents au maximum. La réponse est une enveloppe paginée composée de `count`, `next`, `previous` et `results`. Chaque résultat contient la date et une chaîne d’heure locale, le type d’appareil et l’exploitant, la phase de vol et le type de vol, une classification du site de l’accident et un lieu en texte libre, le pays et la région, la latitude et la longitude, le nombre de victimes parmi l’équipage, les passagers, les autres personnes et au total, une `crash_cause` déclarée et un paragraphe `circumstances` qui décrit ce qui s’est passé.

https://api.occultapi.com/api/hazard/plane-crashes/
Tester la requête

Authentification

Envoyez votre clé dans l’en-tête X-API-Key. Une clé est un identifiant côté serveur : ne la placez jamais dans du JavaScript exécuté par le navigateur ni dans une application mobile.

X-API-Key: yt_live_a1b2c3d4_…

Paramètres de requête (13)

Ils se passent dans l’URL. Tous sont facultatifs sauf mention contraire, et ils se combinent : filtrage, puis pagination, puis tri.

ParamètreTypeExempleRôle
aircraftstring—Filtrer par appareil (contient, insensible à la casse)

LIBRE ; correspondance par sous-chaîne `icontains` insensible à la casse sur le type d’appareil.

countrystring—Filtrer par pays (contient, insensible à la casse)
crash_causestring—Filtrer par cause de l’accident (contient, insensible à la casse)
end_datestring—Filtrer par date de fin (YYYY-MM-DD)

Contrainte de FORMAT : 'YYYY-MM-DD'. Comparé avec `date__lte`.

flight_phasestring—Filtrer par phase de vol (contient, insensible à la casse)
flight_typestring—Filtrer par type de vol (contient, insensible à la casse)
itemsPerPageinteger—Nombre d’éléments par page
min_fatalitiesinteger—Filtrer par nombre total minimal de victimes
operatorstring—Filtrer par exploitant (contient, insensible à la casse)

LIBRE ; correspondance par sous-chaîne `icontains` insensible à la casse sur l’exploitant/la compagnie aérienne.

pageinteger—Numéro de page
regionstring—Filtrer par région (contient, insensible à la casse)
sortstring—Ordre de tri : 'newest' (par défaut), 'oldest', 'name_asc' (appareil de A à Z), 'name_desc' (de Z à A), 'fatalities_desc' (le plus de victimes en premier) ou 'fatalities_asc' (le moins en premier)

Insensible à la casse et sans espaces de début et de fin. Par défaut : 'newest'. 'name_asc'/'name_desc' trient par APPAREIL (name_field='aircraft', et non par nom de personne. Les valeurs non reconnues sont remplacées sans avertissement par 'newest'.

au choix : newest, oldest, name_asc, name_desc, fatalities_desc, fatalities_asc
start_datestring—Filtrer par date de début (YYYY-MM-DD)

Contrainte de FORMAT : 'YYYY-MM-DD'. Comparé avec `date__gte`.

Exemple de requête

curl "https://api.occultapi.com/api/hazard/plane-crashes/" \
  -H "X-API-Key: $OCCULT_API_KEY"

Réponse

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"count\": 100, \"next\": \"https://api.occultapi.com/api/hazard/plane-crashes/?page=2\", \"previous\": null, \"results\": [{\"id\": 100, \"date\": \"1926-09-29\", \"time\": \"23:55:00\", \"aircraft\": \"Farman F.60 Goliath\", \"operator\": \"French Air Force - Armée de l'Air\", \"flight_phase\": \"Flight\", \"flight_type\": \"Training\", \"crash_site\": \"Plain, Valley\", \"crash_location\": \"Bonneval Eure-et-Loir\", \"country\": \"France\", \"region\": \"Europe\", \"latitude\": 48.18118, \"longitude\": 1.386218, \"crew_fatalities\": 5, \"pax_fatalities\": 0, \"other_fatalities\": 0, \"total_fatalities\": 5, \"circumstances\": \"The crew was performing a night training flight on behalf of the 3rd Squadron of the 22nd regiment based in Chartres. While flying in the region of Bonneval, some 20 km south of Chartres, the aircraft caught fire. The pilot reduced his altitude and attempted an emergency landing. From a height of 50 meters, the aircraft stalled and crashed in a huge explosion. All five occupants were killed. Crew: Lt Jules Gindre, pilot, Sgt Pierre Pacaud, navigator, Sgt Roger Duchatelle, navigator, Sgt Raymond Rigault, mechanic, Pvt Jean Frémont, radio.\", \"crash_cause\": \"Technical failure\"}, {\"id\": 99, \"date\": \"1926-09-21\", \"time\": \"11:45:00\", \"aircraft\": \"De Havilland DH.4\", \"operator\": \"United States Army Air Corps - USAAC\", \"flight_phase\": \"Takeoff (climb)\", \"flight_type\": \"Military\", \"crash_site\": \"Airport (less than 10 km from airport)\", \"crash_location\": \"Kenley AFB Surrey\", \"country\": \"United Kingdom\", \"region\": \"Europe\", \"latitude\": 51.32609, \"longitude\": -0.101269, \"crew_fatalities\": 0, \"pax_fatalities\": 1, \"other_fatalities\": null, \"total_fatalities\": 1, \"circumstances\": \"Shortly after takeoff from RAF Kenley, while climbing, the engine failed. The aircraft stalled and crashed into trees, bursting into flames. The aircraft was destroyed and both occupants were seriously injured. The pilot died from his injuries five days later. The aircraft was based at RAF Kenley and operated on behalf of the US Embassy in London. Crew: Maj Clarence Leonard Tinker. Passenger: Cdr Robert Andrew Burg. †\", \"crash_cause\": \"Technical failure\"}, {\"id\": 98, \"date\": \"1926-09-16\", \"time\": \"20:20:00\", \"aircraft\": \"De Havilland DH.4\", \"operator\": \"Robertson Aircraft Corporation\", \"flight_phase\": \"Flight\", \"flight_type\": \"Postal (mail)\", \"crash_site\": \"Plain, Valley\", \"crash_location\": \"Ottawa Illinois\", \"country\": \"United States of America\", \"region\": \"North America\", \"latitude\": 41.346844, \"longitude\": -88.842645, \"crew_fatalities\": 0, \"pax_fatalities\": 0, \"other_fatalities\": 0, \"total_fatalities\": 0, \"circumstances\": \"The pilot Charles Lindbergh was performing a mail flight from Peoria to Chicago. En route, weather conditions worsened and he lost his orientation. Few minutes later, fuel exhausted and he eventually took the decision to bail out and abandoned the aircraft that crashed in a corn field. While the aircraft was destroyed, the aviator was unhurt.\", \"crash_cause\": \"Technical failure\"}, {\"id\": 97, \"date\": \"1926-08-20\", \"time\": \"16:05:00\", \"aircraft\": \"Hanriot HD.1\", \"operator\": \"Swiss Air Force\", \"flight_phase\": \"Flight\", \"flight_type\": \"Training\", \"crash_site\": \"Airport (less than 10 km from airport)\", \"crash_location\": \"Basel-Sternenfeld Basel City\", \"country\": \"Switzerland\", \"region\": \"Europe\", \"latitude\": 47.555943, \"longitude\": 7.588639, \"crew_fatalities\": 1, \"pax_fatalities\": 0, \"other_fatalities\": 0, \"total_fatalities\": 1, \"circumstances\": \"The pilot was performing a training flight at Basel-Sternenfeld Airport. While completing manoeuvre, he lost control of the aircraft that entered a dive and crashed near the airfield. The pilot was killed.\", \"crash_cause\": \"Human factor\"}, {\"id\": 96, \"date\": \"1926-08-18\", \"time\": \"14:30:00\", \"aircraft\": \"Blériot 155\", \"operator\": \"Air Union France\", \"flight_phase\": \"Flight\", \"flight_type\": \"Scheduled Revenue Flight\", \"crash_site\": \"Plain, Valley\", \"crash_location\": \"Ashford Kent\", \"country\": \"United Kingdom\", \"region\": \"Europe\", \"latitude\": 51.1493"
}

Réponse capturée lors d’un vrai appel, avec exactement la requête ci-dessus. Les résultats se trouvent dans data.

Erreurs

Les erreurs du contrôle de clé et de crédits renvoient { "error": "…", "message": "<code>", "is_error": true }. Affichez error à vos utilisateurs et basez votre logique sur message. Voir la référence des erreurs.