Fora do painel / camada operacional externa

Auditoria técnica da pasta /api

Esta página mapeia a estrutura real da API interna do BarberBot a partir do barberbot.zip. O objetivo é mostrar para o próximo dev quais subdiretórios existem, quais arquivos vivem em cada um, que parâmetros entram e onde a manutenção costuma acontecer.

foco em /api 17 subdiretórios 44 arquivos PHP app / integrações / listagens

44

Arquivos PHP em /api

17

Subdiretórios funcionais

2 PHP + 1 .htaccess

Arquivos na raiz

5

Endpoints com JSON explícito

Como ler a pasta /api

No BarberBot, /api funciona como uma camada de integração voltada a app, painel mobile e fluxos externos. Ela não é uma API REST padronizada do começo ao fim. Há endpoints que retornam JSON puro e outros que devolvem HTML ou texto já formatado.

O que o dev deve procurar primeiro

Comece pelo subdiretório do domínio de negócio. Ex.: /api/vendas, /api/compras, /api/agenda ou /api/login. Depois confira salvar.php, listar.php, arquivos de baixa e uploads.

O que costuma quebrar

Contrato de retorno inconsistente, filtros por data com SQL interpolado, dependência de imagens/URL base e arquivos auxiliares como listarPgto.php, listarProd.php e listarClientes.php.

Índice dos subdiretórios

Use este índice para navegar por domínio dentro da API.

api

Arquivos de notificação/diagnóstico na raiz.

2 arquivo(s)

api/not.php

JSON

api/notid.php

JSON

api/agenda

Agenda mobile e listagens de horários/serviços/funcionários.

6 arquivo(s)

api/agenda/baixar.php

Sem parâmetros explícitos detectados por leitura estática.

api/agenda/listar-horarios.php

POST: dataInicial, id_usuario • Tabelas: agendamentos, dias, horarios

api/agenda/listar.php

POST: dataInicial, id_usuario, url_img • Tabelas: agendamentos, clientes, servicos, usuarios

api/agenda/listarFunc.php

Tabelas: usuarios

api/agenda/listarServicos.php

Tabelas: servicos

api/agenda/salvar.php

POST: cliente, data, hora, id_funcionario, obs • Tabelas: clientes, dias

api/clientes

Listagem de clientes para app/telas externas.

1 arquivo(s)

api/clientes/listar.php

POST: url_img • Tabelas: clientes

api/clientes_retorno

Retenção e alerta de retorno de clientes.

2 arquivo(s)

api/clientes_retorno/alertar.php

POST: id

api/clientes_retorno/listar.php

POST: url_img • Tabelas: clientes, servicos

api/comissoes

Consolidação de comissões por período e funcionário.

1 arquivo(s)

api/comissoes/listar.php

POST: dataFinal, dataInicial, id_usuario, status, url_img • Tabelas: clientes, servicos, usuarios

api/compras

CRUD operacional de compras com upload e auxiliares.

7 arquivo(s)

api/compras/baixar.php

POST: id, id_usuario

api/compras/listar.php

POST: dataFinal, dataInicial, status, url_img • Tabelas: fornecedores, usuarios

api/compras/listarClientes.php

Tabelas: fornecedores

api/compras/listarPgto.php

Tabelas: formas_pgto

api/compras/listarProd.php

Tabelas: produtos

api/compras/salvar.php

POST: data_pgto, data_venc, id, id_usuario, nome_foto • Tabelas: produtos

api/compras/upload.php

UPLOAD

api/dias

Listagem de dias por usuário/profissional.

1 arquivo(s)

api/dias/listar.php

POST: id_usuario

api/estoque

Baixo estoque e catálogo de produtos/categorias.

1 arquivo(s)

api/estoque/listar.php

POST: url_img • Tabelas: cat_produtos, produtos

api/fornecedores

Listagem de fornecedores.

1 arquivo(s)

api/fornecedores/listar.php

POST: url_img • Tabelas: fornecedores

