openapi: 3.1.0
info:
  title: Daremeet Lieux Around API
  description: |
    Read-only endpoint returning points of interest near a Daremeet Lieux city page
    (OpenStreetMap / Overpass data). For AI agents and developers; not a full product API.
  version: 1.0.0
  contact:
    email: contact@daremeet.com
    url: https://www.daremeet.com/contact
servers:
  - url: https://www.daremeet.com
    description: Production
paths:
  /api/lieux-around:
    get:
      operationId: getLieuxAround
      summary: POIs around a Lieux city
      description: Returns cached OSM-based POI items for a known country/region/city slug.
      parameters:
        - name: country
          in: query
          required: true
          schema:
            type: string
          example: france
        - name: region
          in: query
          required: true
          schema:
            type: string
          example: nouvelle-aquitaine
        - name: city
          in: query
          required: true
          schema:
            type: string
          example: bordeaux
        - name: locale
          in: query
          required: false
          schema:
            type: string
            default: fr
          description: BCP-47 locale for labels
      responses:
        '200':
          description: POI list (may be empty)
          content:
            application/json:
              schema:
                type: object
                required:
                  - items
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
                  error:
                    type: string
                    description: Present only on soft internal errors (items still returned)
        '400':
          description: Missing required query parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: missing_params
