# Susitikimų sąrašas

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

Šaltinis: https://diko.app/api-docs/zinynas/list-meetings

Susitikimai · `GET /meetings`

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

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

| 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: `draft`, `recording`, `uploaded`, `processing`, `ready`, `failed`. |
| `archived` | query | `string` | ne | `false` | – | Grąžinti aktyvius (`false`), užarchyvuotus (`true`) arba visus (`all`) elementus. Galimos reikšmės: `false`, `true`, `all`. |
| `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_at`, `updated_at`. |
| `order` | query | `string` | ne | `desc` | – | Rūšiavimo kryptis. Galimos reikšmės: `desc`, `asc`. |
| `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`

- `object` (string, privalomas): Visada `list`.
- `data` (array<object>, privalomas): Šio puslapio elementai.
  - `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.
- `has_more` (boolean, privalomas): Ar yra daugiau elementų. Puslapiuokite, kol reikšmė yra `true`.
- `next_cursor` (string | null, privalomas, ≤ 1024 simbolių): Kito puslapio žymeklis arba `null`, kai `has_more` yra `false`.

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

## Pavyzdžiai

**cURL**

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

**Python**

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

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

## Klaidos

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

| HTTP | Kodas | Reikšmė | Kartoti? |
|---|---|---|---|
| 400 | [`invalid_parameter`](https://diko.app/api-docs/klaidos.md#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`](https://diko.app/api-docs/klaidos.md#invalid_cursor) | `cursor` sugadintas arba išduotas kitam naudotojui, maršrutui, rūšiavimui ar filtrams. | ne |
| 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 |
| 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 |