{
  "openapi": "3.1.0",
  "info": {
    "title": "Clean Store API",
    "version": "2.4.0",
    "description": "API HTTP do Clean Store para criação, autenticação e consulta autorizada de caixas de e-mail temporário.",
    "termsOfService": "/#terms"
  },
  "servers": [
    { "url": "/", "description": "Servidor atual" }
  ],
  "security": [
    { "ApiKey": [] }
  ],
  "paths": {
    "/api/status": {
      "get": {
        "security": [],
        "summary": "Consultar status público",
        "responses": { "200": { "description": "Serviço online" } }
      }
    },
    "/api/domains": {
      "get": {
        "summary": "Listar domínios disponíveis",
        "responses": {
          "200": { "description": "Lista de domínios" },
          "401": { "$ref": "#/components/responses/Unauthorized" }
        }
      }
    },
    "/api/keys": {
      "post": {
        "security": [],
        "summary": "Gerar chave de integração",
        "description": "A chave completa é retornada uma única vez. Guarde-a no backend do cliente.",
        "responses": {
          "201": {
            "description": "Chave gerada",
            "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiKeyCreated" } } }
          }
        }
      }
    },
    "/api/accounts": {
      "post": {
        "summary": "Criar caixa",
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountCredentials" } } } },
        "responses": {
          "201": { "description": "Caixa criada" },
          "400": { "$ref": "#/components/responses/BadRequest" },
          "401": { "$ref": "#/components/responses/Unauthorized" },
          "503": { "$ref": "#/components/responses/ProviderUnavailable" }
        }
      }
    },
    "/api/token": {
      "post": {
        "summary": "Autenticar caixa",
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AccountCredentials" } } } },
        "responses": {
          "200": { "description": "Token de sessão" },
          "401": { "$ref": "#/components/responses/Unauthorized" },
          "503": { "$ref": "#/components/responses/ProviderUnavailable" }
        }
      }
    },
    "/api/messages": {
      "get": {
        "summary": "Listar mensagens",
        "parameters": [ { "$ref": "#/components/parameters/TempEmail" } ],
        "responses": {
          "200": { "description": "Mensagens da caixa" },
          "401": { "$ref": "#/components/responses/Unauthorized" }
        }
      }
    },
    "/api/messages/{id}": {
      "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/TempEmail" } ],
      "get": {
        "summary": "Consultar mensagem",
        "responses": {
          "200": { "description": "Mensagem encontrada" },
          "401": { "$ref": "#/components/responses/Unauthorized" },
          "404": { "description": "Mensagem não encontrada" }
        }
      },
      "delete": {
        "summary": "Remover mensagem",
        "responses": {
          "204": { "description": "Mensagem removida" },
          "401": { "$ref": "#/components/responses/Unauthorized" },
          "404": { "description": "Mensagem não encontrada" }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "ApiKey": { "type": "apiKey", "in": "header", "name": "x-api-key", "description": "Chave criada por POST /api/keys." },
      "SessionToken": { "type": "http", "scheme": "bearer", "description": "Token retornado por POST /api/token." }
    },
    "parameters": {
      "TempEmail": { "name": "x-temp-email", "in": "header", "required": true, "schema": { "type": "string", "format": "email" }, "description": "Endereço da caixa consultada." }
    },
    "schemas": {
      "AccountCredentials": { "type": "object", "required": ["address", "password"], "properties": { "address": { "type": "string", "format": "email" }, "password": { "type": "string", "format": "password" } } },
      "ApiKeyCreated": { "type": "object", "required": ["key", "type", "visibleOnce"], "properties": { "key": { "type": "string", "example": "nux_..." }, "type": { "type": "string", "example": "integration_key" }, "visibleOnce": { "type": "boolean", "example": true }, "createdAt": { "type": "string", "format": "date-time" } } }
    },
    "responses": {
      "BadRequest": { "description": "Dados inválidos" },
      "Unauthorized": { "description": "Chave, token ou identificação da caixa ausente ou inválida" },
      "ProviderUnavailable": { "description": "Provedor de e-mail indisponível" }
    }
  }
}
