# Pakeitimai

> Diko API pakeitimų žurnalas ir tai, ko dar nėra.

Šaltinis: https://diko.app/api-docs/pakeitimai

Čia aprašomi visi viešo API pakeitimai: ir suderinami, ir (ateityje) nesuderinami. Suderinamumo pažadai: [Versijos ir suderinamumas](https://diko.app/api-docs/versijos.md).

## 2026-10-15: didesnė eksporto riba ir `me`/`export` atsakyme `GET /me`

- Politika `export` (transkriptai su `format=text`, `srt` ar `vtt`) dabar turi 10 užklausų pradinę talpą ir pildosi **1 užklausa per sekundę** (anksčiau – 4 užklausų pradinė talpa ir 1 užklausa per 5 sekundes). 100 susitikimų sinchronizuoti dabar užtenka maždaug dviejų minučių vietoje aštuonių.
- `GET /me` atsakymo lauke `limits.rate` dabar išvardytos ir politikos `me` bei `export`, tokio pat `burst` / `per_second` pavidalo. Nauji laukai yra papildomi: klientams, kurie nepažįstamų laukų nepaiso, nieko keisti nereikia.

## 2026-10-12: saugumo pakeitimas

- **Saugumo pakeitimas:** `GET /me` dabar atskleidžia mažiau nei anksčiau. [Versijos ir suderinamumas](https://diko.app/api-docs/versijos.md) leidžia šią išimtį saugumo pataisoms. `GET /me` laikosi mažiausių privilegijų principo: `user.email` visada paslėptas (pvz., `j***@example.com`), o `credits` grąžinamas tik raktui su leidimu `library:write` (tik jis naudoja kreditus). Kitiems raktams `credits: null`. Pilną adresą ir likutį matysite Diko programėlėje.
- Webhook adresai tikrinami pagal aiškią specialiųjų adresų lentelę. Atmetami vietinis NAT64 prefiksas `64:ff9b:1::/48`, 6to4, Teredo ir dokumentacijos diapazonai. Žinomas NAT64 prefiksas `64:ff9b::/96` priimamas tik tada, kai įterptas IPv4 adresas yra viešas.

## v1.0

Data: 2026-10-11. Pirmoji vieša `/v1` versija.

**Raktai ir autentifikacija**

- `Bearer` raktai `dk_live_...` su kontroline suma, privalomu galiojimu (iki 365 d.), rotacija su persidengimu, IP apribojimu ir komandos priežiūra.
- Trys leidimai: `meetings:read`, `library:read`, `library:write`.
- Raktų ir webhooks valdymas Diko programėlėje, skiltyje **Nustatymai → API** (`/settings/api`; pirmajame leidime buvo kelias `/kurejams`, kuris nukreipia čia).

**Endpointai**

- Paskyra: `GET /`, `GET /me`.
- Susitikimai: sąrašas, vienas susitikimas, transkriptas (JSON, tekstas, SRT, VTT), protokolas, užduotys.
- Biblioteka: transkripcijų sąrašas, viena transkripcija, transkripto tekstas.
- Importai: YouTube vaizdo įrašų importas su `Idempotency-Key`, importų sąrašas, importo būsena ir atšaukimas.
- Įvykiai: `GET /events` ir `GET /events/{event_id}`.

**Įvykiai ir webhooks**

- 12 įvykių tipų (`meeting.*`, `library.*`, `webhook.test`).
- Webhooks pagal Standard Webhooks 1.0: parašai, pakartojimai, paslapties rotacija, pristatymų žurnalas.

**Bendros taisyklės**

- Vieningas klaidų formatas su `request_id` ir `doc_url`, klaidų katalogas lietuvių ir anglų kalbomis.
- Ribų antraštės (`RateLimit-Policy`, `RateLimit`, `X-RateLimit-*`).
- Žymekliais pagrįstas puslapiavimas, `Idempotency-Key`, OpenAPI 3.1 aprašas.

## Planuojama

Šie dalykai dar nepalaikomi `v1`. Jie pateikiami kaip kryptis, be datų, ir gali keistis.

- **v1.1:** semantinė paieška bibliotekoje, susitikimo garso įkėlimas per API, komandos servisiniai raktai, SDK (Python ir TypeScript), Postman kolekcija, webhooks valdymas per API.
- **v1.2:** OAuth 2.0 trečiųjų šalių programėlėms (pavyzdžiui, Zapier ir Make) ir MCP serveris.

## Kaip sekti pakeitimus

- Šį puslapį galite perskaityti ir kaip [Markdown](https://diko.app/api-docs/pakeitimai.md).
- Visas API aprašas yra [`/api-docs/openapi.json`](https://diko.app/api-docs/openapi.json); palyginkite jį su ankstesne kopija.
- Nesuderinamus pakeitimus skelbiame iš anksto, kaip aprašyta puslapyje [Versijos ir suderinamumas](https://diko.app/api-docs/versijos.md).