Aero-task API

L'API Aero-task lit vos documents de maintenance aéronautique — PDF ou image — et en renvoie le contenu structuré en JSON : les tâches d'un livret d'expérience ou d'un work order, et les informations clés d'une licence ou d'une attestation de formation.

Démarrage rapide

Envoyez un fichier avec votre clé API :

curl -X POST https://dev.aerotask.wingleet.tech/v1/work-extraction \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -F "file=@livret.pdf"

La réponse arrive quand le document est entièrement traité, en général en 10 à 40 secondes selon le nombre de pages.

Authentification

Chaque requête porte votre clé API dans l'en-tête Authorization :

Authorization: Bearer atk_…

L'en-tête X-API-Key: atk_… est accepté à l'identique.

Envoyer un document

Les deux endpoints d'analyse reçoivent le fichier en multipart/form-data, dans le champ file.

Le type du fichier est déterminé par son contenu, pas par son extension. Pour de meilleurs résultats : scans à 200–300 dpi, pages droites et entières, photos nettes et bien éclairées.

Work Extraction

Pour un livret d'expérience (Part-66 logbook), un work order ou une carte de travail. Renvoie une entrée par tâche de maintenance réalisée, dans l'ordre du document.

Exemple en Python

import requests

with open("livret.pdf", "rb") as f:
    r = requests.post(
        "https://dev.aerotask.wingleet.tech/v1/work-extraction",
        headers={"Authorization": "Bearer VOTRE_CLE_API"},
        files={"file": ("livret.pdf", f, "application/pdf")},
        timeout=180,
    )
r.raise_for_status()
for task in r.json()["tasks"]:
    print(task["date"], task["ata_chapter"], task["description"])

Réponse 200

{
  "request_id": "req_2b64993f76a85c5617fc4eba",
  "document": { "type": "pdf", "pages": 2 },
  "tasks": [
    {
      "date": "05/03/2025",
      "aircraft_registration": "F-HBXA",
      "aircraft_type": "A320-214",
      "ata_chapter": "32",
      "description": "Remplacement roue principale gauche",
      "operation_type": "removal_installation",
      "duration_hours": 1.5,
      "source_page": 1
    }
  ],
  "usage": { "pages": 2 }
}

Champs d'une tâche

Une information absente ou illisible vaut null : elle n'est jamais inventée. Un document sans tâche renvoie "tasks": [].

Types d'opération

Liste fermée, alignée sur les types d'activité du livret d'expérience Part-66.

Certification

Pour une licence de maintenance, une attestation de formation, un diplôme ou un certificat. Identifie le type de document et en extrait les informations clés.

Exemple

curl -X POST https://dev.aerotask.wingleet.tech/v1/certification \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -F "file=@licence.jpg"

{
  "request_id": "req_…",
  "document": { "type": "jpeg", "pages": 1 },
  "document_type": "licence",
  "holder_name": "DUPONT Jean",
  "licence": {
    "number": "FR.66.12345",
    "categories": ["B1.1", "B2"],
    "expiry_date": "31/12/2028",
    "issuing_authority": "DGAC France"
  },
  "attestation": null,
  "usage": { "pages": 1 }
}

{
  "request_id": "req_…",
  "document": { "type": "pdf", "pages": 1 },
  "document_type": "attestation",
  "holder_name": "Marie Martin",
  "licence": null,
  "attestation": {
    "training_title": "Facteurs Humains",
    "completion_date": "14/02/2025",
    "validity_years": 2,
    "training_organisation": "Aero Formation"
  },
  "usage": { "pages": 1 }
}

Champs

licence n'est renseigné que si document_type vaut licence, attestation que s'il vaut attestation ; l'autre vaut null. Si le fichier contient plusieurs documents, le principal est décrit (la licence si elle est présente).

Consommation

Consommation du mois en cours (mois calendaire UTC) et limites de votre compte.

{
  "period_start": "2026-09-01T00:00:00+00:00",
  "calls": 128,
  "pages": 642,
  "monthly_call_limit": 5000,
  "monthly_page_limit": 20000,
  "rate_limit_per_minute": 30
}

Une limite à null signifie « sans limite ». Seules les analyses réussies sont décomptées.

Erreurs

Toutes les erreurs ont la même forme. Basez votre code sur code, qui est stable ; message peut évoluer.

{
  "error": {
    "code": "quota_exceeded",
    "message": "Quota mensuel de pages atteint.",
    "request_id": "req_5daf04cd04416947f37824da"
  }
}

Chaque réponse porte l'en-tête X-Request-ID. Communiquez-le pour toute demande de support.

Limites et bonnes pratiques

• Débit : un nombre maximal de requêtes par minute et de documents traités simultanément est fixé pour votre compte (voir GET /v1/usage). Au-delà : 429 avec un en-tête Retry-After en secondes.
• Quotas mensuels : appels et pages. Une fois atteints : 429 quota_exceeded jusqu'au 1^er du mois suivant.
• Délai : prévoyez un timeout client d'au moins 180 secondes ; un long livret peut demander plus d'une minute.
• Nouvelles tentatives : réessayez sur 429 (après Retry-After), 502 et 503, avec un délai croissant. Ne réessayez pas les autres erreurs 4xx sans corriger la requête.
• Documents longs : un fichier par document ; découpez les liasses au-delà de 50 pages.

Spécification OpenAPI

La spécification complète au format OpenAPI 3 est disponible ici : /doc/openapi.json. Elle permet de générer un client dans la plupart des langages.