Gauti susitikimą

Grąžina vieną susitikimą su dalyvių sąrašu, įraše atpažintais dalyviais ir kiekiais.

GET/meetings/{meeting_id}

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

Ne jūsų susitikimas grąžina 404, o ne 403.

Parametrai

Parametrai
Pavadinimas	Vieta	Tipas	Privalomas	Numatytoji reikšmė	Apribojimai	Aprašas
`meeting_id`	path	`string`	privalomas	–	26–26 simbolių · pattern: ^mtg_[0-9A-Za-z]{22}$	Viešas susitikimo ID (priešdėlis `mtg_`).

Atsakymas

200

Susitikimas.

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

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

Pavyzdžiai

Užklausa

cURL

curl "https://api.diko.app/api/v1/meetings/mtg_0aZ1bY2cX3dW4eV5fU6gT7" \
  -H "Authorization: Bearer $DIKO_API_KEY"

Python

import os

import requests

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

TypeScript

const response = await fetch("https://api.diko.app/api/v1/meetings/mtg_0aZ1bY2cX3dW4eV5fU6gT7", {
  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

{
  "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"
  },
  "participants": [
    {
      "id": "prt_6LwrMxamyJTo9VWwrFAvXU",
      "object": "participant",
      "name": "Jonas",
      "email": "jonas@example.com",
      "role": null
    }
  ],
  "speakers": [
    {
      "id": "spk_0deCHcpckGv0OnXkWw7nUx",
      "object": "speaker",
      "label": "SPEAKER_00",
      "name": "Jonas"
    }
  ],
  "counts": {
    "participants": 3,
    "speakers": 2,
    "action_items": 5,
    "comments": 1
  }
}

Klaidos

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

HTTP	Kodas	Reikšmė	Kartoti?
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
404	`not_found`	Resurso nėra, jis nepriklauso jūsų paskyrai arba ID užkoduotas neteisingai.	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