Endpoint: Categorias

Visão Geral

O endpoint de categorias permite gerenciar as categorias de produtos do tipo DIVERSOS.

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

Autenticação

Requer token JWT no header:

Authorization: Bearer seu_token_jwt

Endpoints Disponíveis

1. Listar Categorias

GET /categories

Parâmetros de Query

Parâmetro	Tipo	Descrição	Exemplo
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": {
        "items": [
            {
                "id": 1,
                "name": "Capas e Cases",
                "description": "Proteção para celulares",
                "created_at": "2024-03-21T10:00:00Z",
                "updated_at": "2024-03-21T10:00:00Z"
            },
            {
                "id": 2,
                "name": "Carregadores",
                "description": "Carregadores e cabos",
                "created_at": "2024-03-21T10:00:00Z",
                "updated_at": "2024-03-21T10:00:00Z"
            }
        ],
        "total": 2,
        "page": 1,
        "limit": 20,
        "pages": 1
    }
}

2. Obter Categoria Específica

GET /categories/{id}

Parâmetros de URL

Parâmetro	Tipo	Descrição
id	number	ID da categoria

Exemplo de Resposta

{
    "success": true,
    "data": {
        "id": 1,
        "name": "Capas e Cases",
        "description": "Proteção para celulares",
        "created_at": "2024-03-21T10:00:00Z",
        "updated_at": "2024-03-21T10:00:00Z"
    }
}

Exemplos de Uso

Listar todas as categorias

GET /categories

Listar categorias com paginação

GET /categories?page=2&limit=10

Obter categoria específica

GET /categories/1

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	Categoria não encontrada
500	Erro interno do servidor

Observações

As categorias são usadas apenas para produtos do tipo DIVERSOS
Usuários não SUPER_ADMIN só podem ver categorias ativas
A listagem é ordenada por nome em ordem alfabética
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/categories",
        "headers": {
            "Authorization": "Bearer {{$node['Auth'].json['access_token']}}"
        }
    }
}