Contagem de robôs enviada pelo servidor do app (servidor a servidor)
POST/api/analytics/robots
- Auth
- Public
- Clé d’API:
- reports:write
Les descriptions des endpoints viennent directement de la spécification de l’API et sont en portugais pour l’instant. L’interface autour est traduite.
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.
En-têtes
| Nom | Type | Description |
|---|---|---|
X-Analytics-Keyobligatoire | string |
Corps de la requête application/json
| Nom | Type | Description |
|---|---|---|
itemsobligatoire | object[] | |
items[].communityIdobligatoire | string (uuid) | |
items[].userAgentobligatoire | string | |
items[].pathobligatoire | string | |
items[].countobligatoire | integer | ≥ 1 |
items[].atfacultatif | string (date-time) | Minuto da contagem. |
Réponses
| Statut | Description |
|---|---|
202 | Contagem recebida. |
400 | Requisição inválida — falha de validação. |
403 | Autenticado, mas sem permissão para esta operação. |
Exemple curl
curl -X POST "https://api.memberfy.net/api/analytics/robots" \
-H "Content-Type: application/json" \
-d '{"items":[{}]}'