Nexa Interiores Developer API & Recursos para Agentes

Bem-vindo ao portal para desenvolvedores e sistemas de inteligência artificial da Nexa Interiores. Aqui você encontra as especificações formais, endpoints REST, protocolos de negociação de conteúdo e diretrizes de chamada de ferramentas (tool/function calling) para interagir programaticamente com nosso ecossistema.

Visão Geral e Arquitetura para Agentes

A Nexa Interiores foi construída sob padrões modernos de prontidão para agentes (Agent-Ready Architecture):

Autenticação e Limites

As rotas de consulta informativa (GET /api/store-info e GET /api/collections) e solicitação de curadoria (POST /api/curation/request) são públicas e não exigem chave de API, permitindo que agentes LLM e crawlers consultem informações em tempo real.

Endpoints intensivos de processamento de IA (/api/analyze e /api/generate) são protegidos no servidor pelo motor Gemini da Nexa e possuem rate limits por IP.

Endpoints Disponíveis

GET /api/store-info

Retorna os dados cadastrais (Name, Address, Phone - NAP), horários de funcionamento e canais de contato oficiais.

Exemplo cURL:

curl -X GET "https://nexainteriores.com.br/api/store-info" \
     -H "Accept: application/json"

Exemplo de Resposta (200 OK):

{
  "name": "Nexa Interiores",
  "brand": "Mobiliário de Alto Padrão e Curadoria Gratuita",
  "address": {
    "street": "Av. Norma Valério Corrêa",
    "number": "316",
    "neighborhood": "Jardim Botânico",
    "city": "Ribeirão Preto",
    "state": "SP",
    "postalCode": "14021-614",
    "country": "Brasil"
  },
  "phone": "+5516997908686",
  "email": "contato@nexainteriores.com.br",
  "whatsappUrl": "https://wa.me/5516997908686",
  "openingHours": {
    "weekdays": "09:00 - 19:00",
    "saturday": "09:00 - 13:00",
    "sunday": "Fechado (Atendimento sob agendamento)"
  }
}

GET /api/collections

Lista as coleções em destaque e categorias de mobiliário trabalhado pela Nexa.

Exemplo cURL:

curl -X GET "https://nexainteriores.com.br/api/collections" \
     -H "Accept: application/json"

POST /api/curation/request

Registra o pedido de curadoria gratuita em nome do usuário.

Exemplo cURL:

curl -X POST "https://nexainteriores.com.br/api/curation/request" \
     -H "Content-Type: application/json" \
     -d '{
       "customerName": "Mariana Souza",
       "customerPhone": "+5516999998888",
       "city": "Ribeirão Preto",
       "roomType": "Living e Jantar Integrados"
     }'

Tratamento Padronizado de Erros (JSON Error Responses)

Todas as falhas nas rotas /api/* respondem com formato JSON previsível para facilitar a recuperação por agentes autônomos:

{
  "error": {
    "code": "NOT_FOUND",
    "message": "O endpoint GET /api/rota-inexistente não foi encontrado.",
    "hint": "Consulte a especificação OpenAPI em /openapi.json para verificar os endpoints disponíveis.",
    "status": 404
  }
}

Recursos de Especificação