api/funcionarios

Listagem de funcionários/usuários.

1 arquivo(s)

api/funcionarios/listar.php

POST: url_img • Tabelas: usuarios

api/home

Painel resumo para app/home com retorno JSON.

1 arquivo(s)

api/home/listar.php

POST: id_usuario • JSON • Tabelas: agendamentos, clientes, pagar, produtos

api/horarios

Disponibilidade de horários por usuário.

1 arquivo(s)

api/horarios/listar.php

POST: id_usuario

api/login

Autenticação mobile/app.

1 arquivo(s)

api/login/login.php

POST: email, senha • JSON • Tabelas: usuarios

api/pagar

Contas a pagar e baixa.

2 arquivo(s)

api/pagar/baixar.php

POST: id, id_usuario

api/pagar/listar.php

POST: dataFinal, dataInicial, status, url_img • Tabelas: fornecedores, usuarios

api/receber

Contas a receber e baixa.

2 arquivo(s)

api/receber/baixar.php

POST: id, id_usuario • Tabelas: pagar, servicos

api/receber/listar.php

POST: dataFinal, dataInicial, status, url_img • Tabelas: clientes, usuarios

api/servicos

Serviços executados / baixa.

2 arquivo(s)

api/servicos/baixar.php

POST: id, id_usuario • Tabelas: pagar, servicos

api/servicos/listar.php

POST: dataFinal, dataInicial, id_usuario, status • Tabelas: clientes, usuarios

api/usuarios

CRUD parcial de usuários, upload e permissões.

5 arquivo(s)

api/usuarios/listar.php

POST: url_img • Tabelas: usuarios

api/usuarios/listarNivel.php

Tabelas: cargos

api/usuarios/salvar.php

POST: ativo, email, id, nivel, nome • Tabelas: usuarios

api/usuarios/upload.php

UPLOAD

api/usuarios/verificarPermissoes.php

POST: id_usuario • JSON • Tabelas: acessos, usuarios, usuarios_permissoes

api/vendas

CRUD operacional de vendas com upload e auxiliares.

7 arquivo(s)

api/vendas/baixar.php

POST: id, id_usuario

api/vendas/listar.php

POST: dataFinal, dataInicial, status, url_img • Tabelas: clientes, usuarios

api/vendas/listarClientes.php

Tabelas: clientes

api/vendas/listarPgto.php

Tabelas: formas_pgto

api/vendas/listarProd.php

Tabelas: produtos

api/vendas/salvar.php

POST: data_pgto, data_venc, id, id_usuario, nome_foto • Tabelas: produtos

api/vendas/upload.php

UPLOAD

Endpoints com JSON explícito

São os pontos mais claramente “API” no sentido clássico.

  • api/home/listar.php
  • api/login/login.php
  • api/not.php
  • api/notid.php
  • api/usuarios/verificarPermissoes.php

Endpoints de upload

Esses arquivos merecem teste extra de tamanho, extensão, nome de arquivo e permissão de escrita.

  • api/compras/upload.php
  • api/usuarios/upload.php
  • api/vendas/upload.php

Notas de manutenção

Pontos práticos para o próximo dev não perder tempo.

A pasta /api não é uma REST API pura. Parte dos arquivos devolve JSON, mas boa parte devolve HTML fragmentado ou texto pronto para app/PWA.
Os módulos mais densos são /api/vendas e /api/compras, cada um com salvar, listar, baixar, upload e listagens auxiliares.
Os endpoints /api/login/login.php e /api/home/listar.php formam o núcleo mais claro de integração externa/mobile.
Permissões e perfil de acesso do app aparecem em /api/usuarios/verificarPermissoes.php, tocando acessos, usuários e usuários_permissoes.

Navegação relacionada

Estas páginas ajudam a fechar o raciocínio fora do painel.

Abrir documentação de /ajax Abrir cobertura final de /ajax e /api Abrir documentação de webhook Abrir documentação de pagamentos