Contagem de robôs enviada pelo servidor do app (servidor a servidor)
POST/api/analytics/robots
- Auth
- Pública
Chamada pelo `server.js` do app, uma vez por minuto, com o que ele agregou em memória: comunidade × User-Agent × rota × quantidade de requisições de página de robôs (quem não roda JavaScript). A API classifica o UA (buscador, LLM ou robô ruim; humano é ignorado) e soma no dia da comunidade. Exige `X-Analytics-Key` igual a `ANALYTICS_INGEST_KEY`; sem a chave configurada, sempre 403.
Headers
| Nome | Tipo | Descrição |
|---|---|---|
X-Analytics-Keyobrigatório | string |
Corpo da requisição application/json
| Nome | Tipo | Descrição |
|---|---|---|
itemsobrigatório | object[] | |
items[].communityIdobrigatório | string (uuid) | |
items[].userAgentobrigatório | string | |
items[].pathobrigatório | string | |
items[].countobrigatório | integer | ≥ 1 |
items[].atopcional | string (date-time) | Minuto da contagem. |
Respostas
| Código | Descrição |
|---|---|
202 | Contagem recebida. |
400 | Requisição inválida — falha de validação. |
403 | Autenticado, mas sem permissão para esta operação. |
Exemplo com curl
curl -X POST "https://api.memberfy.net/api/analytics/robots" \
-H "Content-Type: application/json" \
-d '{"items":[{}]}'