TyreRanker-ranking omalle kotisivullesi

Näytä riippumattomien rengastestien TOP-lista omalla sivullasi. Ilmainen ja aina ajan tasalla: kun uusi testi tulee, ranking päivittyy myös sinun sivullasi.

Luo oma widget

Ulkoasu

Esikatselu

Koodi sivullesi

Kopioi tämä koodi sivusi HTML:ään kohtaan, jossa rankingin pitää näkyä. Widgetin korkeus mukautuu itsestään.

<div class="tyreranker-top" data-key="SINU_API_VOTI" data-type="winter_studded" data-lang="fi" data-limit="5" data-theme="light"></div>
<script src="https://tyreranker.com/widget.js" async></script>

Jos sivusi ei salli skriptejä, käytä tavallista iframea:

<iframe src="https://tyreranker.com/embed/top/winter_studded?lang=fi&limit=5&theme=light&key=SINU_API_VOTI" title="TyreRanker TOP" width="420" height="420" style="border:0;max-width:100%" loading="lazy"></iframe>

Ilman iframea: ranking omalta palvelimeltasi

Jos sivusi ei salli iframea tai ulkoisia skriptejä, palvelimesi hakee rankingin API-avaimella kerran päivässä ja sivu näyttää sen omana sisältönään. Valmis HTML ulkoasuineen:

https://tyreranker.com/api/v1/top/winter_studded?key=SINU_API_VOTI&lang=fi&limit=5&format=html

Tiedot JSON-muodossa, jos suunnittelet ulkoasun itse:

https://tyreranker.com/api/v1/top/winter_studded?key=SINU_API_VOTI&lang=fi&limit=5

Esimerkki PHP:llä: päivittää kerran päivässä ja näyttää välillä tallennetun kopion.

<?php
$url  = 'https://tyreranker.com/api/v1/top/winter_studded?key=SINU_API_VOTI&lang=fi&limit=5&format=html';
$file = __DIR__ . '/tyreranker-top-winter_studded-fi.html';
if (!is_file($file) || filemtime($file) < time() - 86400) {
  $html = @file_get_contents($url);
  if ($html) file_put_contents($file, $html);
}
if (is_file($file)) echo file_get_contents($file);
?>

JSON-API kehittäjille

Jos haluat suunnitella rankingin ulkoasun itse, hae tiedot JSON-muodossa. Rajapinta on avoin (CORS sallittu) ja tiedot päivittyvät tunnin välein.

GET https://tyreranker.com/api/v1/top/winter_studded?lang=fi&limit=5&key=trk_…

Parametrit: tyyppi osoitteessa (winter_studded, winter_nordic, winter_central, all_season, summer), key – API-avaimesi (tai otsake X-API-Key), lang – kieli (et, fi, sv, no, lv, lt, en), limit – renkaiden määrä 1–20.

format=html palauttaa JSONin sijaan valmiin HTML:n ulkoasuineen (theme=dark tummalla ulkoasulla). Palvelimelta tehtyyn pyyntöön riittää avain.

{
  "source": "TyreRanker",
  "type": "winter_studded",
  "lang": "fi",
  "title": "…",
  "url": "https://tyreranker.com/fi/…",
  "attribution": { "text": "…", "url": "…", "required": true },
  "items": [
    { "rank": 1, "brand": "…", "model": "…", "score": 91, "tests": 5, "image": "https://…", "url": "https://tyreranker.com/…" }
  ]
}

Käyttöehdot

  • Käyttö on ilmaista, myös kaupallisella sivustolla.
  • Näytä lähde: ”TyreRanker”-linkin on pysyttävä näkyvissä ja klikattavana.
  • Älä muuta pisteitä tai järjestystä äläkä esitä niitä omina testituloksinasi.
  • Pidä tiedot tuoreina: käytä itsestään päivittyvää widgetiä tai hae tiedot API:sta vähintään kerran päivässä.