openapi: "3.0.0"
info:
  version: 1.0.0
  title: Jours fériés en France
servers:
  - url: https://calendrier.api.gouv.fr/jours-feries/
paths:
  /{zone}.json:
    get:
      summary: Liste les jours fériés pour une zone, 20 ans dans le passé et 5 ans dans le futur
      parameters:
        - name: zone
          in: path
          description: Le nom de la zone
          required: true
          example: metropole
          schema:
            $ref: '#/components/schemas/Zone'
      responses:
        '200':
          description: Les jours fériés
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Dates"
  /{zone}/{annee}.json:
    get:
      summary: Liste les jours fériés pour une zone, pour une année
      parameters:
        - name: zone
          in: path
          description: Le nom de la zone
          required: true
          example: metropole
          schema:
            $ref: '#/components/schemas/Zone'
        - name: annee
          in: path
          description: L'année pour les jours fériés
          required: true
          example: 2025
          schema:
            type: integer
            example: 2025
      responses:
        '200':
          description: Les jours fériés
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Dates"
components:
  schemas:
    Dates:
      description: Les dates et noms des jours fériés. Les clés sont les dates en ISO 8601, les valeurs sont les noms des jours fériés.
      type: object
      additionalProperties:
        type: string
      example:
        "2025-01-01": "1er janvier"
        "2025-04-21": "Lundi de Pâques"
        "2025-05-01": "1er mai"
        "2025-05-08": "8 mai"
        "2025-05-29": "Ascension"
        "2025-06-09": "Lundi de Pentecôte"
        "2025-07-14": "14 juillet"
        "2025-08-15": "Assomption"
        "2025-11-01": "Toussaint"
        "2025-11-11": "11 novembre"
        "2025-12-25": "Jour de Noël"
    Zone:
      type: string
      description: Nom des zones reconnues
      example: metropole
      enum:
        - alsace-moselle
        - guadeloupe
        - guyane
        - la-reunion
        - martinique
        - mayotte
        - metropole
        - nouvelle-caledonie
        - polynesie-francaise
        - saint-barthelemy
        - saint-martin
        - saint-pierre-et-miquelon
        - wallis-et-futuna