Kurulum ve işletme

API referansı

Ingest

Kimlik doğrulaması gerekmez; site kimliği yetkilendirmedir.

POST /api/collect
Content-Type: application/json

{
  "site": "SITE_ID",
  "type": "pageview",          // veya "event"
  "url": "/fiyat?utm_source=x",
  "referrer": "https://chatgpt.com/",
  "name": "cta_click",         // type=event ise zorunlu
  "props": { "plan": "pro" },
  "identity": "kullanıcı-kimliği", // isteğe bağlı
  "tag": "v2"
}

Yanıt	Anlamı
`204`	Kaydedildi.
`400`	Gövde geçersiz — gerekçe JSON'da.
`404`	Site kimliği tanınmıyor.
`429`	Aylık kota aşıldı.

Sunucu istemciye güvenmez. Zaman damgası, IP, ülke ve bot kararı sunucuda belirlenir; gövdede gönderseniz de yok sayılır.

Sorgu uçları

Oturum çerezi gerekir. Hepsi site erişim denetiminden geçer — başkasının site kimliği 404 döner (403 değil: varlık bilgisi sızmasın).

Uç	Döndürdüğü
`GET /api/stats?site=&days=`	Kanıt paketi: her metrik için sorgu, parametre ve sonuç.
`GET /api/digest?site=&days=`	Digest + kanıtlar. `&format=text` düz metin verir.
`GET /api/funnel?site=&steps=`	Huni sonucu. `steps` JSON dizisi.
`GET /api/retention?site=`	Kohort matrisi ya da neden hesaplanamadığı.
`GET /api/orgs/:id/usage`	Kota durumu.