Pikaopas

1. Luo testiavain

Kirjaudu kumppaniportaaliin, avaa API-avaimet ja luo TESTI-avain. Kopioi se — avain näytetään vain kerran.

export KL_KEY=kl_test_…

2. Tarkista avain

curl https://api-test-pp.keikkis.fi/v1/me -H "Authorization: Bearer $KL_KEY"

3. Katso työtyyppisi

curl https://api-test-pp.keikkis.fi/v1/work_types -H "Authorization: Bearer $KL_KEY"

Jokaisen koodin mukana on tänään voimassa oleva ALV. Käytä koodia kentässä work_type.

4. Kutsu työntekijä

curl -X POST https://api-test-pp.keikkis.fi/v1/connections \
  -H "Authorization: Bearer $KL_KEY" -H "Content-Type: application/json" \
  -d '{"external_user_id": "u_1842", "email": "aino@example.com"}'

Uusi yhteys on aina pending. Tuotannossa Keikkalasku lähettää kutsun sähköpostilla; voitte näyttää myös linkin connect_url omassa käyttöliittymässänne.

5. Esikatsele keikka

curl -X POST "https://api-test-pp.keikkis.fi/v1/gigs?dry_run=true" \
  -H "Authorization: Bearer $KL_KEY" -H "Content-Type: application/json" \
  -d '{
    "external_id": "hv-2026-11-07-001",
    "date": "2026-11-07",
    "title": "Keikka Tavastialla",
    "work_type": "performing_arts",
    "workers": [
      {"external_user_id": "u_1842", "email": "aino@example.com", "amount": "200.00"}
    ]
  }'

dry_run ajaa kaikki tarkistukset ja rajat ja palauttaa ALV:n ja summat tallentamatta mitään. Se vastaa molemmissa ympäristöissä samoin.

6. Ilmoita keikka

Sama pyyntö ilman dry_run-parametria luo keikan (201). Saman pyynnön uudelleenlähetys palauttaa saman keikan (200); sama external_id eri sisällöllä on 409 idempotency_conflict.

7. Seuraa tilaa

curl "https://api-test-pp.keikkis.fi/v1/gigs?updated_since=2026-11-07T00:00:00Z" \
  -H "Authorization: Bearer $KL_KEY"

Tallenna viimeisin näkemäsi updated_at ja käytä sitä seuraavana updated_since-arvona.

Tuotantoon

Kun Keikkalasku on avannut tuotantokäytön, luo TUOTANTO-avain ja vaihda osoitteeksi https://api-pp.keikkis.fi. Muuta ei tarvitse muuttaa.