# Pikaopas

## 1. Luo testiavain

Kirjaudu [kumppaniportaaliin](https://kumppani-pp.keikkis.fi), avaa **API-avaimet** ja luo **TESTI**-avain.
Kopioi se — avain näytetään vain kerran.

```sh
export KL_KEY=kl_test_…
```

## 2. Tarkista avain

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

## 3. Katso työtyyppisi

```sh
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ä

```sh
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

```sh
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

```sh
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.