Publiczne API i widgety

Wpuść Kiepskich na swoją stronę

REST endpointy zwracają JSON z CORS *. Rate limit 60 req/min per IP. Bez klucza. Widget iframe działa wszędzie bez konfiguracji.

Endpointy

GET /api/v1/quotes/random

Losowy kultowy cytat. Cache 60s.

{
  "quote": {
    "id": 1,
    "text": "Wolność Tomku w swoim domku.",
    "character": "Ferdek Kiepski",
    "episodeId": null,
    "timestampSec": null,
    "eloRating": 1200
  },
  "attribution": {
    "source": "swiatkiepskich.pl",
    "url": "https://swiatkiepskich.pl/cytaty"
  }
}

GET /api/v1/episode/of-the-day

Deterministyczny odcinek dnia (wszyscy widzą ten sam przez 24h). Cache 1h.

{
  "episode": {
    "id": 14,
    "title": "Właściciele",
    "seasonId": 1,
    "seasonEpisodeNumber": 11,
    "globalNumber": 14,
    "thumbnailUrl": "https://ipla.pluscdn.pl/...",
    "polsatShareUrl": "https://polsatboxgo.pl/...",
    "youtubeVideoId": null,
    "url": "https://swiatkiepskich.pl/sezon/1/odcinek/11-wlasciciele"
  }
}

Widget iframe

Losowy cytat w karcie 400×140 do wklejenia na blog:

<iframe
  src="https://swiatkiepskich.pl/widget/quote"
  width="400"
  height="140"
  frameborder="0"
  title="Cytat z Kiepskich"
></iframe>

Preview:

Chcesz więcej? Napisz — kontakt.