openapi: "3.1.0"
info:
  title: "KoriFlow Platform"
  version: "1.0.0"
  description: "KoriFlow est la plateforme d'infrastructure e-commerce tout-en-un pour l'Afrique francophone. KoriFlow n'expose pas d'API REST publique pour les tiers : toutes les opérations s'effectuent via les boutiques en ligne et le tableau de bord vendeur."
  contact:
    name: Support KoriFlow
    url: https://koriflow.com/developers
    email: support@koriflow.com
  license:
    name: Proprietary
    url: https://koriflow.com/cgu
servers:
  - url: https://koriflow.com
    description: Serveur de production KoriFlow
paths:
  /api/sante:
    get:
      summary: Vérification de l'état de la plateforme (Healthcheck)
      description: Contrôle la connectivité à la base de données et la disponibilité générale du service KoriFlow.
      operationId: verifierSante
      responses:
        200:
          description: Service opérationnel
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    example: true
                required:
                  - ok
        503:
          description: Service temporairement indisponible
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          example: false
        error:
          type: object
          properties:
            code:
              type: string
              example: SERVICE_UNAVAILABLE
            message:
              type: string
              example: Database or service unavailable.
            hint:
              type: string
              example: "Please try again later or check https://koriflow.com."
          required:
            - code
            - message
      required:
        - error