# Gauti susitikimą

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

Šaltinis: https://diko.app/api-docs/zinynas/get-meeting

Susitikimai · `GET /meetings/{meeting_id}`

- **Bazinis URL:** https://api.diko.app/api/v1
- **Reikalingas leidimas:** `meetings:read`
- **Ribų politika:** `read`, `account`
- **Autentifikacija:** `Authorization: Bearer dk_live_...`

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

## Parametrai

| Pavadinimas | Vieta | Tipas | Privalomas | Numatytoji reikšmė | Apribojimai | Aprašas |
|---|---|---|---|---|---|---|
| `meeting_id` | path | `string` | taip | – | 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`

- `id` (string, privalomas, 26–26 simbolių, pattern: ^mtg_[0-9A-Za-z]{22}$): Viešas susitikimo ID (priešdėlis `mtg_`).
- `object` (string, privalomas): Visada `meeting`.
- `title` (string, privalomas): Susitikimo pavadinimas.
- `language` (string | null, privalomas): Susitikimo kalbos kodas, pavyzdžiui, `lt`.
- `status` (string, privalomas): Išvestinė būsena. Užarchyvuoti susitikimai išlaiko naujausio apdorojimo vykdymo būseną. Galimos reikšmės: `draft`, `recording`, `uploaded`, `processing`, `ready`, `failed`.
- `archived` (boolean, privalomas): Ar susitikimas užarchyvuotas.
- `created_at` (string, privalomas, ≤ 24 simbolių, format: date-time): Kada susitikimas sukurtas.
- `updated_at` (string, privalomas, ≤ 24 simbolių, format: date-time): Kada susitikimas paskutinį kartą pakeistas.
- `started_at` (string | null, privalomas, ≤ 24 simbolių, format: date-time): Tikroji pradžia arba `null`, kol nežinoma. Ji nesutapatinama su `created_at`.
- `duration_ms` (integer | null, privalomas, 0–9007199254740991, format: int64): Trukmė milisekundėmis arba `null`.
- `web_url` (string, privalomas, format: uri): Nuoroda į susitikimą Diko programėlėje.
- `processing` (object, privalomas): Naujausias apdorojimo vykdymas.
  - `status` (string | null, privalomas): Apdorojimo būsena arba `null`, kai vykdymo nėra. Galimos reikšmės: `queued`, `transcribing`, `diarizing`, `summarizing`, `complete`, `failed`, `canceled`.
  - `progress` (number | null, privalomas, 0–1): Eiga nuo 0 iki 1 arba `null`.
  - `error` (object | null, privalomas): Klaidos duomenys, kai apdorojimas nepavyko.
    - `code` (string, privalomas): Stabilus klaidos kodas. Nežinomi vidiniai kodai pateikiami kaip `internal_error`. Galimos reikšmės: `upload_unavailable`, `audio_invalid`, `audio_too_long`, `transcription_failed`, `transcription_timeout`, `provider_limit`, `canceled`, `internal_error`.
    - `message` (string, privalomas): Paaiškinimas `Accept-Language` kalba. Niekada ne vidinis klaidos tekstas.
- `transcript` (object, privalomas): Transkripto santrauka.
  - `status` (string, privalomas): Transkripto būsena. Galimos reikšmės: `none`, `processing`, `ready`.
  - `revision` (string | null, privalomas): Neskaidrus žetonas, kuris pasikeičia keičiantis bet kuriam segmentui.
  - `segment_count` (integer, privalomas, 0–2147483647, format: int32): Segmentų skaičius.
  - `has_pending_edits` (boolean, privalomas): Ar Diko laukia gramatikos pasiūlymų patvirtinimo.
- `minutes` (object, privalomas): Protokolo santrauka.
  - `status` (string, privalomas): Protokolo būsena. Galimos reikšmės: `none`, `generating`, `ready`, `failed`, `insufficient`, `unavailable`.
  - `version` (integer | null, privalomas, 0–2147483647, format: int32): Naujausio paruošto protokolo versijos numeris.
  - `verification_status` (string | null, privalomas): Faktų patikros rezultatas: patikrinta, ištaisyta antruoju praėjimu arba nepatikrinta. Galimos reikšmės: `verified`, `repaired`, `unverified`.
- `participants` (array<object>, neprivalomas): Dalyviai. Tik vieno susitikimo atsakyme.
  - `id` (string, privalomas, 26–26 simbolių, pattern: ^prt_[0-9A-Za-z]{22}$): Viešas dalyvio ID (priešdėlis `prt_`).
  - `object` (string, privalomas): Visada `participant`.
  - `name` (string | null, privalomas): Dalyvio vardas.
  - `email` (string | null, privalomas): Dalyvio el. pašto adresas, jei žinomas.
  - `role` (string | null, privalomas): Dalyvio vaidmuo, jei žinomas.
- `speakers` (array<object>, neprivalomas): Įraše atpažinti dalyviai. Tik vieno susitikimo atsakyme.
  - `id` (string, privalomas, 26–26 simbolių, pattern: ^spk_[0-9A-Za-z]{22}$): Viešas įraše atpažinto dalyvio ID (priešdėlis `spk_`).
  - `object` (string, privalomas): Visada `speaker`.
  - `label` (string, privalomas): Automatinė žyma, pavyzdžiui, `SPEAKER_00`.
  - `name` (string | null, privalomas): Įraše atpažintam dalyviui priskirtas vardas, jei yra.
- `counts` (object, neprivalomas): Skaičiai. Tik vieno susitikimo atsakyme.
  - `participants` (integer, privalomas, 0–2147483647, format: int32): Dalyvių skaičius.
  - `speakers` (integer, privalomas, 0–2147483647, format: int32): Įraše atpažintų dalyvių skaičius.
  - `action_items` (integer, privalomas, 0–2147483647, format: int32): Užduočių skaičius.
  - `comments` (integer, privalomas, 0–2147483647, format: int32): Komentarų skaičius.

```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
  }
}
```

## Pavyzdžiai

**cURL**

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

**Python**

```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**

