Įvykių sąrašas

Grąžina paskyros įvykius (meeting.*, library.*) nuo seniausio, pagal užfiksavimo tvarką.

GET/events

Reikalingas leidimas: Bet kuris galiojantis raktas. Rezultatai filtruojami pagal rakto leidimus.
Autentifikacija: Authorization: Bearer
Ribų politika: readaccount

Perduokite ankstesnio atsakymo next_cursor kaip cursor, kad tęstumėte; cursor=latest pradeda nuo dabar ir grąžina tuščią puslapį su dabartine pozicija. Grąžinami tik tų šeimų įvykiai, kuriuos raktas gali skaityti. next_cursor yra visada, ir tuščiame puslapyje, todėl sistema, kuri nuolat tikrina įvykius, gali išlaikyti savo vietą.

Parametrai

Parametrai
Pavadinimas	Vieta	Tipas	Privalomas	Numatytoji reikšmė	Apribojimai	Aprašas
`cursor`	query	`string`	ne	–	≤ 128 simbolių	Vieta sraute: ankstesnio puslapio `next_cursor` arba `latest`, kad pradėtumėte nuo dabar.
`types`	query	`array<string>` kartojamas	ne	–	–	Tik šie įvykių tipai (kartokite parametrą), pavyzdžiui, `types=meeting.ready&types=library.import.succeeded`. Nežinomas tipas grąžina 400. Galimos reikšmės: `meeting.readymeeting.failedmeeting.minutes.updatedmeeting.updatedmeeting.deletedlibrary.transcript.addedlibrary.transcript.updatedlibrary.transcript.removedlibrary.import.succeededlibrary.import.failedlibrary.import.canceled`
`limit`	query	`integer`	ne	–	1–100 · format: int32	Puslapio dydis nuo 1 iki 100. Numatytasis 20. Remkitės `has_more`, o ne puslapio dydžiu.

Atsakymas

200

Įvykių puslapis.

RateLimit Labiausiai ribojanti taikyta politika: "pavadinimas";r=<liko užklausų>;t=<sekundės>. t – sekundės iki kitos leidžiamos užklausos (0, kai talpa pilna). Nesiunčiama, kai užklausai ribotuvas netaikytas.
RateLimit-Policy Užklausai taikytos ribų politikos, po vieną elementą "pavadinimas";q=<pradinė talpa>;w=<sekundės> kiekvienai, pavyzdžiui, "read";q=10;w=2, "account";q=20;w=2: q – pradinė talpa, w – sekundės, per kurias tuščia talpa vėl prisipildo. Siunčiama su kiekvienu autentifikuotu atsakymu; nesiunčiama, kai užklausai ribotuvas netaikytas, pavyzdžiui, kai ji atmesta dar nepatikrinus rakto.
Request-Id Šios užklausos ID (priešdėlis req_), toks pat kaip request_id klaidos atsakyme. Siunčiamas ir kaip X-Request-ID. Kreipdamiesi pagalbos nurodykite jį.
X-Client-Request-Id Jūsų siųsta užklausos antraštė X-Client-Request-Id, grąžinta atgal. Grąžinama tik tada, kai jūsų reikšmė turi 1–128 simbolius iš A-Z a-z 0-9 . _ : -.
X-RateLimit-Limit Labiausiai ribojančios politikos pradinė talpa (q antraštėje RateLimit-Policy). Nesiunčiama, kai užklausai ribotuvas netaikytas.
X-RateLimit-Remaining Labiausiai ribojančioje politikoje likusios užklausos (r antraštėje RateLimit). Nesiunčiama, kai užklausai ribotuvas netaikytas.
X-RateLimit-Reset Sekundės iki kitos leidžiamos užklausos labiausiai ribojančioje politikoje (t antraštėje RateLimit; 0, kai talpa pilna). Tai sekundžių skaičius, o ne laiko žyma. Nesiunčiama, kai užklausai ribotuvas netaikytas.

Turinio tipas: application/json

objectstringprivalomas
Visada list.
dataarray<object>privalomas
Šio puslapio elementai.
5 laukai
- idstringprivalomas
  Viešas įvykio ID (priešdėlis evt_). Naudokite dublikatams šalinti.
  26–26 simbolių · pattern: ^evt_[0-9A-Za-z]{22}$
- objectstringprivalomas
  Visada event.
- typestringprivalomas
  Įvykio tipas, pavyzdžiui, meeting.ready. Gali atsirasti naujų tipų; nežinomus ignoruokite.
- timestampstringprivalomas
  Kada įvykis įvyko.
  ≤ 24 simbolių · format: date-time
