overlay: 1.0.0
info:
  title: API Evangelist enhancements for La Poste Open Data
  version: 1.0.0
x-generated: '2026-09-02'
x-method: generated
x-source: openapi/la-poste-groupe-open-data-openapi.json
x-note: >-
  Applies to openapi/la-poste-groupe-open-data-openapi.json - the OpenAPI 3.1.0 that
  the Data Fair instance at data.laposte.fr serves at
  /data-fair/api/v1/api-docs.json. The document is generated by the Data Fair
  software and its info block describes the SOFTWARE ("API Data Fair"), not the
  deployment. The overlay attributes the deployment to La Poste and records the
  discovery surface the instance serves but never links to.
x-extends: openapi/la-poste-groupe-open-data-openapi.json
actions:
- target: $.info
  description: >-
    info.title is the upstream software's name. Attribute the running instance to
    La Poste Groupe and add the published contact.
  update:
    x-operated-by: La Poste Groupe
    x-software: Data Fair (open source, Koumoul) - self-hosted at data.laposte.fr
    contact:
      name: La Poste Open Data
      email: data.laposte@laposte.fr
      url: https://data.laposte.fr/
    x-gateway-alias: >-
      The same datasets are also fronted through the Okapi gateway at
      https://api.laposte.fr/opendata/v1 with named aliases (/codespostaux,
      /pointscontact, /horairesbureaux, /servicesbureaux, /accessibilitebureaux,
      /automatesbureaux, /boitesrue, /communesnouvelles), which requires an
      X-Okapi-Key. The data.laposte.fr surface documented here is the direct one.
- target: $
  description: >-
    Record the RFC 9727 API catalog this host serves. It is the single most useful
    discovery artifact in the whole La Poste estate and nothing on
    developer.laposte.fr points at it.
  update:
    x-api-catalog:
      url: https://data.laposte.fr/.well-known/api-catalog
      standard: RFC 9727
      anchors: 21
      verified: '2026-09-02'
- target: $
  description: >-
    Record the semantic vocabulary endpoint, which maps this instance's concepts to
    schema.org and RDF Schema identifiers.
  update:
    x-vocabulary:
      url: https://data.laposte.fr/data-fair/api/v1/vocabulary
      vocabularies: [schema.org, RDF Schema]
      verified: '2026-09-02'