```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())
```

## Klaidos

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

| HTTP | Kodas | Reikšmė | Kartoti? |
|---|---|---|---|
| 401 | [`missing_api_key`](https://diko.app/api-docs/klaidos.md#missing_api_key) | Užklausoje nėra antraštės `Authorization`. | ne |
| 401 | [`invalid_api_key`](https://diko.app/api-docs/klaidos.md#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`](https://diko.app/api-docs/klaidos.md#api_key_expired) | Rakto galiojimas pasibaigė. | ne |
| 401 | [`api_key_revoked`](https://diko.app/api-docs/klaidos.md#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`](https://diko.app/api-docs/klaidos.md#api_key_disabled) | Raktas laikinai išjungtas. | ne |
| 402 | [`subscription_required`](https://diko.app/api-docs/klaidos.md#subscription_required) | Paskyra neturi aktyvios apmokėtos prieigos. | ne |
| 403 | [`ip_not_allowed`](https://diko.app/api-docs/klaidos.md#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`](https://diko.app/api-docs/klaidos.md#account_disabled) | Paskyra išjungta. | ne |
| 403 | [`email_not_verified`](https://diko.app/api-docs/klaidos.md#email_not_verified) | Paskyros el. paštas nepatvirtintas. | ne |
| 403 | [`api_access_suspended`](https://diko.app/api-docs/klaidos.md#api_access_suspended) | Diko administratorius sustabdė šios paskyros API prieigą. | ne |
| 403 | [`plan_required`](https://diko.app/api-docs/klaidos.md#plan_required) | Planas neapima API. `error.details.required_plans` yra `verslas`. | ne |
| 403 | [`insufficient_scope`](https://diko.app/api-docs/klaidos.md#insufficient_scope) | Raktas neturi endpointui reikalingo leidimo. `error.details` turi `required_scopes` ir `granted_scopes`. | ne |
| 404 | [`not_found`](https://diko.app/api-docs/klaidos.md#not_found) | Resurso nėra, jis nepriklauso jūsų paskyrai arba ID užkoduotas neteisingai. | ne |
| 429 | [`rate_limit_exceeded`](https://diko.app/api-docs/klaidos.md#rate_limit_exceeded) | Viršyta ribų politika. `error.details.policy` nurodo, kuri. | taip, po Retry-After |
| 500 | [`internal_error`](https://diko.app/api-docs/klaidos.md#internal_error) | Vidinė serverio klaida. | sąlygiškai |
| 503 | [`service_unavailable`](https://diko.app/api-docs/klaidos.md#service_unavailable) | Paslauga laikinai užimta, pavyzdžiui, dėl duomenų bazės apkrovos. | taip, po Retry-After |