Tee jalkapallobotti otteluohjelman, tulosten ja sarjataulukon seurantaan

Piotr Grudzień
Julkaistu Lukuaika 7 min
Arsenalin kolmen rivin ottelupäivän tiedot Quickchat AI-sovelluksessa sekä football-data.org-sivuston Account Settings, jossa näkyy Free-tilaus.

Suunnittelet lauantaitasi Arsenalin Newcastle-vierasottelun mukaan. Ystäväsi New Yorkissa tarvitsee ottelun alkamisajan. Sitten joku ryhmäkeskustelussa kysyy, miten Arsenal pärjäsi edellisessä vierasottelussaan. Ensimmäinen vastaus löytyy otteluohjelmasta. Toista varten sinun on tiedettävä, kumman joukkueen maali on kyseessä tuloksessa ”Liverpool 0, Arsenal 1”.

Rakennat Matchday Notebook:n, jalkapallobotin, joka hakee kolme seuraavaa Valioliigan ottelua, kertoo Arsenalin viisi viimeisintä sarjatulosta ja löytää joukkueen sijoituksen sarjataulukosta. Esimerkki perustuu tilanteeseen 18. marraskuuta 2026. Newcastle-vierasottelu oli määrä pelata lauantaina 21. marraskuuta klo 17:30 UTC, eli klo 12:30 New Yorkin aikaa.

Newcastle-ottelu Native Stats:ssä ja vastaava ottelupäivän vastaus Quickchat AI:ssä Palveluntarjoajan ottelusivu ja yksityinen agentti ovat samaa mieltä alkamisajasta. Quickchat AI-keskustelu ajettiin julkisten tietojen data-uusinnalla, jonka voit toistaa alla.

Tarkista Newcastle-ottelu tai lataa Matchday Notebook-paketti. Pura paketti ja suorita python3 replay.py nähdäksesi kolme ottelua, viisi tulosta ja sarjataulukkorivin ilman tiliä. Sama paketti sisältää Action-asetukset ja Main Prompt:n oman syötteesi yhdistämistä varten.

1. Mitä seuraa ja sarjaa botti seuraa?

Määritä ensin seura ja sarja. Arsenalin vire sarjassa voi vaihdella riippuen siitä, lasketaanko mukaan tiistai-illan europelit. Tässä muistiossa Arsenal tarkoittaa joukkuetta 57 ja sarja tarkoittaa Valioliigaa 2021, joka tunnetaan myös koodilla PL.

  1. Avaa football-data.org-rekisteröintilomake. Anna etunimesi ja sähköpostiosoitteesi, hyväksy ehdot ja valitse Create account. Tarkista sarjasi kattavuuslistalta. Ilmaisversio sisältää Valioliigan viivästetyillä otteluohjelmilla ja tuloksilla.

football-data.org-rekisteröintilomake, jossa on etunimi- ja sähköpostikentät, Create account-painike ja Free Tier-tason tiedot Käytä sähköpostiosoitetta, jonka pystyt tarkistamaan. football-data.org lähettää API-avaimen sinne rekisteröitymisen jälkeen. Ilmaisversio sallii 10 pyyntöä minuutissa.

Jos sinulla on jo tili, kirjaudu sisään sähköpostiosoitteellasi ja API-tunnisteellasi. Jos tarvitset tunnisteesta uuden kopion, pyydä se sähköpostitse käyttämällä rekisteröimääsi osoitetta. Säilytä tunniste vaiheen 2 suojattua otsaketta varten.

football-data.org-sivuston Account Settings, jossa näkyy Free-tilaus ja osa Available competitions-listasta. Tarkista tilauksesi kohdasta Subscription ja etsi sarjasi kohdasta Available competitions. Tämä ote näyttää UEFA:n Mestarien liigan (CL) ja Bundesliigan (BL1).

  1. Jos haluat seurata toista seuraa, etsi se sarjan joukkuelistasta, esimerkiksi komennolla GET /v4/competitions/PL/teams. Käytä palautettua joukkuetunnusta ja sarjatunnusta alla olevissa ottelupyynnöissä. v4-pikaopas sisältää molemmat haut.
  2. Luo Quickchat AI-agentti, nimeä se Matchday Notebook, ja pidä se yksityisenä testauksen aikana. Tarvitset käytettävissä olevia krediittejä keskusteluihin ja simulointeihin. Avaa Identity → AI Persona → Main Prompt ja liitä alla olevat ohjeet. Kuvakaappaukset ja kopioitavat asetukset käyttävät englantia.

