Référence API

L’API V1 expose des ressources géographiques, des aérodromes, des services de transport et une recherche unifiée.

Base URLhttps://api-fenua-api.pacificknowledge.dev/api/v1

SpécificationOpenAPI JSON Swagger UI

Contrat API v1 · DATA 2026.2 · vérifié le 27 août 2026 · maintenu par Pacific Knowledge.

Endpoints

Métadonnées

GET/meta

Décrire les versions API et DATA actives

Géographie

GET/islands

Lister les îles et atolls

GET/islands/{idOrSlug}

Récupérer une île

GET/communes

Lister les communes

GET/communes/{idOrSlug}

Récupérer une commune

Aviation

GET/airports

Lister les aérodromes publics

GET/airports/{id}

Récupérer un aérodrome

GET/air-services

Lister les services aériens publiés

GET/islands/{idOrSlug}/air-services

Lister les dessertes aériennes d’une île

Maritime

GET/maritime-services

Lister les services maritimes publiés

GET/islands/{idOrSlug}/maritime-services

Lister les dessertes maritimes d’une île

Recherche

GET/places/search

Rechercher des lieux

GET/places/autocomplete

Autocompléter un nom de lieu

Réponses par endpoint

Chaque fiche montre une réponse complète et uniquement les erreurs possibles pour cette opération. Les exemples de transport inactif utilisent explicitement active=false.

GET/metaVersions, état et attributions du référentiel actif.

Paramètres

Aucun paramètre.

Erreurs possibles

401 429 500

Réponse200

{
  "data": {
    "apiVersion": "v1",
    "dataVersion": "2026.2",
    "dataUpdatedAt": "2026-08-27T00:00:00-10:00",
    "status": "operational",
    "attribution": [
      "Institut de la statistique de la Polynésie française (ODbL 1.0)",
      "OurAirports (Public Domain)"
    ]
  }
}

GET/islandsListe complète des îles et atolls.

Paramètres

Aucun paramètre.

Erreurs possibles

401 429 500

Réponse200

{
  "data": [
    {
      "id": "isl_031",
      "slug": "huahine",
      "name": "Huahine",
      "aliases": [],
      "kind": "ISLAND",
      "archipelago": "Îles Sous-le-Vent",
      "latitude": null,
      "longitude": null,
      "communeIds": [
        "com_24"
      ],
      "sourceRefs": [
        "src_ispf_admin_2022"
      ]
    }
  ],
  "meta": {
    "count": 1
  }
}

GET/islands/{idOrSlug}Identifiant stable ou slug, par exemple huahine.

Paramètres

idOrSlug · path · string · required

Erreurs possibles

400 401 404 429 500

Réponse200

{
  "data": {
    "id": "isl_031",
    "slug": "huahine",
    "name": "Huahine",
    "aliases": [],
    "kind": "ISLAND",
    "archipelago": "Îles Sous-le-Vent",
    "latitude": null,
    "longitude": null,
    "communeIds": [
      "com_24"
    ],
    "sourceRefs": [
      "src_ispf_admin_2022"
    ]
  }
}

GET/islands/{idOrSlug}/air-servicesDessertes aériennes actives qui touchent l’île. Une liste vide est valide.

Paramètres

idOrSlug · path · string · required

Erreurs possibles

400 401 404 429 500

Réponse200

{
  "data": [],
  "meta": {
    "count": 0
  }
}

GET/islands/{idOrSlug}/maritime-servicesDessertes maritimes actives qui appellent l’île. Une liste vide est valide.

Paramètres

idOrSlug · path · string · required

Erreurs possibles

400 401 404 429 500

Réponse200

{
  "data": [],
  "meta": {
    "count": 0
  }
}

GET/communesCommunes et communes associées, filtrables par île.

Paramètres

island · query · string · optional

Erreurs possibles

400 401 429 500

Réponse200

{
  "data": [
    {
      "id": "com_35",
      "officialId": "35",
      "slug": "papeete",
      "name": "Papeete",
      "aliases": [],
      "kind": "COMMUNE",
      "parentCommuneId": null,
      "islandIds": [
        "isl_090"
      ],
      "latitude": null,
      "longitude": null,
      "sourceRefs": [
        "src_ispf_admin_2022"
      ]
    }
  ],
  "meta": {
    "count": 1
  }
}

GET/communes/{idOrSlug}Commune par identifiant stable ou slug.

Paramètres

idOrSlug · path · string · required

Erreurs possibles

400 401 404 429 500

Réponse200

{
  "data": {
    "id": "com_35",
    "officialId": "35",
    "slug": "papeete",
    "name": "Papeete",
    "aliases": [],
    "kind": "COMMUNE",
    "parentCommuneId": null,
    "islandIds": [
      "isl_090"
    ],
    "latitude": null,
    "longitude": null,
    "sourceRefs": [
      "src_ispf_admin_2022"
    ]
  }
}

