# Contratto pubblico di {{PROGETTO}} — FONTE DI VERITÀ (D-002).
# Si modifica PRIMA del codice. Ogni operazione cita la spec che la definisce.
openapi: 3.1.0
info:
  title: "{{PROGETTO}} API"
  version: 0.1.0
  description: |
    Contratto dell'API di {{PROGETTO}}.
    Documentazione redatta con il metodo spec-driven di STS Lab Srl.
servers:
  - url: /api/v1
tags:
  - name: health
    description: Stato del servizio
paths:
  /health:
    get:
      tags: [health]
      summary: Stato del servizio
      security: []
      responses:
        "200":
          description: Servizio attivo
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: ok
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
  schemas:
    Error:
      type: object
      required: [error]
      properties:
        error:
          type: object
          required: [code, message]
          properties:
            code:
              type: string
            message:
              type: string
            details:
              type: object
security:
  - BearerAuth: []