Nova API V1.0 · Referência
Funil de visitas
Consulta de leitura equivalente à manager-api. Exige reports:customers:read e restaurante autorizado. Filtros, valores e paginação mantêm o contrato do serviço de relatórios. Não concede permissões novas a tokens existentes.
Consulta de leitura equivalente à manager-api. Exige reports:customers:read e restaurante autorizado. Filtros, valores e paginação mantêm o contrato do serviço de relatórios. Não concede permissões novas a tokens existentes.
Authorization
reportsIntegration Access token obtido por OAuth ou troca de API key. Exige reports:payments:read, reports:customers:read, reports:products:read ou reports:kds:read conforme a rota. Não aceita sessões humanas, tokens de garçom ou chaves brutas.
In: header
Query Parameters
Restaurante autorizado pela credencial. Obrigatório quando houver mais de um restaurante; sem seleção implícita para credenciais universais.
Início do período (YYYY-MM-DD). No KDS também aceita ISO com timezone.
Fim do período (YYYY-MM-DD). KDS inclui o dia civil de Brasília; com ISO, o instante final é exclusivo. KDS: máximo 92 dias.
Início da coorte (YYYY-MM-DD).
Fim da coorte (YYYY-MM-DD).
Etapa mínima no funil de visitas.
Cursor opaco retornado em data.next_cursor. Omitir na primeira página; null encerra a paginação.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
Clientes por atividade GET
Consulta de leitura equivalente à manager-api. Exige reports:customers:read e restaurante autorizado. Filtros, valores e paginação mantêm o contrato do serviço de relatórios. Não concede permissões novas a tokens existentes.
Clientes por etapa de visitas GET
Consulta de leitura equivalente à manager-api. Exige reports:customers:read e restaurante autorizado. Filtros, valores e paginação mantêm o contrato do serviço de relatórios. Não concede permissões novas a tokens existentes.