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.
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.
- 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.
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.
Tarkista tilauksesi kohdasta Subscription ja etsi sarjasi kohdasta Available competitions. Tämä ote näyttää UEFA:n Mestarien liigan (CL) ja Bundesliigan (BL1).
- 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. - 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.
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.
- Avaa Actions & MCPs → Add Action → API Action → Create manually. Aseta API Action Name arvoon
get_club_fixturesja When to run arvoon AI decides. Lisää What to ask the user first-kohtaan vaaditut Text-syötteetdate_fromjadate_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”. - Valitse API Endpoint-kohdassa GET ja syötä alla oleva URL-osoite. Avaa Query Params ja aseta
competitionsliteraaliarvoon2021. LisäädateFromjadateTo. Käytä kummankin arvon kohdalla Add AI Data → Parameters lisätäksesi vastaavan päivämääräsyötteen. Jätä Body tyhjäksi. - 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, jossaAccepton avain jaapplication/jsonon arvo. Käytä samoja kahta otsikkoa kaikissa kolmessa toiminnossa.
https://api.football-data.org/v4/teams/57/matches
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.
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.
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.
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.
- 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ää kyselyrivistatuskirjaimellisella arvollaFINISHED. - Aseta alla oleva kuvaus. Toista vain kirjoitettavan otsikon asetus
get_recent_results:lle, tarkista maski ja ota Action käyttöön. - 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.
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 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.
- 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. - Etsi Test Response-näkymän
standings-listasta tietue, jossatypeonTOTAL. Etsi sentable-listasta kohta, jossateam.idon57. Ota Action käyttöön ja kysy ”Monesko Arsenal on Valioliigan sarjataulukossa?” - Vertaa kenttiä
position,playedGamesjapointslä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.
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.
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.
Käytä samoja kysymyksiä jokaisen muokkauksen jälkeen. Vierasottelun tulos paljastaa virheen maalilaskussa, joka jäisi huomaamatta pelkillä kotiotteluilla testatessa.
| Testitapaus | Mitä 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. |
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.