Arsenalin seurasivu Native Stats:ssä ja Matchday Notebook:n Identity-asetukset Quickchat AI:ssa Pidä sama seura molemmissa paikoissa. Tuotteessa Agentin ohjeet löytyvät kohdasta Identity.

Kopioi Matchday Notebook Main Prompt
You are Matchday Notebook, an Arsenal Premier League companion. Use get_club_fixtures for the schedule, get_recent_results for form and get_league_standings for the league table. For match reads, use an inclusive UTC start date and an exclusive end date. Ask for dates when the window is unclear.

List up to the requested number of TIMED or SCHEDULED fixtures in kickoff order. Give the date, time and timezone; say when the hour is unconfirmed. Flag postponed or cancelled games separately. For form, sort FINISHED matches newest first, take up to five and read full-time scores home first. Judge wins, draws and losses from Arsenal's side. For standings, find Arsenal (team 57) in the TOTAL table. Give the season, position, games played and points.

Keep answers short. Link a match to https://native-stats.org/match/ID using its returned ID, and the Premier League table to https://native-stats.org/competition/PL/. Attribute football-data.org, give the relevant date and identify any snapshot as a snapshot. Quote a retrieval time only if supplied. Keep null scores unknown. Report empty windows, missing scores and failed reads accurately. Stop after a rate limit. Do not predict scores.

2. Miten haet Arsenalin seuraavan ottelun?

Aloita toiminnolla, joka vastaa ryhmäkeskustelun kysymykseen alkamisajasta. Yksi pyyntö palauttaa molemmat seurat, aikataulutetun ajan ja ottelun tilan. Jätä tilasuodatin tässä avoimeksi, jotta myös siirretty ottelu voi tulla näkyviin. TIMED-tilassa ottelulla on alkamisaika. Jos tila on SCHEDULED, kerro lukijalle, että kellonaika vahvistetaan myöhemmin.

  1. Avaa Actions & MCPs → Add Action → API Action → Create manually. Aseta API Action Name arvoon get_club_fixtures ja When to run arvoon AI decides. Lisää What to ask the user first-kohtaan vaaditut Text-syötteet date_from ja date_to, molemmille No default. Niiden kuvaukset ovat ”Ensimmäinen mukaan otettava UTC-päivämäärä, YYYY-MM-DD” ja ”Ensimmäinen pois jätettävä UTC-päivämäärä, YYYY-MM-DD”.
  2. Valitse API Endpoint-kohdassa GET ja syötä alla oleva URL-osoite. Avaa Query Params ja aseta competitions literaaliarvoon 2021. Lisää dateFrom ja dateTo. Käytä kummankin arvon kohdalla Add AI Data → Parameters lisätäksesi vastaavan päivämääräsyötteen. Jätä Body tyhjäksi.
  3. Liitä alla oleva kuvaus kohtaan API Action Description ja tallenna toiminto. Kohdassa Headers tunnistetiedot tulevat vain kirjoitettavaan X-Auth-Token-riville. Määritä se ennen ensimmäistä pyyntöäsi. Lisää toinen, tavallinen otsikko, jossa Accept on avain ja application/json on arvo. Käytä samoja kahta otsikkoa kaikissa kolmessa toiminnossa.
https://api.football-data.org/v4/teams/57/matches

football-data.org-palvelun Team matches-reitti ja Quickchat AI-sovelluksen GET-päätepiste, jossa on käytössä Query Params sarjalle 2021 ja kahdelle päivämäärälle Seuraa palveluntarjoajan viiteaineiston joukkueen otteluiden reittiä toimintoon. Arsenal on kiinteästi URL-osoitteessa, sarja on Query Params-osiossa ja kaksi päivämäärää tulevat keskustelusta.

Kopioi ottelutoiminnon kuvaus
Use for Arsenal's upcoming Premier League fixtures in the requested date window. Sort by utcDate ascending. Show TIMED or SCHEDULED matches and flag postponements or cancellations separately. State the window if fewer fixtures are returned.

Palveluntarjoajan pyyntöesimerkeissä API-avain on sijoitettu X-Auth-Token-otsakkeeseen. Käytä samaa otsakkeen nimeä Headers-osiossa get_club_fixtures-toiminnossa.

Julkinen football-data.org-palvelun Sign in-lomake, v4-esimerkin X-Auth-Token ja Quickchat AI-sovelluksen Headers-välilehti Kirjautumislomakkeeseen syötetään sähköpostiosoite ja API-tunniste. Quickchat AI-sovelluksessa vain tunniste lisätään suojatulle X-Auth-Token-riville.

