Zum Inhalt springen

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

POST/api/analytics/robots

Auth
Öffentlich
Die Beschreibungen der Endpoints stammen aus der API-Spezifikation und sind vorerst auf Portugiesisch. Die Oberfläche drumherum ist übersetzt.

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

NameTypBeschreibung
X-Analytics-KeyPflichtstring

Request-Body application/json

NameTypBeschreibung
itemsPflichtobject[]
items[].communityIdPflichtstring (uuid)
items[].userAgentPflichtstring
items[].pathPflichtstring
items[].countPflichtinteger≥ 1
items[].atoptionalstring (date-time)Minuto da contagem.

Antworten

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

curl-Beispiel

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