GET/airportsAérodromes filtrables par île, code IATA et état.

Paramètres

island · query · string · optional
iata · query · string(3) · optional
active · query · true|false · optional

Erreurs possibles

400 401 429 500

Réponse200

{
  "data": [
    {
      "id": "apt_ntaa",
      "name": "Fa'a'ā International Airport",
      "aliases": [
        "Papeete"
      ],
      "iataCode": "PPT",
      "icaoCode": "NTAA",
      "islandId": "isl_090",
      "latitude": -17.553472,
      "longitude": -149.606936,
      "active": true,
      "sourceRefs": [
        "src_dac_airports_2025",
        "src_ourairports_2026_08_26"
      ]
    }
  ],
  "meta": {
    "count": 1
  }
}

GET/airports/{id}Aérodrome par ID, code IATA ou code OACI.

Paramètres

id · path · string · required

Erreurs possibles

400 401 404 429 500

Réponse200

{
  "data": {
    "id": "apt_ntaa",
    "name": "Fa'a'ā International Airport",
    "aliases": [
      "Papeete"
    ],
    "iataCode": "PPT",
    "icaoCode": "NTAA",
    "islandId": "isl_090",
    "latitude": -17.553472,
    "longitude": -149.606936,
    "active": true,
    "sourceRefs": [
      "src_dac_airports_2025",
      "src_ourairports_2026_08_26"
    ]
  }
}

GET/air-services?active=falseDessertes directionnelles. active=true par défaut ; les données publiées sont historiques.

Paramètres

island · airline · origin · destination · airport · query · optional
active · query · true|false · optional (default true)

Erreurs possibles

400 401 429 500

Réponse200

{
  "data": [
    {
      "id": "air_2014_vt_ahe_ppt",
      "airlineId": "aln_air_tahiti",
      "originAirportId": "apt_nthe",
      "destinationAirportId": "apt_ntaa",
      "active": false,
      "validFrom": null,
      "validUntil": "2014-06-30",
      "sourceRefs": [
        "src_openflights_routes_2014"
      ]
    }
  ],
  "meta": {
    "count": 1
  }
}

GET/maritime-services?active=falseLignes maritimes candidates, filtrables par île, opérateur, origine, destination et type.

Paramètres

island · operator · origin · destination · query · optional
serviceType · query · PASSENGERS|FREIGHT|MIXED|UNKNOWN
active · query · true|false · optional (default true)

Erreurs possibles

400 401 429 500

Réponse200

{
  "data": [
    {
      "id": "mar_tuhaa_pae_iv_candidate",
      "operatorId": "mop_navigation_australes",
      "name": "Tuhaa Pae IV — réseau candidat",
      "serviceType": "UNKNOWN",
      "active": false,
      "validFrom": "2026-08-27",
      "validUntil": null,
      "stops": [
        {
          "islandId": "isl_090",
          "stopOrder": 1,
          "role": "ORIGIN"
        },
        {
          "islandId": "isl_077",
          "stopOrder": 6,
          "role": "TERMINUS"
        }
      ],
      "sourceRefs": [
        "src_osm_tuhaa_pae_2026_08_27"
      ]
    }
  ],
  "meta": {
    "count": 1
  }
}

GET/places/search?q=huahine&limit=10Recherche déterministe sur les noms, alias et codes.

Paramètres

q · query · string · required
types · query · island,commune,associated_commune,airport
limit · query · integer 1–50 · default 10

Erreurs possibles

400 401 429 500

Réponse200

{
  "data": [
    {
      "id": "isl_031",
      "slug": "huahine",
      "name": "Huahine",
      "type": "island",
      "subtitle": "Îles Sous-le-Vent",
      "codes": []
    }
  ],
  "meta": {
    "count": 1
  }
}

GET/places/autocomplete?q=hua&limit=10Suggestions compactes prêtes à afficher.

Paramètres

q · query · string · required
types · query · island,commune,associated_commune,airport
limit · query · integer 1–50 · default 10

Erreurs possibles

400 401 429 500

Réponse200

{
  "data": [
    {
      "id": "isl_031",
      "slug": "huahine",
      "name": "Huahine",
      "type": "island",
      "subtitle": "Îles Sous-le-Vent",
      "codes": []
    }
  ],
  "meta": {
    "count": 1
  }
}

Sans filtre, ces endpoints ne retournent que les services actifs — aucun à ce jour. Utilisez active=false pour étudier les candidats datés avec leur provenance ; ne les présentez pas comme des horaires actuels.

Consulter l’état du service