API help

Connecte TailTracker à tes scripts / apps (JSON, Bearer token).

Authentification

Ajoute ce header à chaque requête :

Authorization: Bearer YOUR_API_KEY

Exemple rapide

curl -H "Authorization: Bearer YOUR_API_KEY" \
https://tailtracker.app/api/planes

Endpoints

GET /api Health check

GET /api/me Infos user

GET /api/planes Ta collection

GET /api/stats Retourne le nombre d'entrées et leur type (à bord, spotted, vu)

GET /api/insights Retourne des statistiques avancées et des insights intelligents sur la collection de l’utilisateur connecté.

GET /api/planes/lookup?tail=XX-XXX Retourne le tail au format sans tiret, l'opérateur, la photo de l'avion et si l'avion est dans la collection de l'utilisateur.

Format de réponse (exemple)

{
  "planes": [
    {
      "id": 123,
      "tail_number": "HB-JVJ",
      "tag": "on board",
      "flight_number": "SWR1069",
      "destination": "ZRH",
      "flight_date": "2025-07-06",
      "operator": "Helvetic Airways",
      "image_url": "/uploads/xxxx.jpg"
    }
  ]
}

Erreurs fréquentes

missing_api_key → il manque le header Authorization.
invalid_api_key → token faux / révoqué.
rate_limited → trop de requêtes (attends un peu).

Tip : garde ta clé secrète. Si tu la leaks, régénère-la.