Syötä tunnus yksityisesti. Hallintapaneelissa voi korvata tallennetun tunnisteen. Jotta otsakkeen voi aluksi vain kirjoittaa, käytä tilin yhdistämistä kerran kutakin Actionia kohden. Yhdistä tilisi Quickchat AI-asennusoppaan avulla ChatGPT:ssä tai Claude:ssä. Pyydä yhdistettyä avustajaa valmistelemaan otsake vaarattomalla paikkamerkillä alla olevan ohjeen mukaisesti. Avaa sitten itse Actionin Headers-välilehti, korvaa arvo samalla rivillä football-data.org-tunnuksellasi ja valitse Save changes. Avaa editori uudelleen ja tarkista, että siinä näkyy [redacted]. Pidä tunnus hallintapaneelissa ja poissa keskustelusta.

On Matchday Notebook, set the X-Auth-Token header of get_club_fixtures to the literal value REPLACE_IN_DASHBOARD with is_secret=true. Preserve the rest of the settings. Read the Action back and confirm that the header is secret and the value is [redacted]. Stop before testing.

Headers-välilehti otteluohjelman Actionissa näyttää X-Auth-Token-kentän, jonka arvo on piilotettu Tämä on tallennettu otsake. Palveluntarjoaja odottaa pelkkää tunnusta ilman Bearer-etuliitettä.

Kokeile ensimmäistä hakua. Syötä Test Response → Test the API -näkymässä alkamispäivä ja haluamaasi viimeistä päivää seuraava päivä. Ota sitten Action käyttöön ja pyydä AI Preview-esikatselussa kolme seuraavaa sarjaottelua kyseisellä aikavälillä. Valitse tulevia päiviä, jos teet toimivaa versiota. Arkistoesimerkissä käytettiin 2026-11-18 ja 2026-12-03, joten joulukuun 2. päivän ilta oli mukana. Tarkista lähin ottelu avaamalla sen lähdelinkki. V4-ohje päivämääräsuodattimesta selittää, miksi päättymispäivä rajataan pois.

Kolme ottelupäivää aikavälillä, joka alkaa 18. marraskuuta ja päättyy ennen 3. joulukuuta Esimerkissä Newcastle-vieraspeli oli 21. marraskuuta, Manchester City -kotipeli 29. marraskuuta ja Brentford-vieraspeli 2. joulukuuta. Jos pyynnön päättymispäivä olisi ollut 2. joulukuuta, Brentford olisi jäänyt pois.

3. Miten haet Arsenalin viiden viimeisimmän ottelun tulokset?

Tämän esimerkin selkein ottelu päättyi Liverpool 0, Arsenal 1. Jos botti käsittelee ensimmäistä numeroa aina Arsenalin maalilukuna, se muuttaa vierasvoiton tappioksi. Pidä kaikki tulokset koti–vieras-järjestyksessä ja päättele joukkueen tunnisteen avulla, miten Arsenal pärjäsi.

  1. Luo toinen API Action nimeltä get_recent_results. Käytä samaa GET-päätepistettä, päivämääräsyötteitä, päivämäärämerkkejä ja kilpailusuodatinta. Lisää kyselyrivi status kirjaimellisella arvolla FINISHED.
  2. Aseta alla oleva kuvaus. Toista vain kirjoitettavan otsikon asetus get_recent_results:lle, tarkista maski ja ota Action käyttöön.
  3. Pyydä viisi viimeisintä sarjaottelua annetulta aikaväliltä. Käytä esimerkissä aikaväliä 1. lokakuuta – 17. marraskuuta 2026. Järjestä tulokset utcDate-kentän mukaan ennen viiden uusimman valitsemista. Jos aikaväliltä löytyy vain kolme ottelua, näytä ne ja tarjoa mahdollisuutta hakea vanhempia tuloksia.
Kopioi tulosten Action-kuvaus
Use for Arsenal's recent Premier League form in the requested date window. Sort FINISHED matches newest first, then take up to five. Use both full-time goals and the home and away team IDs to judge each result from Arsenal's perspective.

Lähdesivulla näkyy tulos Liverpool 0, Arsenal 1, ja Arsenalin tekemä vierasmaali on korostettu Etsi ensin Arsenal vierasjoukkueen paikalta ja lue sitten vierasmaalien määrä. Liverpoolin nolla tarkoittaa nollapeliä.

Lue tulokset uusimmasta vanhimpaan. Arsenal voitti Hullin 1–0, voitti Liverpoolin vieraissa 1–0, voitti Evertonin 2–0, voitti Nottingham Forestin vieraissa 1–0 ja voitti Leedsin 2–1. Yhteensä viisi voittoa, seitsemän tehtyä ja yksi päästetty maali. Liverpool-ottelun tiedot ovat hyvä testi, koska voittaja on tuloksessa toisena.

