Endpoint: Tipos de Produtos

Visão Geral

O endpoint de tipos de produtos permite consultar os tipos fixos de produtos disponíveis no sistema.

Base URL: https://api.imobileai.com.br/product_types

Autenticação

Requer token JWT no header:

Authorization: Bearer seu_token_jwt

Endpoints Disponíveis

1. Listar Tipos

GET /product_types

Exemplo de Resposta

{
    "success": true,
    "data": [
        {
            "id": "NOVO",
            "name": "Novo",
            "description": "Produtos novos, lacrados"
        },
        {
            "id": "SEMINOVO",
            "name": "Seminovo",
            "description": "Produtos usados em bom estado"
        },
        {
            "id": "DIVERSOS",
            "name": "Diversos",
            "description": "Acessórios e outros produtos"
        }
    ]
}

2. Listar Produtos por Tipo

GET /product_types/{type}

Parâmetros de URL

Parâmetro Tipo Descrição Valores Possíveis
type string Tipo do produto NOVO, SEMINOVO, DIVERSOS

Parâmetros de Query

Parâmetro Tipo Descrição Exemplo
store_id number Filtrar por loja (opcional) ?store_id=1
page number Número da página (padrão: 1) ?page=2
limit number Itens por página (padrão: 20) ?limit=50

Exemplo de Resposta

{
    "success": true,
    "data": {
        "type": "NOVO",
        "items": [
            {
                "id": 1,
                "store_id": 1,
                "name": "iPhone 14",
                "description": "iPhone 14 novo, lacrado",
                "price": 4999.99,
                "price_formatted": "R$ 4.999,99",
                "media": [
                    {
                        "url": "https://clientes.imobileai.com.br/uploads/products/foto1.jpg",
                        "type": "image"
                    }
                ],
                "store": {
                    "name": "Nome da Loja",
                    "whatsapp": "11999999999"
                }
            }
        ],
        "total": 50,
        "page": 1,
        "limit": 20,
        "pages": 3
    }
}

Exemplos de Uso

Listar todos os tipos

GET /product_types

Listar produtos novos

GET /product_types/NOVO

Listar produtos seminovos de uma loja

GET /product_types/SEMINOVO?store_id=1

Listar acessórios com paginação

GET /product_types/DIVERSOS?page=2&limit=10

Erros

Código Descrição
401 Token não fornecido ou inválido
403 Acesso não autorizado (token válido mas sem permissão)
404 Tipo de produto não encontrado
500 Erro interno do servidor

Observações

  • Os tipos são fixos e não podem ser alterados
  • Produtos do tipo DIVERSOS podem ter categorias
  • Usuários não SUPER_ADMIN só veem produtos de sua própria loja
  • A listagem é ordenada por data de criação (mais recentes primeiro)
  • Todos os campos de texto são retornados com encoding UTF-8

Uso no n8n

{
    "node": "HTTP Request",
    "parameters": {
        "method": "GET",
        "url": "https://api.imobileai.com.br/product_types/NOVO",
        "headers": {
            "Authorization": "Bearer {{$node['Auth'].json['access_token']}}"
        },
        "query": {
            "store_id": 1,
            "page": 1,
            "limit": 20
        }
    }
}