Skip to content

Contagem de robôs enviada pelo servidor do app (servidor a servidor)

POST/api/analytics/robots

Auth
Public
Endpoint descriptions come straight from the API specification and are in Portuguese for now. The interface around them is translated.

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

NameTypeDescription
X-Analytics-Keyrequiredstring

Request body application/json

NameTypeDescription
itemsrequiredobject[]
items[].communityIdrequiredstring (uuid)
items[].userAgentrequiredstring
items[].pathrequiredstring
items[].countrequiredinteger≥ 1
items[].atoptionalstring (date-time)Minuto da contagem.

Responses

StatusDescription
202Contagem recebida.
400Requisição inválida — falha de validação.
403Autenticado, mas sem permissão para esta operação.

curl example

curl -X POST "https://api.memberfy.net/api/analytics/robots" \
  -H "Content-Type: application/json" \
  -d '{"items":[{}]}'