{
  "openapi": "3.1.0",
  "info": {
    "title": "Tecelagem Thais — API pública do catálogo de tecidos para sinuca e bilhar",
    "summary": "Tecelagem Thais: empresa brasileira especializada na produção de tecidos para mesa de sinuca e bilhar desde 1962. Qualidade, excelência e fabricação 100% nacional. Linhas THB para locação, uso profissional e residencial.",
    "description": "## Quem somos\n\nA Tecelagem Thais é uma empresa brasileira especializada na produção de tecidos para mesa de sinuca e mesa de bilhar. Desde 1962, fabricamos no Brasil o pano de jogo — o tecido que reveste a superfície da mesa —, com foco em qualidade, excelência de acabamento e desempenho consistente no uso comercial e residencial.\n\nNão produzimos tecido para vestuário. Nosso ofício é o tecido para sinuca (também buscado como tecido pra sinuca), o tecido para bilhar e o pano de bilhar de fabricação própria. Cada artigo da linha THB é desenvolvido para a mesa: resistência, estabilidade dimensional, variedade de cores e larguras que atendem locadoras, lojas de bilhar, mesas profissionais e mesas de casa.\n\nSomos 100% brasileiros: fabricação própria, produto nacional e mais de seis décadas de tradição. A excelência que buscamos aparece na regularidade do tecido, na durabilidade em operação contínua e no suporte a quem instala, vende ou joga. O catálogo reúne linhas para locação de alto giro, uso profissional e uso residencial, em composições de lã, acrílico e poliéster.\n\nProduzir no Brasil tecidos para mesa de sinuca e de bilhar com qualidade industrial e excelência de acabamento, oferecendo às locadoras, ao comércio especializado e ao jogador residencial um pano de jogo confiável, 100% nacional e com identidade própria da marca THB.\n\nA Tecelagem Thais não é uma marca de tecido para roupa, decoração genérica ou confecção. Quem busca “tecido pra sinuca”, pano de sinuca, feltro de sinuca ou pano de bilhar está no lugar certo: fabricamos exclusivamente o revestimento da mesa de jogo.\n\n## Como usar esta especificação (navegação agêntica)\n\nEsta OpenAPI descreve o **catálogo público de leitura** da Tecelagem Thais. Não exige autenticação. Serve para agentes, assistentes e integradores consultarem tecidos para mesa de sinuca e de bilhar (pano de jogo, linha THB).\n\n1. **Entender a empresa:** leia este campo `info.description` e o JSON-LD em https://catalogo.tecelagemthais.com/json-ld.json.\n2. **Listar o catálogo em JSON:** `GET https://painel.tecelagemthais.com/backend/public/api/catalogo/produtos` — produtos ativos agrupados por segmento.\n3. **Detalhe de um artigo:** `GET https://painel.tecelagemthais.com/backend/public/api/catalogo/produtos/{id}`.\n4. **Versão humana/indexável:** https://catalogo.tecelagemthais.com/tecidos e https://catalogo.tecelagemthais.com/sobre.\n5. **Contato comercial:** WhatsApp +55 11 99457-9532 — https://wa.me/5511994579532.\n\nImagens de variação vêm como caminhos relativos (`/uploads/variacoes/...`). A URL absoluta é `https://painel.tecelagemthais.com/backend/public` + caminho. Use `url_medium` (~600 px) em listagens, `url_thumb` (~200 px) em amostras de cor e `url_full` apenas no detalhe/zoom.\n\nFiltros opcionais na listagem: `nome_produto`, `id_linha`, `id_cor`, `id_material`, `id_artigo`, `id_categoria`, `id_segmento`, `id_sessao`.\n\n## Palavras-chave\n\nTecelagem Thais, Tecelagem Thaís, tecido para sinuca, tecido pra sinuca, tecido para bilhar, tecido pra bilhar, pano de bilhar, pano de sinuca, tecido de mesa de sinuca, tecido de mesa de bilhar, feltro de sinuca, tecido nacional para bilhar, tecido 100% brasileiro, fábrica de tecido para sinuca, THB, linha THB\n\n## Fundada em\n\n1962 (comunicação oficial do catálogo: “Desde 1962 · Fabricação própria · 100% nacional”).\n\n\nArtigos THB neste build: THB 303, THB 303 K, THB 303 LM, THB 303 T, THB 303 XP, THB 303 YE, THB 304, THB 304 K, THB 304 LM, THB 304 T, THB 304 XP, THB 304 YE, THB 308, THB 373, THB 374, THB 503, THB 504, THB 101, THB 106, THB 109, THB 202, THB 277, THB 302, THB 756, THB 324.",
    "version": "1.0.0",
    "termsOfService": "https://catalogo.tecelagemthais.com/sobre",
    "contact": {
      "name": "Tecelagem Thais — Vendas",
      "url": "https://wa.me/5511994579532"
    },
    "license": {
      "name": "Uso do catálogo público (somente leitura)",
      "url": "https://catalogo.tecelagemthais.com"
    }
  },
  "servers": [
    {
      "url": "https://painel.tecelagemthais.com/backend/public",
      "description": "API JSON pública (painel). Somente GET, sem autenticação."
    },
    {
      "url": "https://catalogo.tecelagemthais.com",
      "description": "Site estático do catálogo (HTML, llms.txt, JSON-LD, esta OpenAPI)."
    }
  ],
  "tags": [
    {
      "name": "Empresa",
      "description": "Recursos para um agente entender quem é a Tecelagem Thais: especialidade em tecido para mesa de sinuca, qualidade, excelência e origem 100% brasileira desde 1962."
    },
    {
      "name": "Catálogo",
      "description": "Leitura do catálogo THB: segmentos, produtos, composições, larguras, cores e URLs de imagem."
    }
  ],
  "externalDocs": {
    "description": "Catálogo visual e institucional — O tecido certo para cada mesa.",
    "url": "https://catalogo.tecelagemthais.com"
  },
  "paths": {
    "/openapi.json": {
      "servers": [
        {
          "url": "https://catalogo.tecelagemthais.com"
        }
      ],
      "get": {
        "tags": [
          "Empresa"
        ],
        "operationId": "getOpenApi",
        "summary": "Esta especificação OpenAPI",
        "description": "Contrato machine-readable da API pública e da empresa.",
        "responses": {
          "200": {
            "description": "Documento OpenAPI 3.1",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/json-ld.json": {
      "servers": [
        {
          "url": "https://catalogo.tecelagemthais.com"
        }
      ],
      "get": {
        "tags": [
          "Empresa"
        ],
        "operationId": "getJsonLd",
        "summary": "Grafo JSON-LD Schema.org",
        "description": "Organization, Manufacturer, Brand, WebSite, AboutPage, OfferCatalog/ItemList de produtos THB e FAQPage.",
        "responses": {
          "200": {
            "description": "Grafo @context schema.org",
            "content": {
              "application/ld+json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/llms.txt": {
      "servers": [
        {
          "url": "https://catalogo.tecelagemthais.com"
        }
      ],
      "get": {
        "tags": [
          "Empresa"
        ],
        "operationId": "getLlmsTxt",
        "summary": "Resumo em texto para LLMs",
        "responses": {
          "200": {
            "description": "text/plain",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/llms-full.txt": {
      "servers": [
        {
          "url": "https://catalogo.tecelagemthais.com"
        }
      ],
      "get": {
        "tags": [
          "Empresa"
        ],
        "operationId": "getLlmsFullTxt",
        "summary": "Catálogo completo em texto",
        "responses": {
          "200": {
            "description": "text/plain com todos os artigos",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/sobre": {
      "servers": [
        {
          "url": "https://catalogo.tecelagemthais.com"
        }
      ],
      "get": {
        "tags": [
          "Empresa"
        ],
        "operationId": "getSobreHtml",
        "summary": "Página institucional (HTML)",
        "responses": {
          "200": {
            "description": "HTML com história, especialidade e FAQ"
          }
        }
      }
    },
    "/tecidos": {
      "servers": [
        {
          "url": "https://catalogo.tecelagemthais.com"
        }
      ],
      "get": {
        "tags": [
          "Catálogo"
        ],
        "operationId": "getTecidosHtml",
        "summary": "Lista HTML indexável de todos os tecidos",
        "responses": {
          "200": {
            "description": "HTML com artigos, composição, largura e cores"
          }
        }
      }
    },
    "/api/catalogo/produtos": {
      "servers": [
        {
          "url": "https://painel.tecelagemthais.com/backend/public"
        }
      ],
      "get": {
        "tags": [
          "Catálogo"
        ],
        "operationId": "listarCatalogoPublico",
        "summary": "Listar catálogo público agrupado por segmento",
        "description": "Retorna somente produtos ativos. Cada item em `data` é um segmento (locação, profissional, residencial etc.) com seus tecidos THB, variações de cor e URLs de imagem (full / medium ~600 / thumb ~200).",
        "parameters": [
          {
            "name": "nome_produto",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filtro por nome do artigo (LIKE)."
          },
          {
            "name": "id_linha",
            "in": "query",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "id_cor",
            "in": "query",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "id_material",
            "in": "query",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "id_artigo",
            "in": "query",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "id_categoria",
            "in": "query",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "id_segmento",
            "in": "query",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "id_sessao",
            "in": "query",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Catálogo agrupado por segmento",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CatalogoResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/catalogo/produtos/{id}": {
      "servers": [
        {
          "url": "https://painel.tecelagemthais.com/backend/public"
        }
      ],
      "get": {
        "tags": [
          "Catálogo"
        ],
        "operationId": "obterProdutoPublico",
        "summary": "Obter um produto ativo do catálogo",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "ID interno do produto (ex.: 30 = THB 303)."
          }
        ],
        "responses": {
          "200": {
            "description": "Produto com segmentos, públicos-alvo e variações",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProdutoDetalheResponse"
                }
              }
            }
          },
          "404": {
            "description": "Produto inexistente ou inativo",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Erro"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Erro": {
        "type": "object",
        "properties": {
          "error": {
            "type": "string"
          }
        }
      },
      "CatalogoResponse": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Segmento"
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "total_segmentos": {
                "type": "integer"
              },
              "total_produtos": {
                "type": "integer"
              }
            }
          }
        }
      },
      "ProdutoDetalheResponse": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/Produto"
          }
        }
      },
      "Segmento": {
        "type": "object",
        "description": "Agrupamento comercial (ex.: tecidos para locação).",
        "properties": {
          "id": {
            "type": [
              "integer",
              "null"
            ]
          },
          "nome": {
            "type": "string"
          },
          "descricao": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": [
              "string",
              "null"
            ],
            "description": "Imagem do segmento, relativa a /uploads/segmentos/."
          },
          "produtos": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Produto"
            }
          }
        }
      },
      "Produto": {
        "type": "object",
        "description": "Artigo THB — tecido para mesa de sinuca/bilhar da Tecelagem Thais.",
        "properties": {
          "id": {
            "type": "integer"
          },
          "nome_produto": {
            "type": "string",
            "examples": [
              "THB 303"
            ]
          },
          "descricao": {
            "type": [
              "string",
              "null"
            ]
          },
          "linha": {
            "$ref": "#/components/schemas/Linha"
          },
          "artigo": {
            "$ref": "#/components/schemas/Artigo"
          },
          "categoria": {
            "$ref": "#/components/schemas/Categoria"
          },
          "material": {
            "$ref": "#/components/schemas/Material"
          },
          "medida": {
            "$ref": "#/components/schemas/Medida"
          },
          "variacoes_tecido": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Variacao"
            }
          },
          "imagem_principal": {
            "type": [
              "object",
              "null"
            ]
          }
        }
      },
      "Linha": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer"
          },
          "nome": {
            "type": "string"
          },
          "headline": {
            "type": [
              "string",
              "null"
            ]
          },
          "descricao": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      },
      "Artigo": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer"
          },
          "nome": {
            "type": "string"
          },
          "descricao": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      },
      "Categoria": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer"
          },
          "nome": {
            "type": "string"
          },
          "descricao": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      },
      "Material": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer"
          },
          "nome": {
            "type": "string"
          },
          "codigo": {
            "type": [
              "string",
              "null"
            ]
          },
          "composicao": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      },
      "Medida": {
        "type": "object",
        "description": "Largura do tecido em metros (valor numérico em string, ex.: \"1.85\").",
        "properties": {
          "id": {
            "type": "integer"
          },
          "valor": {
            "type": "string"
          },
          "codigo": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      },
      "Variacao": {
        "type": "object",
        "description": "Cor do tecido com três tamanhos de imagem AVIF.",
        "properties": {
          "id": {
            "type": "integer"
          },
          "nome_cor": {
            "type": "string"
          },
          "ordem": {
            "type": "integer"
          },
          "url": {
            "type": "string",
            "description": "Compat: em geral o full."
          },
          "url_full": {
            "type": "string",
            "description": "AVIF original (zoom)."
          },
          "url_medium": {
            "type": "string",
            "description": "AVIF ~600 px (card)."
          },
          "url_thumb": {
            "type": "string",
            "description": "AVIF ~200 px (bolinha)."
          }
        }
      }
    }
  }
}