Pakeitimai

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

Čia aprašomi visi viešo API pakeitimai: ir suderinami, ir (ateityje) nesuderinami. Suderinamumo pažadai: Versijos ir suderinamumas.

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.

Saugumo pakeitimas: GET /me dabar atskleidžia mažiau nei anksčiau. Versijos ir suderinamumas 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.

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.

Š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.

Šį puslapį galite perskaityti ir kaip Markdown.
Visas API aprašas yra /api-docs/openapi.json; palyginkite jį su ankstesne kopija.
Nesuderinamus pakeitimus skelbiame iš anksto, kaip aprašyta puslapyje Versijos ir suderinamumas.