Scortes Neoficiální fotbal.cz API

Výsledky z fotbal.cz na každý web!

Většina menších fotbalových klubů by ráda zobrazovala aktuální výsledky z soutěží od FAČR. Bohužel fotbal.cz nenabízí API přístup k výsledkům, takže doteď buď klub duplikovat výsledky přes různé složité nástroje nebo přímo odkazovat na web fotbal.cz, vysledky.lidovky.cz.

Proč použít Scortes?

Přehled informací o API

Jak to funguje?

  1. Scortes pravidelně stahuje data z fotbal.cz
  2. Přes speciální URL adresy zobrazíte rozpisy, tabulky, statistiky, přehled týmu, kalendář

Verze

Blokování z is.fotbal.cz → ukončení provozu

is.fotbal.cz začal Scortes blokovat a přidávat různé vychytávky zabraňující automatickému stahování výsledků. Proto ukončuji vývoj aplikace. Letošní sezónu dojedu s manuálním doplněním výsledků, pak "prodám kravku a na jaře nezaseju…"

Původní informace o aplikaci

Co musím udělat, když chci zobrazit výsledky přes Scortes?

Scortes je stále v plenkách, takže není dostupná online registrace, takže je třeba nejdřív komunikovat pomocí emailu. Napište o jaké fotbalové soutěže a jaký web se jedná na email scortes@rozpisyzapasu.cz.

Které kluby používají Scortes?

Aktuálně jsou aktualizovány 3 fotbalové soutěže pro Sokol Morašice z Pardubického kraje.

Jak integruji Scortes na svůj web?

Scortes vrací HTML text, který můžete vložit rovnou na Vaše stránky. Doporučuji vložení do stránek pomocí AJAX, tak jako na sokolmorasice.g6.cz. Podívejte se vyzkoušejte ukázkovou integraci.

URL se skládá z kódu soutěže, roku, jména týmu a typu zobrazení, http://rozpisyzapasu.cz/scortes/api/<kod_souteze>/<rok>/<tym>/<zobrazeni>.html. Seznam všech dostupných URL adres i zdrojových stránek, odkud se načítají výsledky, najdete přes http://rozpisyzapasu.cz/scortes/api/<kod_souteze>/<rok>.json

Proč Scortes zase vrací jen HTML? To je cesta z bahna do louže

Cílem je jednoduchá integrace. Prošel jsem si ruční aktualizací tabulek, správou soutěží ve složitém nástroji i cachováním výsledků. Teď jsem ve fázi úplné automatizace. Nechci řešit aktualizaci výsledků ani cachování. Scortes to pro mě a Morašice vyřeší. Když se aplikace osvědčí a bude zájem, tak není problém vracet třeba JSON.

Co je v plánu za vylepšení?

První fází je použití Scortes v Morašicích. Mezi nápady rozšíření je např. možnost definice vlastních HTML šablon, vylepšené statistiky týmu, kromě loga má tým i odkaz na web, možnost přejmenování týmů.

Co když se něco na fotbal.cz změní?

Toto je nevýhoda neoficiálního API :) Scortes stáhne obsah stránek a z nich vytáhne strukturované informace. Když se změní design na fotbal.cz, tak automatická aktualizace přestane fungovat. Naštěstí DOM parser je jen jedna z částí Scortesu, takže změna nebude tak náročná (ověřeno při přechodu na is.fotbal.cz :)

Každý si může zvolit, zda chce záviset na ručním vkládání výsledků, nestabilním fotbal.cz (nebo jiném výsledkovém webu) nebo API Scortesu, který tu nestabilitu fotbal.cz skrývá.

Jaký význam má jméno Scortes?

Zřejmě žádný. Je to vygenerované slovo z wordoid. Aplikace se mohla jmenovat třeba rebally, reballed, ballian, unbally, scoresh, scorian, scorero, scorsion, …

Podmínky používání

  • V obsahu načítáném přes Scortes musí zůstat viditelná patička s copyrightem
  • V případě porušení podmínek budou problémové soutěže odstraněny