API
Setiap laporan awam juga JSON. Tiada kunci untuk diminta dan tiada akaun untuk dicipta — jika laman telah menerbitkan laporannya, nombornya boleh dibaca oleh sesiapa, dalam bentuk yang sama dengan halaman laporan yang ditarik dari.
Itu adalah titik berbanding kemudahan. Nombor yang anda tidak boleh dapatkan dan semak secara bebas adalah skrinsampul. Dua titik akhir ini adalah apa yang membuat tuntutan di depan laman ini boleh diuji.
Lapor data
Semuanya di belakang laporan yang diterbitkan: jumlah, siri masa carta ditarik dari, dan sumber, halaman, negara, pelayar, sistem, peranti dan pemisahan kampanye.
| Parameter | Nilai | Makna |
|---|---|---|
period | last24h · last7d · last30d · last90d · all |
Tetingkap. Lalai ke last24h; apa-apa yang tidak dikenali jatuh semula ke dalamnya bukannya ralat. |
granularity | hourly · daily |
Saiz beg untuk siri. Lupakan dan setiap tempoh menggunakan satu semulajadinya - setiap jam untuk hari, setiap hari untuk semua yang lebih panjang. |
Balasan adalah satu objek dengan kekunci ini:
Pelawat Segera
Siapa yang berada di laman ini sekarang, dan dari mana mereka datang. Hanya agregat - tidak pernah id pengunjung, tidak pernah laluan, tidak pernah apa- apa yang boleh memisahkan seseorang.
| Parameter | Nilai | Makna |
|---|---|---|
minutes | 1–60 | Berapa jauh ke belakang kiraan sebagai sekarang. Lalai kepada 5; nilai di luar julat dilekatkan, tidak ditolak. |
Satu ini menghantar Akses-Kawalan-Izinkan-Origin: * dan cache selama sepuluh saat, jadi laman boleh memasukkan nombor hidupnya sendiri yang dikira secara bebas ke dalam halamannya sendiri — dan pembaca boleh buka laporan dan semak ia dengan apa yang didakwa oleh halaman.
Apa yang awak boleh harapkan
- Tiada pengesahan, tiada kunci, tiada had kadar untuk mendaftar masuk. Kedua-dua titik akhir adalah GET biasa.
- Laporan mesti umum. Jika pemiliknya tidak menerbitkannya, kedua-dua titik akhir mengembalikan 404 — jawapan yang sama yang diperoleh laman tidak diketahui, jadi API tidak pernah mendedahkan bahawa laman peribadi wujud.
- Tiada apa-apa yang mengidentifikasi disediakan, kerana tiada apa-apa yang mengidentifikasi disimpan. Alamat IP tidak pernah ditulis, dan id pengunjung disal setiap hari dan tidak boleh digabungkan sepanjang hari.
- Kelmarin dan sebelumnya dimasukkan ke dalam rantaian hash harian yang anda boleh hitung semula sendiri. Nombor dalam API ini adalah nombor dalam rantaian itu.