{
  "name": "SPOSI Public API",
  "version": "1.0.0",
  "description": "API pública, somente leitura e sem autenticação da SPOSI — plataforma brasileira de gestão de casamento. Expõe fornecedores do marketplace, categorias, blog, glossário, planos e números agregados da plataforma.",
  "documentation_url": "https://sposi.com.br/desenvolvedores",
  "openapi_url": "https://sposi.com.br/openapi.json",
  "openapi_yaml_url": "https://sposi.com.br/api/openapi.yaml",
  "llms_txt_url": "https://sposi.com.br/llms.txt",
  "versioning_policy_url": "https://sposi.com.br/desenvolvedores#versionamento",
  "rate_limit": {
    "requests": 120,
    "window_seconds": 60,
    "scope": "ip"
  },
  "endpoints": [
    {
      "operation_id": "getApiIndex",
      "method": "GET",
      "path": "/api/v1",
      "url": "https://sposi.com.br/api/v1",
      "description": "Índice de descoberta da API"
    },
    {
      "operation_id": "getApiHealth",
      "method": "GET",
      "path": "/api/v1/health",
      "url": "https://sposi.com.br/api/v1/health",
      "description": "Verificar disponibilidade da API"
    },
    {
      "operation_id": "listSupplierCategories",
      "method": "GET",
      "path": "/api/v1/categories",
      "url": "https://sposi.com.br/api/v1/categories",
      "description": "Listar categorias de fornecedores"
    },
    {
      "operation_id": "listSuppliers",
      "method": "GET",
      "path": "/api/v1/suppliers",
      "url": "https://sposi.com.br/api/v1/suppliers",
      "description": "Listar fornecedores de casamento"
    },
    {
      "operation_id": "getSupplierBySlug",
      "method": "GET",
      "path": "/api/v1/suppliers/{slug}",
      "url": "https://sposi.com.br/api/v1/suppliers/{slug}",
      "description": "Obter um fornecedor pelo slug"
    },
    {
      "operation_id": "listBlogPosts",
      "method": "GET",
      "path": "/api/v1/posts",
      "url": "https://sposi.com.br/api/v1/posts",
      "description": "Listar posts publicados do blog"
    },
    {
      "operation_id": "getBlogPostBySlug",
      "method": "GET",
      "path": "/api/v1/posts/{slug}",
      "url": "https://sposi.com.br/api/v1/posts/{slug}",
      "description": "Obter um post do blog pelo slug"
    },
    {
      "operation_id": "listGlossaryTerms",
      "method": "GET",
      "path": "/api/v1/glossary",
      "url": "https://sposi.com.br/api/v1/glossary",
      "description": "Listar termos do glossário de casamento"
    },
    {
      "operation_id": "listPlans",
      "method": "GET",
      "path": "/api/v1/plans",
      "url": "https://sposi.com.br/api/v1/plans",
      "description": "Listar planos ativos da plataforma"
    },
    {
      "operation_id": "getPlatformStats",
      "method": "GET",
      "path": "/api/v1/stats",
      "url": "https://sposi.com.br/api/v1/stats",
      "description": "Obter números públicos da plataforma"
    }
  ]
}