Endpoint: GET /unified/statistics/by-distributor-n1/
Autenticação: JWT obrigatório (apenas superusuário). Usuários comuns recebem 403.
Retorna as linhas de DailyAccountsByDistributorN1. Cada linha associa uma conta unificada atuando como distribuidor de nível 1 ao número de contas atribuídas a ela em date. Ordenado por (-date, -count). A paginação está desativada. O campo distributor traz id, display_name e type da conta distribuidora. Se a conta distribuidora foi removida, distributor virá como null, mas o nome registrado no momento do snapshot fica preservado na linha do banco.

Requisição

Parâmetros de consulta

date_gte
string (YYYY-MM-DD)
Filtra linhas onde date >= date_gte.
date_lte
string (YYYY-MM-DD)
Filtra linhas onde date <= date_lte.
distributor
string (UUID)
Filtro de correspondência exata pelo UUID da conta distribuidora.
distributor_name
string
Filtro por substring (sem diferenciar maiúsculas e minúsculas) sobre o nome do distribuidor registrado no snapshot.

Resposta

Um array JSON de objetos:
date
string (YYYY-MM-DD)
Dia do snapshot.
distributor
object | null
  • id, display_name, type da conta distribuidora.
count
integer
Número de contas atribuídas àquele distribuidor em date.
[
  {
    "date": "2025-05-14",
    "distributor": {
      "id": "8c2d7f6e9b4a4f10aabbccddeeff0011",
      "display_name": "Distributor One",
      "type": "business"
    },
    "count": 412
  }
]

Erros

StatusQuando
401Cabeçalho Authorization ausente ou inválido.
403Autenticado, porém não é superusuário.

Exemplos

curl "https://api.dlpay.cloud/unified/statistics/by-distributor-n1/" \
  -H "Authorization: Bearer $TOKEN"