Informal Movelaria — Developer Portal & API Documentation

Informal Movelaria REST API v1

A Informal Movelaria disponibiliza uma API REST versionada com base URL em https://informal-movelaria.vercel.app/v1.

Principais Endpoints:

• GET /v1: Índice de status e endpoints disponíveis.
• GET /v1/company: Dados institucionais, história desde 2002, diferenciais CNC e garantia de 5 anos.
• GET /v1/showrooms: Dados completos das unidades em Poços de Caldas (MG) e Mogi Mirim (SP).
• GET /v1/ambientes: Lista de categorias de ambientes planejados sob medida.
• GET /v1/ambientes/{id}: Especificações técnicas de um ambiente específico (ex: cozinhas, closets).
• GET /v1/blog: Artigos técnicos sobre padrões de MDF, ferragens e design.
• POST /v1/quote: Envio estruturado de requisitos para orçamento com geração de protocolo.

Exemplo de Chamada REST:

curl -s https://informal-movelaria.vercel.app/v1/company

Informal Movelaria Rate Limiting Policy

Para garantir alta disponibilidade e proteção da infraestrutura, todos os endpoints públicos impõem limite de 120 requisições por minuto por endereço IP.

Todas as respostas incluem os cabeçalhos padrão IETF:

• RateLimit-Limit: 120 — Cota máxima por janela.
• RateLimit-Remaining — Requisições restantes na janela corrente.
• RateLimit-Reset — Segundos restantes até a renovação da cota.
• RateLimit-Policy: 120;w=60 — Política de limite (120 reqs por 60 segundos).

Em caso de excesso de requisições, o servidor retorna status 429 Too Many Requests com o cabeçalho Retry-After: 60 e payload RFC 9457.

Informal Movelaria Versioning & Deprecation Policy

A API da Informal Movelaria adota versionamento estrito no caminho da URL (/v1/, /v2/). Mudanças com quebra de compatibilidade (breaking changes) nunca são introduzidas na mesma versão principal.

Política de Descontinuação (Deprecation):

• Aviso Prévio Mínimo: 6 meses de antecedência antes da desativação de qualquer endpoint ou versão.
• Cabeçalhos HTTP Padrão: Respostas de rotas descontinuadas incluem o cabeçalho Deprecation: true e o cabeçalho RFC 8594 Sunset indicando a data final de desativação (ex: Sunset: Wed, 01 Sep 2027 00:00:00 GMT).

Informal Movelaria Typed Error Model (RFC 9457)

Erros 4xx e 5xx são retornados exclusivamente no formato estruturado application/problem+json, permitindo que agentes de IA processem a falha e executem autocorreção sem tentar interpretar páginas HTML.

{
  "type": "https://informal-movelaria.vercel.app/docs/errors#resource-not-found",
  "title": "Resource Not Found",
  "status": 404,
  "detail": "The requested API endpoint '/v1/unknown' does not exist.",
  "instance": "/v1/unknown",
  "code": "ERR_RESOURCE_NOT_FOUND",
  "hint": "Inspect /api/openapi.json or GET /v1 for valid resources."
}

Informal Movelaria Model Context Protocol (MCP) Server

A Informal Movelaria disponibiliza um servidor MCP em conformidade com o padrão oficial, permitindo que Claude, ChatGPT, Cursor e agentes autônomos consultem informações do catálogo, showrooms e especificações técnicas de marcenaria fina.

Endpoints:

• Handshake & Manifesto: https://informal-movelaria.vercel.app/.well-known/mcp
• Streamable HTTP Endpoint: https://informal-movelaria.vercel.app/api/mcp

Ferramentas Expostas (Tools):

• get_company_info: Histórico, estrutura fabril, equipamentos CNC e garantia de 5 anos da Informal Movelaria.
• list_showrooms: Endereços, telefones, WhatsApp e horários de funcionamento em Poços de Caldas (MG) e Mogi Mirim (SP).
• list_ambientes: Categorias de ambientes sob medida (cozinhas gourmet, closets, home theaters, corporativo).
• get_ambiente_details: Especificações técnicas de projeto, recomendações ergonômicas e materiais para o ambiente selecionado.
• search_blog: Busca em artigos técnicos sobre materiais nobres (MDF, lâminas de madeira natural), ferragens e iluminação.
• request_quote: Instruções e canal direto para solicitação de orçamento.

Informal Movelaria Content Negotiation (acceptmarkdown.com)

Qualquer requisição para a página inicial ou páginas do site com o cabeçalho Accept: text/markdown recebe o conteúdo diretamente formatado em Markdown, sem scripts nem tags HTML, acompanhado do cabeçalho de cache Vary: Accept, Accept-Encoding.

curl -s -H "Accept: text/markdown" https://informal-movelaria.vercel.app/

Informal Movelaria Autenticação e Acesso

Para entender os níveis de acesso a dados públicos e rotas administrativas:

→ Guia Completo de Autenticação (docs/auth)