Tá istá odpoveď, ako JSON

Zadarmo

• GET /api/site/{domain}

  Jedna verejná doména dnu, celý roztriedený prehľad s dôkazom pri každom náleze von, plus zmeny, ktoré o nej už máme.

  curl https://homelab.tailbf8f27.ts.net/sitetech/api/site/{domain}
  
  {"ok":true,"domain":"example.sk","final_url":"https://www.example.sk/","fetched_at":"…","cached":false,
   "categories":[{"id":"cms","findings":[{"slug":"wordpress","version":"6.6","confidence":"certain",
     "evidence":[{"type":"meta","key":"generator","value":"WordPress 6.6"}]}]}],
   "hygiene":{"passed":9,"total":13},"changes":[],"quota":{"scope":"free","remaining":19}}

• GET /api/site/{domain}?stream=1

  To isté volanie ako Server Sent Events, takže sa stránka dopĺňa po fázach a nečaká na všetko naraz.

  curl https://homelab.tailbf8f27.ts.net/sitetech/api/site/{domain}?stream=1
  
  event: cached / dns / tls / http / fingerprints / hygiene / done

• GET /api/site/{domain}/history

  Všetky zmeny, ktoré sme pri doméne zaznamenali. História začína dňom prvého merania, nič nedopĺňame spätne.

  curl https://homelab.tailbf8f27.ts.net/sitetech/api/site/{domain}/history
  
  {"ok":true,"domain":"example.sk","first_seen":"…","observations":14,"changes":[…]}

• GET /api/changes

  Nedávne zmeny technológií v celom paneli prieskumu. Parametre: tld, category, slug, since, limit.

  curl https://homelab.tailbf8f27.ts.net/sitetech/api/changes
  
  {"ok":true,"since":"…","n":38,"items":[{"domain":"example.sk","ts":"…","category":"cms","kind":"switched"}]}

• GET /api/stats/{tld}

  Súhrnné používanie pre .sk alebo .cz vo všetkých kategóriách. ETag a Cache-Control public, max-age 3600.

  curl https://homelab.tailbf8f27.ts.net/sitetech/api/stats/{tld}
  
  {"ok":true,"tld":"sk","as_of":"…","panel":{…},"categories":[{"id":"cms","items":[{"slug":"wordpress",
    "usage_pct":38.4,"share_pct":56.3,"n":28497,"se_pct":0.18,"change_30d_pp":0.4,"series":[…]}]}]}

• GET /api/stats/{tld}/{category}

  Jedna kategória celá, aj s dlhým chvostom, týždennou krivkou za 52 týždňov a vetou o metóde.

  curl https://homelab.tailbf8f27.ts.net/sitetech/api/stats/{tld}/{category}
  
  {"ok":true,"tld":"sk","category":"cms","items":[…],"method":"usage_pct = detected / successfully scanned"}

• GET /api/compare

  Dve technológie vedľa seba, s rozdelením .sk oproti .cz a počtami prechodov v oboch smeroch.

  curl https://homelab.tailbf8f27.ts.net/sitetech/api/compare
  
  {"ok":true,"a":{…},"b":{…},"split":{"rows":[{"key":"sk"},{"key":"cz"}]},"switches_12m":{"a_to_b":14,"b_to_a":31}}

• GET /api/technologies

  Katalóg: každá kategória, ktorú hlásime, každá technológia, ktorú vieme pomenovať, a typy signálov za ňou.

  curl https://homelab.tailbf8f27.ts.net/sitetech/api/technologies
  
  {"ok":true,"generated":"…","categories":[{"id":"cms","label":"Content management","label_sk":"Redakčný systém"}]}

• GET /api/key

  Čo je tento kľúč a koľko na ňom ostáva. Vyžaduje hlavičku X-API-Key. Jediná vec podobná účtu, ktorú máme.

  curl https://homelab.tailbf8f27.ts.net/sitetech/api/key
  
  {"ok":true,"pack":"10k","quota_total":10000,"quota_used":1487,"quota_left":8513,"rate":{"per_minute":100}}

• GET /api/health

  Či služba žije a z čoho meria: veľkosť databázy, front, pripnutý ruleset, dátum tabuľky ASN, posledný prieskum.

  curl https://homelab.tailbf8f27.ts.net/sitetech/api/health
  
  {"ok":true,"version":"1.0.0","db":{…},"ruleset":{"name":"webappanalyzer","pinned":"…"},"survey":{…}}

Chyby

Limity

Bez kľúča

20 kontrol denne, najviac jedna za 3 sekundy.

S kľúčom

3 požiadavky za sekundu, 100 za minútu, plus zostatok balíka.

Na cieľ

Jedno stiahnutie tej istej domény za 60 sekúnd naprieč všetkými klientmi. Ostatní dostanú výsledok z pamäte.

Na kontrolu

3 s spojenie, 5 s čítanie, tvrdý rozpočet 8 s, 512 KB HTML, 3 presmerovania, len GET.

Proti zaplaveniu

50 volaní API za sekundu a 1000 za minútu na klienta, vrátane odpovedí z pamäte. Je to poistka, aby jeden klient nezaplavil server; nič nespotrebuje.

Balíky

• 1 000 požiadaviekV prepočte 2,90 € za sto požiadaviek.
  29 €jednorazovo, bez DPH
• 10 000 požiadaviekV prepočte 1,49 € za sto požiadaviek.
  149 €jednorazovo, bez DPH

Poctivé porovnanie