Tallennetussa testidatassa palautettu lista alkaa tarkoituksella Leeds-ottelulla ja päättyy Hull-otteluun. Alkamisajan mukaan lajittelu siirtää Hullin vastauksen alkuun. Avaa Action-vastaus keskustelun viereen ja vertaa listojen ensimmäistä ja viimeistä ottelua.

Viisi päättynyttä Arsenalin ottelua päivämääräjärjestyksessä koti- ja vierasmaaleineen Viisi voittoa voi kätkeä tärkeän yksityiskohdan. Kaksi näistä oli vierasotteluita, joten voittava numero on oikealla.

4. Mistä sarjasijoitus ja pisteet haetaan?

Viisi voittoa kertoo viime viikkojen vireestä. Sarjasijoitukseen vaikuttavat kuitenkin myös kaikki aiemmat ottelut ja muiden joukkueiden tulokset. Anna Agentille erillinen Action sarjataulukkoa varten.

  1. Nimeä se get_league_standings. Valitse GET, liitä päätepiste alle ja jätä syötteet, kyselyparametrit ja runko tyhjiksi. Käytä AI decides, lisää alla oleva kuvaus ja toista vain kirjoitettavan otsikon asetus tälle toiminnolle.
  2. Etsi Test Response-näkymän standings-listasta tietue, jossa type on TOTAL. Etsi sen table-listasta kohta, jossa team.id on 57. Ota Action käyttöön ja kysy ”Monesko Arsenal on Valioliigan sarjataulukossa?”
  3. Vertaa kenttiä position, playedGames ja points lähteen tietoihin samalta kaudelta ja päivältä. Marraskuun 18. päivänä Valioliigan sarjataulukko Native Stats-palvelussa näytti Arsenalin lukemiksi 1. sija, 10 ottelua, 27 pistettä. Ajantasainen sarjataulukko elää muiden seurojen pelien mukaan.
https://api.football-data.org/v4/competitions/PL/standings
Kopioi sarjataulukon Action-kuvaus
Use for the current Premier League table. Find team ID 57 in standings where type is TOTAL. Report season, position, playedGames and points. If the row is missing, say the position is unavailable.

Arsenalin rivi Valioliigan sarjataulukon ensimmäisellä sijalla ja Matchday Notebookin käyttämät kentät Lue yhden rivin poikki kohdassa TOTAL. 27 pistettä kattavat kaikki kymmenen sarjaottelua tilannekuvassa.

5. Voitko jäljittää ottelupäivän tiedot niiden lähteisiin?

Aloita uusi AI Preview-keskustelu. Kysy kolmea seuraavaa ottelua, jatka kysymällä ”Miten pärjäsimme viidessä viimeisessä sarjapelissä?”, anna tuloksille aikaväli ja kysy sitten ”Mikä on sijoituksemme sarjataulukossa?” Avaa Inbox-näkymässä kunkin vastauksen kohdalta suoritetun Actionin merkintä. Actionin View logs-näkymässä voit verrata parametreja ja vastausta siihen, mitä kannattaja näki. Opas API Action:n rakentamiseen näyttää, mistä nämä toiminnot löytyvät.

Saat artikkelin alussa näytetyn ottelupäivän yhteenvedon esittämällä alla olevan kysymyksen tallennetun esimerkin päivämäärillä. Jos haluat ajantasaisen yhteenvedon, käytä tulevia päivämääriä otteluohjelmalle ja menneitä päivämääriä tuloksille.

Arsenal briefing for 18 Nov 2026: next away kickoff this week (UTC), last five since 1 Oct, and table position. Three short lines.

Ottelutoiminnon kutsu kohdassa Quickchat AI pyyntöineen ja palautettuine ottelutietoineen Tarkista kutsusta päivämäärät ja ottelun tunniste. Paikallisessa esimerkissä 560651 on Newcastlen ottelu.

Toistettavaa tarkistusta varten avaa Conversations → Testing, luo tietojoukko ja tallenna kolme kysymystä. Lisää kaksi alla esitettyä raja-arvokysymystä. Suorita tietojoukko muutettuasi toiminnon kuvausta ja tarkista kutsut vastausten rinnalla. Käytä hallittua vastausta harvinaisen tilan tai virheen harjoittamiseen. Pelkkä hypoteettinen kysymys testaa vastauksen sanamuotoa.

