Muutosloki ja versiointi

#Versiointi

Versio on osoitteessa: /api/v1. V1:n päälle rakennettua työnkulkua tai integraatiota ei tarvitse rakentaa uudelleen, kun AttendBeacon muuttuu, joten v1:n sisällä:

• Lisätään, ei koskaan poisteta. Uusia toimintoja, uusia kenttiä vastauksiin, uusia valinnaisia parametreja, uusia arvoja luetteloihin, kuten webhook-tyyppeihin tai virhekoodeihin. Kirjoita koodi, joka ohittaa sen, mitä se ei tunne.
• Ei koskaan nimetä uudelleen tai poisteta: kenttää, toimintoa, käyttöoikeutta, virhekoodia tai webhook-tyyppiä, kun se on kerran julkaistu.
• Rikkova muutos on v2. Siitä ilmoitetaan täällä ja sähköpostitse jokaiselle työtilalle, jolla on avain, vähintään kuusi kuukautta ennen kuin v1 muuttuu, ja v1 toimii nuo kuusi kuukautta.
• Se, mikä on vanhentumassa, merkitään OpenAPI-kuvauksessa deprecated ja luetellaan täällä poistopäivineen.

Muutoksia tässä mielessä eivät ole: kenttien järjestys rungossa, detail-kentän teksti (haarauta code-kentän perusteella), uudet vastausotsakkeet ja sellaisen vastauksen korjaaminen, joka oli ristiriidassa näiden ohjeiden kanssa.

OpenAPI 3.1 -kuvaus osoitteessa /api/v1/openapi.json on rajapinta sellaisena kuin se on nyt; info.version muuttuu jokaisen lisäyksen myötä.

#2026-10-15: v1.1, kehittäjäalusta

• Aluekohtaiset käyttöoikeudet. Avaimen käyttöoikeudet ovat nyt alue ja pääsytaso (events:read, attendees:write), ja henkilötiedoilla on oma käyttöoikeutensa, people:read. Aiemmin luodut avaimet voivat tehdä täsmälleen saman kuin ennenkin.
• Avaimet vanhenevat ja niiden käyttö kirjataan. Avain voi vanhentua 30, 90, 180 tai 365 päivän kuluttua. Jokainen kutsu näkyy Avainten käyttölokissa, hylätyt mukaan lukien.
• Ongelmakuvaukset. Hylkäykset ovat RFC 9457 -muotoisia application/problem+json-vastauksia, joissa on pysyvä code; error säilyy detail-kentän rinnalla aiemmin rakennettuja työnkulkuja varten.
• Kursorit ja synkronointi. Jokainen luettelo vastaa nextCursor- ja hasMore-kentillä; muuttuvien asioiden luettelot ottavat parametrin updatedSince. page ja pageSize toimivat yhä siellä, missä ne toimivat ennenkin.
• Turvalliset uudelleenyritykset ja muutokset. Idempotency-Key jokaisessa POST-kutsussa; ETag yksittäisissä resursseissa, If-None-Match ja If-Match.
• Kutsurajoitusotsakkeet. RateLimit, RateLimit-Policy ja X-RateLimit-* jokaisessa vastauksessa, Retry-After 429-vastauksen kanssa.
• Uudet toiminnot: työtila; tapahtumaluonnosten luominen, niiden perustietojen muuttaminen ja julkaiseminen; tapahtuman tilastot ja myyntitahti; lipputyypit (ja niiden muuttaminen), lisäpalvelut ja alennuskoodit (ja niiden luominen); tilaus; osallistujien haku; ovien määrät; ohjelmaosuudet (ja niiden lisääminen ja muuttaminen), tilat, ohjelmalinjat ja puhujat; sponsorit ja sponsoritasot; puhujahaun ehdotukset; talkoolaiset ja vuorot; kyselyt, niiden tulokset ja ohjelmaosuuksien arviot; laskut ja hyvityslaskut; budjetin yhteenveto; jakopaketin tulostaulu; yhteisöt ja niiden jäsenet; webhook-päätepisteet, niiden toimitukset, testit ja salaisuudet sekä tapahtumatyypit hyötykuormien skeemoineen.
• Moduulit. Tapahtuman pois kytketty moduuli vastaa päätepisteissään 409 moduleOff. Tämä koskee myös ovia, ovien skannauksia ja sisäänkirjausta (saapumisen kirjaus -moduuli) sekä liidejä (liidimoduuli), jotka vastasivat aiemmin.
• Ihmiset. Ilman people:read-oikeutta osallistujat, ostajat, talkoolaiset ja jäsenet ovat tunnisteita; liidit ja osallistujien haku vaativat sen. Henkilö, joka poisti tietonsa, on erased ilman henkilötietoja.
• Kuvaukset. /api/v1/openapi.json on nyt OpenAPI 3.1 esimerkkeineen ja kaikkine hylkäyksineen; Power Platformin tuoma Swagger 2.0 -kuvaus on osoitteessa /api/v1/swagger.json.
• MCP-palvelin osoitteessa /mcp tekoälyavustajille.

#2026-10-12: v1.0

• Työtilan tapahtumat, osallistujat vastauksineen, tilaukset ja ovien skannaukset parametrilla updatedSince.
• Henkilön ilmoittaminen maksuttomalla lipulla, lipun peruminen ja henkilön kirjaaminen sisään.
• Tilaukset Power Automatelle, Zapierille ja Makelle (/hooks) sekä Standard Webhooks -tavalla allekirjoitetut webhookit.
• Ilmoittautumiskysymykset, niiden JSON-skeema, lipputyypit, ovet ja viimeisimmät liidit työnkulkujen valitsimia ja kenttiä varten.