CultureLib Discover API enhancements (API Evangelist)

overlay: 1.0.0
info:
  title: CultureLib Discover API enhancements (API Evangelist)
  version: '2026-11-04'
  x-provenance:
    method: derived
    generated: '2026-11-04'
    source:
    - https://www.culturelib.fr/llms.txt
    - https://www.culturelib.fr/developers
extends: ../openapi/_ae-authored/culturelib-fr-openapi-generated.yml
actions:
- target: $
  description: Add the documented base server.
  update:
    servers:
    - url: https://www.culturelib.fr
      description: Production (documented; REST v1 under /api/v1, no key, 60 requests/min/IP)
- target: $.info
  update:
    x-rate-limit:
      limit: 60
      window: 1 minute
      scope: ip
      source: https://www.culturelib.fr/developers
    x-authentication: none (documented as keyless, read-only)
    x-mcp-server: https://www.culturelib.fr/api/mcp/mcp
- target: $.paths['/api/v1/shows'].get
  description: Summary and the full query parameter set documented in llms.txt (GET /api/v1/shows?q=&category=&city=&price_max=&cursor=).
  update:
    summary: List and search shows
    description: Noise-tolerant title search over the CultureLib Discover catalogue with cursor pagination. Responses carry source licence attributions to display, and prices are timestamped (last_seen_at); check /api/v1/meta data_freshness before relying on prices.
    parameters:
    - name: category
      in: query
      required: false
      schema:
        type: string
    - name: city
      in: query
      required: false
      schema:
        type: string
    - name: price_max
      in: query
      required: false
      schema:
        type: number
    - name: cursor
      in: query
      required: false
      description: Pagination cursor
      schema:
        type: string
- target: $.paths
  description: Add the two read endpoints documented in llms.txt but absent from the generated contract.
  update:
    /api/v1/shows/{slug}:
      get:
        operationId: get_api_v1_shows_slug
        summary: Show detail
        description: Multi-reseller offers sorted by price, upcoming sessions, canonical venue.
        x-source: https://www.culturelib.fr/llms.txt
        parameters:
        - name: slug
          in: path
          required: true
          schema:
            type: string
        responses:
          '200':
            description: Success (as documented)
    /api/v1/meta:
      get:
        operationId: get_api_v1_meta
        summary: Catalogue metadata and data freshness
        description: Counters, covered resellers and data_freshness.
        x-source: https://www.culturelib.fr/llms.txt
        responses:
          '200':
            description: Success (as documented)