Contagem de robôs enviada pelo servidor do app (servidor a servidor)
POST/api/analytics/robots
- Auth
- Pubblica
Le descrizioni degli endpoint provengono dalla specifica dell’API e per ora sono in portoghese. L’interfaccia intorno è tradotta.
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.
Header
| Nome | Tipo | Descrizione |
|---|---|---|
X-Analytics-Keyobbligatorio | string |
Corpo della richiesta application/json
| Nome | Tipo | Descrizione |
|---|---|---|
itemsobbligatorio | object[] | |
items[].communityIdobbligatorio | string (uuid) | |
items[].userAgentobbligatorio | string | |
items[].pathobbligatorio | string | |
items[].countobbligatorio | integer | ≥ 1 |
items[].atfacoltativo | string (date-time) | Minuto da contagem. |
Risposte
| Codice | Descrizione |
|---|---|
202 | Contagem recebida. |
400 | Requisição inválida — falha de validação. |
403 | Autenticado, mas sem permissão para esta operação. |
Esempio con curl
curl -X POST "https://api.memberfy.net/api/analytics/robots" \
-H "Content-Type: application/json" \
-d '{"items":[{}]}'