Kehittäjille

API

keikat.liven avoin REST-rajapinta. Hae keikkoja, keikkapaikkoja ja artisteja JSON-muodossa — tai ilmoita keikkoja ohjelmallisesti. Lukurajapinta on avoin, kirjoittaminen vaatii API-avaimen.

Perusosoite
https://keikat.live/api/v1
Muoto
JSON (UTF-8)

Autentikointi

Kaikki GET-päätepisteet ovat avoimia eivätkä vaadi avainta. Keikkojen ilmoittaminen (POST) vaatii Bearer-API-avaimen otsakkeessa:

Authorization: Bearer klive_xxxxxxxxxxxxxxxxxxxx

Miten saan API-avaimen?

API-avaimen voi luoda vain rekisteröitynyt, kirjautunut käyttäjä (keikkapaikka, artisti tai agentuuri). Avaimet hallitaan Oma hallinta → API-avaimet -sivulla.

Täysi dokumentaatio kirjautuneille

Päätepisteet, hakuparametrit, koodiesimerkit ja keikan ilmoituskentät näkyvät, kun kirjaudut sisään. API-avaimen voi luoda vain rekisteröitynyt käyttäjä.

Reilu käyttö & lisenssi

Rajapinta on tarkoitettu kohtuulliseen käyttöön. Vältä tarpeetonta kuormaa ja välimuistita vastauksia. Osa keikkadatasta on peräisin avoimista lähteistä (mm. Helsinki Linked Events, CC BY 4.0); mainitse lähde keikat.live tietoja käyttäessäsi.