Susitikimų sąrašas

Grąžina jūsų susitikimus: naujausi pirmi, jei nenurodyta kitaip.

GET/meetings

Reikalingas leidimas: meetings:read
Autentifikacija: Authorization: Bearer
Ribų politika: readaccount

Užarchyvuoti susitikimai paslėpti, nebent archived nurodo kitaip. Sąrašo elementuose nėra participants, speakers ir counts; juos gausite paėmę vieną susitikimą. Kiekvienas elementas turi dabartinį transcript.revision, kurio apskaičiavimas trunka proporcingai jo transkripto ilgiui, todėl labai ilgų susitikimų puslapiai atsako lėčiau: peržiūrėdami visą istoriją naudokite mažesnį limit.

Parametrai

Parametrai
Pavadinimas	Vieta	Tipas	Privalomas	Numatytoji reikšmė	Apribojimai	Aprašas
`status`	query	`array<string>` kartojamas	ne	–	–	Filtras pagal išvestinę būseną. Kartokite parametrą, kad atitiktų kelios (`status=ready&status=failed`). Galimos reikšmės: `draftrecordinguploadedprocessingreadyfailed`
`archived`	query	`string`	ne	`false`	–	Grąžinti aktyvius (`false`), užarchyvuotus (`true`) arba visus (`all`) elementus. Galimos reikšmės: `falsetrueall`
`created_after`	query	`string`	ne	–	≤ 64 simbolių	Tik po šio momento sukurti susitikimai (išskirtinė riba). RFC 3339 data arba data ir laikas. Lyginama milisekundėmis, kaip ir atsakymų laiko žymos, todėl atsakyme gautą laiko žymą galima perduoti atgal ir to paties elemento negausite dar kartą.
`created_before`	query	`string`	ne	–	≤ 64 simbolių	Tik prieš šį momentą sukurti susitikimai (išskirtinė riba). RFC 3339 data arba data ir laikas. Lyginama milisekundėmis, kaip ir atsakymų laiko žymos, todėl atsakyme gautą laiko žymą galima perduoti atgal ir to paties elemento negausite dar kartą.
`updated_after`	query	`string`	ne	–	≤ 64 simbolių	Tik po šio momento pakeisti susitikimai (išskirtinė riba). RFC 3339 data arba data ir laikas. Lyginama milisekundėmis, kaip ir atsakymų laiko žymos, todėl atsakyme gautą laiko žymą galima perduoti atgal ir to paties elemento negausite dar kartą.
`q`	query	`string`	ne	–	≤ 200 simbolių	Paieška pavadinime.
`sort`	query	`string`	ne	`created_at`	–	Laukas, pagal kurį rūšiuojama. Galimos reikšmės: `created_atupdated_at`
`order`	query	`string`	ne	`desc`	–	Rūšiavimo kryptis. Galimos reikšmės: `descasc`
`limit`	query	`integer`	ne	`20`	1–100 · format: int32	Puslapio dydis nuo 1 iki 100. Numatytasis 20. Remkitės `has_more`, o ne puslapio dydžiu.
`cursor`	query	`string`	ne	–	≤ 1024 simbolių	Neskaidrus žymeklis iš ankstesnio puslapio `next_cursor`. Žymekliai pririšti prie naudotojo, maršruto, rūšiavimo ir filtrų.

Atsakymas

200

Susitikimų 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.
17 laukų
- idstringprivalomas
  Viešas susitikimo ID (priešdėlis mtg_).
  26–26 simbolių · pattern: ^mtg_[0-9A-Za-z]{22}$
- objectstringprivalomas
  Visada meeting.
- titlestringprivalomas
  Susitikimo pavadinimas.
- languagestring | nullprivalomas
  Susitikimo kalbos kodas, pavyzdžiui, lt.
- statusstringprivalomas
  Išvestinė būsena. Užarchyvuoti susitikimai išlaiko naujausio apdorojimo vykdymo būseną.
  Galimos reikšmės: draftrecordinguploadedprocessingreadyfailed
- archivedbooleanprivalomas
  Ar susitikimas užarchyvuotas.
- created_atstringprivalomas
  Kada susitikimas sukurtas.
  ≤ 24 simbolių · format: date-time
- updated_atstringprivalomas
  Kada susitikimas paskutinį kartą pakeistas.
  ≤ 24 simbolių · format: date-time
- started_atstring | nullprivalomas
  Tikroji pradžia arba null, kol nežinoma. Ji nesutapatinama su created_at.
  ≤ 24 simbolių · format: date-time
- duration_msinteger | nullprivalomas
  Trukmė milisekundėmis arba null.
  0–9007199254740991 · format: int64
- web_urlstringprivalomas
  Nuoroda į susitikimą Diko programėlėje.
  format: uri
- processingobjectprivalomas
  Naujausias apdorojimo vykdymas.
  3 laukai
  - statusstring | nullprivalomas
    Apdorojimo būsena arba null, kai vykdymo nėra.
    Galimos reikšmės: queuedtranscribingdiarizingsummarizingcompletefailedcanceled
  - progressnumber | nullprivalomas
    Eiga nuo 0 iki 1 arba null.
    0–1
  - errorobject | nullprivalomas
    Klaidos duomenys, kai apdorojimas nepavyko.
    2 laukai
    codestringprivalomas
    Stabilus klaidos kodas. Nežinomi vidiniai kodai pateikiami kaip internal_error.
    Galimos reikšmės: upload_unavailableaudio_invalidaudio_too_longtranscription_failedtranscription_timeoutprovider_limitcanceledinternal_error
    messagestringprivalomas
    Paaiškinimas Accept-Language kalba. Niekada ne vidinis klaidos tekstas.