- dataobjectprivalomas
  Resurso būsenos kopija.
  15 laukų
  - objectstringprivalomas
    Resurso tipas: meeting, library_transcript, library_import arba webhook_endpoint.
  - idstringprivalomas
    Resurso viešas ID.
    ≤ 64 simbolių
  - statusstring | null
    Resurso būsena, susitikimams.
  - archivedboolean | null
    Ar susitikimas užarchyvuotas.
  - minutes_statusstring | null
    Protokolo būsena, susitikimų įvykiams.
  - minutes_versioninteger | null
    Protokolo versija, susitikimų įvykiams.
    0–2147483647 · format: int32
  - run_idstring | null
    Apdorojimo vykdymas, kuriam priklauso įvykis.
  - error_codestring | null
    Klaidos kodas, įvykiams meeting.failed ir library.import.failed.
  - changed_fieldsarray<string> | null
    Pasikeitę laukai, atnaujinimo įvykiams.
  - youtube_video_idstring | null
    YouTube vaizdo įrašo ID, bibliotekos įvykiams.
  - source_typestring | null
    Transkripcijos šaltinis, įvykiui library.transcript.added.
  - added_atstring | null
    Kada transkripcija pridėta, įvykiui library.transcript.added.
    ≤ 24 simbolių · format: date-time
  - summary_statusstring | null
    Santraukos būsena, įvykiui library.transcript.updated.
  - transcript_idstring | null
    Bibliotekos transkripcijos ID, įvykiui library.import.succeeded.
    6–64 simbolių · pattern: ^trn_[A-Za-z0-9_-]+$
  - reusedboolean | null
    Ar transkripcija jau egzistavo, įvykiui library.import.succeeded.
has_morebooleanprivalomas
Ar yra daugiau elementų. Puslapiuokite, kol reikšmė yra true.
next_cursorstringprivalomas
Žymeklis kitai užklausai. Įvykių sraute grąžinamas visada, net kai has_more yra false.
≤ 128 simbolių

Pavyzdžiai

Užklausa

cURL

curl "https://api.diko.app/api/v1/events?cursor=latest&types=meeting.ready" \
  -H "Authorization: Bearer $DIKO_API_KEY"

Python

import os

import requests

response = requests.get(
    "https://api.diko.app/api/v1/events",
    headers={"Authorization": f"Bearer {os.environ['DIKO_API_KEY']}"},
    params={"cursor": "latest", "types": ["meeting.ready"]},
    timeout=30,
)
response.raise_for_status()
print(response.json())

TypeScript

const response = await fetch("https://api.diko.app/api/v1/events?cursor=latest&types=meeting.ready", {
  headers: {
    Authorization: `Bearer ${process.env.DIKO_API_KEY}`,
  },
})
if (!response.ok) throw new Error(`${response.status} ${await response.text()}`)
console.log(await response.json())

Atsakymo pavyzdys · 200 · application/json

JSON

{
  "object": "list",
  "data": [
    {
      "id": "evt_6wRxUNQvdvcZDQqmAzvcqD",
      "object": "event",
      "type": "meeting.ready",
      "timestamp": "2026-10-11T09:30:00.000Z",
      "data": {
        "object": "meeting",
        "id": "mtg_5uF4g2Xu1i0qz3yAp0CP7W",
        "status": "ready",
        "archived": false,
        "minutes_status": "ready",
        "minutes_version": 2,
        "run_id": "f122ed73-1ae0-5816-8fe0-814cdde13471"
      }
    }
  ],
  "has_more": false,
  "next_cursor": "ev1.4821.9917"
}

Klaidos

Šis endpointas gali grąžinti šias klaidas. Visų kodų aprašai yra klaidų kataloge.

HTTP	Kodas	Reikšmė	Kartoti?
400	`invalid_parameter`	Kelio, užklausos ar turinio parametro reikšmė netinkama, privalomo lauko trūksta arba laukas nežinomas (nežinomi laukai atmetami). Lauke `error.param` nurodytas parametras.	ne
400	`invalid_cursor`	`cursor` sugadintas arba išduotas kitam naudotojui, maršrutui, rūšiavimui ar filtrams.	ne
401	`missing_api_key`	Užklausoje nėra antraštės `Authorization`.	ne
401	`invalid_api_key`	Antraštė netinkama (ne `Bearer` schema, tuščias raktas arba kelios antraštės `Authorization`) arba raktas nežinomas ar blogo formato (neatitinka struktūros ar kontrolinės sumos). Atsakymas visais šiais atvejais vienodas.	ne
401	`api_key_expired`	Rakto galiojimas pasibaigė.	ne
401	`api_key_revoked`	Raktas atšauktas: rankiniu būdu, pasibaigus rotacijos persidengimui, dėl nutekėjimo arba išjungus paskyrą.	ne
401	`api_key_disabled`	Raktas laikinai išjungtas.	ne
402	`subscription_required`	Paskyra neturi aktyvios apmokėtos prieigos.	ne
403	`ip_not_allowed`	Raktas turi IP apribojimą, o užklausos IP nėra sąraše arba jo nepavyksta nustatyti patikimai.	ne
403	`account_disabled`	Paskyra išjungta.	ne
403	`email_not_verified`	Paskyros el. paštas nepatvirtintas.	ne
403	`api_access_suspended`	Diko administratorius sustabdė šios paskyros API prieigą.	ne
403	`plan_required`	Planas neapima API. `error.details.required_plans` yra `verslas`.	ne
429	`rate_limit_exceeded`	Viršyta ribų politika. `error.details.policy` nurodo, kuri.	taip, po Retry-After
500	`internal_error`	Vidinė serverio klaida.	sąlygiškai
503	`service_unavailable`	Paslauga laikinai užimta, pavyzdžiui, dėl duomenų bazės apkrovos.	taip, po Retry-After