Matchday Notebook-tietojoukko Quickchat AI-työkalussa sisältää kysymyksiä otteluohjelmasta, vireestä, sarjataulukosta ja poikkeustapauksista Käytä samoja kysymyksiä jokaisen muokkauksen jälkeen. Vierasottelun tulos paljastaa virheen maalilaskussa, joka jäisi huomaamatta pelkillä kotiotteluilla testatessa.

TestitapausMitä kannattajan pitäisi kuulla
Ottelu on siirretty ja molemmat maalilukemat ovat null. Oliko se tasapeli?Ottelu siirrettiin. Sillä ei ole tallennettua tulosta.
Onnistunut haku palauttaa tyhjän matches-listan. Onko koko kausi tyhjä?Antamallasi aikavälillä ei löytynyt otteluita. Kerro hakemasi päivämäärät.
Palveluntarjoaja palauttaa 401 tai 403.Haku epäonnistui. Tarkista tallennettu tunnus ja kilpailun kattavuus.
Palveluntarjoaja palauttaa 429.Pyyntöjen enimmäismäärä saavutettiin. Yritä hetken kuluttua uudelleen.

Quickchat AI:n tyhjä vastaus onnistuneeseen pyyntöön, joka ei löytänyt otteluita Vaikka vastausikkuna on tyhjä, pyyntö onnistui. Avustaja voi ehdottaa päivämäärien laajentamista.

Jos haluat varmistaa muuttuneen alkamisajan, vertaa sitä liigan julkaistuihin ottelumuutoksiin. Pidä ottelupäivä, aikavyöhyke ja tarkistuspäivä yhdessä tallessa. Ilmainen syöte voi olla jäljessä lähetysaikojen muutoksista, millä on merkitystä, jos joku suunnittelee lauantain menojaan vastauksen perusteella.

Football data provided by the Football-Data.org API. Tässä vanhassa esimerkissä käytetään palveluntarjoajan julkisia Native Stats-sivuja. Katso nykyinen kattavuus ja ajantasaisuus syötteiden hinnoittelusta ja käyttöehdoista.

Usein kysytyt kysymykset

Mitä jalkapallon API-rajapintaa voin käyttää otteluohjelmabottiin?

football-data.org:n v4-rajapinta tarjoaa otteluohjelmat, tulokset ja sarjataulukot tuetuille sarjoille. Käytä joukkueen otteluiden päätepistettä otteluohjelmaan ja viimeisimpiin tuloksiin ja sarjan sarjataulukon päätepistettä sarjasijoitukseen.

Ovatko football-data.org:n tulokset reaaliaikaisia ilmaisversiossa?

Ilmaisversio sisältää viivästetyt tulokset ja otteluohjelmat, sarjataulukot tuetuille sarjoille ja 10 API-kutsua minuutissa. Ilmoita lähde ja päivämäärä jokaisen vastauksen yhteydessä ja tarkista sopimuksesi, jos tarvitset reaaliaikaisia tuloksia.

Miten vaihdan Arsenalin toiseen joukkueeseen?

Etsi seuran joukkuetunnus ja sarja football-data.org:stä. Korvaa joukkue 57 molemmissa ottelutoiminnoissa, muuta numeerista sarjasuodatinta ja sarjataulukon URL-osoitetta ja päivitä sitten seuran nimi ja joukkuetunnus ohjeisiin. Testaa bottia tunnistamallasi ottelulla.

Miten saan viisi viimeisintä ottelua joukkueen näkökulmasta?

Suodata päättyneet sarjaottelut määritetyssä aikaikkunassa, järjestele ne alkamisajan mukaan uusimmasta vanhimpaan ja ota enintään viisi. Tarkista jokaisen tuloksen kohdalla, pelasiko joukkueesi kotona vai vieraissa, ennen kuin merkitset tulokseksi voiton, tasapelin tai tappion. Jos otteluita löytyy alle viisi, kerro kuinka monta löysit.

Mitä tyhjä tulos tarkoittaa lykätylle ottelulle?

Tyhjä tulos tarkoittaa, että palveluntarjoaja ei ole antanut maalien kokonaismäärää kyseiselle joukkueelle. Pidä ottelun tila näkyvissä ja jätä tulos tuntemattomaksi. Maaliton tasapeli edellyttää päättynyttä ottelua, jossa on kaksi kirjattua nollaa.

Miten muunnan jalkapallo-ottelun alkamisajan omalle aikavyöhykkeelleni?

Aloita ottelun UTC-alkamisajasta, käytä nimettyä aikavyöhykettä kuten America/New_York ja säilytä päivämäärä vastauksessa. Kesäaika ja vuorokauden vaihtuminen voivat molemmat vaikuttaa näytettävään aikaan.

Quickchat AI Quickchat AI Ask Quickchat AI a question