API
Her kamu raporu JSON'dur. İsteyecek bir anahtar ve oluşturacak bir hesap yoktur - eğer bir site raporunu yayınladıysa, rapor sayfasının kendisi tarafından çekilen aynı biçimde, sayıları herkes tarafından okunabilir.
Bu, bir rahatlıktan ziyade bir noktadır. Bir sayı, bağımsız olarak alınıp kontrol edilemez ve ekran görüntüsüdür. Bu iki son nokta, bu sitenin ön yüzündeki iddiayı test edilebilir hale getirir.
Rapor verileri
Yayınlanan bir raporun arkasındaki her şey: toplamlar, grafikin çekildiği zaman serileri ve kaynak, sayfa, ülke, tarayıcı, sistem, cihaz ve kampanya ayrıntıları.
| Parametreler | Değerler | Anlam |
|---|---|---|
period | last24h · last7d · last30d · last90d · all |
Pencere. Varsayılan son24 saattir; tanımlanmamış herhangi bir şey hata vermek yerine geri döner. |
granularity | hourly · daily |
Seri için kova büyüklüğü. Bu değeri bırakın ve her dönem kendi doğal dönemini kullansın - bir gün için saatlik, daha uzun her şey için günlük. |
Cevap şu anahtarlarla bir nesnedir:
Canlı ziyaretçiler
Şu anda sitede kimler var ve nereden geldiler. Sadece toplamlar. Hiçbir ziyaretçi ID'si, hiçbir yol, hiçbir kişiyi ayırt edebilecek bir şey.
| Parametreler | Değerler | Anlam |
|---|---|---|
minutes | 1–60 | Şimdi olarak ne kadar geri sayılır. Önceden belirlenmiş değer 5; aralığın dışındaki değerler reddedilecek değil, sabitlenecektir. |
Bu, Access-Control-Allow-Origin: * gönderir ve on saniye için önbellekler, böylece bir site kendi sayfasına kendi bağımsız olarak sayılmış canlı sayısını ekleyebilir - ve bir okuyucu raporu açabilir ve sayfanın iddia ettiği şeye karşı kontrol edebilir.
Saygı duyduğun şeyler
- Kimlik doğrulama, anahtar, kayıt hızı sınırı yok. Her iki son nokta da basit GET'lerdir.
- Bir rapor kamuya açık olmalıdır. Eğer sahibi onu yayınlamamışsa, her iki son nokta da 404 geri döndürür - bilinmeyen bir sitenin aldığı aynı cevap, bu yüzden API özel bir sitenin varlığını asla ortaya çıkarmaz.
- Kimlik belirleyici bir şey sunulmuyor, çünkü kimlik belirleyici bir şey depolanmıyor. IP adresleri asla kaydedilmiyor ve ziyaretçi ID' leri günlük tuzlanır ve gün içinde birleşemez.
- Dün ve daha önceki günler, günlük bir hash zinciri içinde tutulur, kendi kendiniz tekrar hesaplayabilirsiniz. Bu API'deki rakamlar, o zincirdeki rakamlar.