- transcriptobjectprivalomas
  Transkripto santrauka.
  4 laukai
  - statusstringprivalomas
    Transkripto būsena.
    Galimos reikšmės: noneprocessingready
  - revisionstring | nullprivalomas
    Neskaidrus žetonas, kuris pasikeičia keičiantis bet kuriam segmentui.
  - segment_countintegerprivalomas
    Segmentų skaičius.
    0–2147483647 · format: int32
  - has_pending_editsbooleanprivalomas
    Ar Diko laukia gramatikos pasiūlymų patvirtinimo.
- minutesobjectprivalomas
  Protokolo santrauka.
  3 laukai
  - statusstringprivalomas
    Protokolo būsena.
    Galimos reikšmės: nonegeneratingreadyfailedinsufficientunavailable
  - versioninteger | nullprivalomas
    Naujausio paruošto protokolo versijos numeris.
    0–2147483647 · format: int32
  - verification_statusstring | nullprivalomas
    Faktų patikros rezultatas: patikrinta, ištaisyta antruoju praėjimu arba nepatikrinta.
    Galimos reikšmės: verifiedrepairedunverified
- participantsarray<object>
  Dalyviai. Tik vieno susitikimo atsakyme.
  5 laukai
  - idstringprivalomas
    Viešas dalyvio ID (priešdėlis prt_).
    26–26 simbolių · pattern: ^prt_[0-9A-Za-z]{22}$
  - objectstringprivalomas
    Visada participant.
  - namestring | nullprivalomas
    Dalyvio vardas.
  - emailstring | nullprivalomas
    Dalyvio el. pašto adresas, jei žinomas.
  - rolestring | nullprivalomas
    Dalyvio vaidmuo, jei žinomas.
- speakersarray<object>
  Įraše atpažinti dalyviai. Tik vieno susitikimo atsakyme.
  4 laukai
  - idstringprivalomas
    Viešas įraše atpažinto dalyvio ID (priešdėlis spk_).
    26–26 simbolių · pattern: ^spk_[0-9A-Za-z]{22}$
  - objectstringprivalomas
    Visada speaker.
  - labelstringprivalomas
    Automatinė žyma, pavyzdžiui, SPEAKER_00.
  - namestring | nullprivalomas
    Įraše atpažintam dalyviui priskirtas vardas, jei yra.
- countsobject
  Skaičiai. Tik vieno susitikimo atsakyme.
  4 laukai
  - participantsintegerprivalomas
    Dalyvių skaičius.
    0–2147483647 · format: int32
  - speakersintegerprivalomas
    Įraše atpažintų dalyvių skaičius.
    0–2147483647 · format: int32
  - action_itemsintegerprivalomas
    Užduočių skaičius.
    0–2147483647 · format: int32
  - commentsintegerprivalomas
    Komentarų skaičius.
    0–2147483647 · format: int32
has_morebooleanprivalomas
Ar yra daugiau elementų. Puslapiuokite, kol reikšmė yra true.
next_cursorstring | nullprivalomas
Kito puslapio žymeklis arba null, kai has_more yra false.
≤ 1024 simbolių

Pavyzdžiai

Užklausa

cURL

curl "https://api.diko.app/api/v1/meetings?status=ready&limit=20" \
  -H "Authorization: Bearer $DIKO_API_KEY"

Python

import os

import requests

response = requests.get(
    "https://api.diko.app/api/v1/meetings",
    headers={"Authorization": f"Bearer {os.environ['DIKO_API_KEY']}"},
    params={"status": ["ready"], "limit": 20},
    timeout=30,
)
response.raise_for_status()
print(response.json())

TypeScript

const response = await fetch("https://api.diko.app/api/v1/meetings?status=ready&limit=20", {
  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": "mtg_5uF4g2Xu1i0qz3yAp0CP7W",
      "object": "meeting",
      "title": "Pardavimų aptarimas",
      "language": "lt",
      "status": "ready",
      "archived": false,
      "created_at": "2026-10-11T08:00:00.000Z",
      "updated_at": "2026-10-11T09:30:00.000Z",
      "started_at": null,
      "duration_ms": 3541000,
      "web_url": "https://studio.diko.app/meetings/c2171dae-bbc2-53b3-92b9-ba8c37850ff6",
      "processing": {
        "status": "complete",
        "progress": 1,
        "error": null
      },
      "transcript": {
        "status": "ready",
        "revision": "r_1bedcb71b3a1fdc6bfeeb92054fc6f92",
        "segment_count": 412,
        "has_pending_edits": false
      },
      "minutes": {
        "status": "ready",
        "version": 2,
        "verification_status": "verified"
      }
    }
  ],
  "has_more": false,
  "next_cursor": null
}

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
403	`insufficient_scope`	Raktas neturi endpointui reikalingo leidimo. `error.details` turi `required_scopes` ir `granted_scopes`.	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