Susitikimo protokolas

Grąžina naujausią paruoštą protokolo versiją.

GET/meetings/{meeting_id}/minutes

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

Kai paruoštos versijos nėra, atsakymas vis tiek yra 200, o status paaiškina kodėl: none, generating, failed, insufficient arba unavailable.

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

Protokolas.

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 minutes.
meeting_idstringprivalomas
Susitikimo ID.
26–26 simbolių · pattern: ^mtg_[0-9A-Za-z]{22}$
statusstringprivalomas
Protokolo būsena.
Galimos reikšmės: nonegeneratingreadyfailedinsufficientunavailable
reasonstring | nullprivalomas
Priežastis, kai būsena insufficient.
versioninteger | nullprivalomas
Versijos numeris.
0–2147483647 · format: int32
generated_atstring | nullprivalomas
Kada ši versija sugeneruota.
≤ 24 simbolių · format: date-time
languagestring | nullprivalomas
Protokolo kalba.
summarystring | nullprivalomas
Santraukos tekstas.
key_pointsarray<object>privalomas
Pagrindiniai punktai.
2 laukai
- textstringprivalomas
  Teiginys.
- timestamps_msarray<integer>privalomas
  Įrašo momentai, patvirtinantys teiginį, milisekundėmis.
decisionsarray<object>privalomas
Sprendimai.
2 laukai
- textstringprivalomas
  Teiginys.
- timestamps_msarray<integer>privalomas
  Įrašo momentai, patvirtinantys teiginį, milisekundėmis.
action_itemsarray<object>privalomas
Sugeneruotos užduotys.
11 laukų
- objectstringprivalomas
  Visada action_item.
- idstring | nullprivalomas
  Viešas ID (priešdėlis act_). null sugeneruotoms užduotims.
  26–26 simbolių · pattern: ^act_[0-9A-Za-z]{22}$
- sourcestringprivalomas
  Iš kur užduotis.
  Galimos reikšmės: manualgenerated
- textstringprivalomas
  Užduoties pavadinimas.
- descriptionstring | nullprivalomas
  Ilgesnis aprašas, jei yra.
- statusstringprivalomas
  Užduoties būsena. Sugeneruotos užduotys visada open.
  Galimos reikšmės: openin_progressdonecanceled
- assignee_namestring | nullprivalomas
  Atsakingo asmens vardas.
- due_textstring | nullprivalomas
  Laisvo teksto terminas iš sugeneruoto protokolo.
- due_atstring | nullprivalomas
  Rankinės užduoties terminas.
  ≤ 24 simbolių · format: date-time
- timestamps_msarray<integer>privalomas
  Įrašo momentai, iš kurių paimta užduotis, milisekundėmis.
- created_atstring | nullprivalomas
  Kada sukurta rankinė užduotis. null sugeneruotoms užduotims.
  ≤ 24 simbolių · format: date-time
open_questionsarray<object>privalomas
Atviri klausimai.
2 laukai
- textstringprivalomas
  Teiginys.
- timestamps_msarray<integer>privalomas
  Įrašo momentai, patvirtinantys teiginį, milisekundėmis.
sectionsarray<object>privalomas
Papildomi skyriai.
2 laukai
- titlestringprivalomas
  Skyriaus pavadinimas.
- contentstringprivalomas
  Skyriaus tekstas.
verification_statusstring | nullprivalomas
Faktų patikros rezultatas.
Galimos reikšmės: verifiedrepairedunverified

Pavyzdžiai

Užklausa

cURL

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

Python

import os

import requests

response = requests.get(
    "https://api.diko.app/api/v1/meetings/mtg_0aZ1bY2cX3dW4eV5fU6gT7/minutes",
    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/minutes", {
  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": "minutes",
  "meeting_id": "mtg_5uF4g2Xu1i0qz3yAp0CP7W",
  "status": "ready",
  "reason": null,
  "version": 2,
  "generated_at": "2026-10-11T09:30:00.000Z",
  "language": "lt",
  "summary": "Aptartas pasiūlymo kainodaros pakeitimas ir kiti žingsniai iki mėnesio pabaigos.",
  "key_points": [
    {
      "text": "Nauja kainodara įsigalioja nuo lapkričio 1 d.",
      "timestamps_ms": []
    }
  ],
  "decisions": [
    {
      "text": "Pasiūlymą klientui išsiunčiame šią savaitę.",
      "timestamps_ms": [
        754000
      ]
    }
  ],
  "action_items": [
    {
      "object": "action_item",
      "id": null,
      "source": "generated",
      "text": "Išsiųsti pasiūlymą",
      "description": null,
      "status": "open",
      "assignee_name": "Jonas",
      "due_text": null,
      "due_at": null,
      "timestamps_ms": [],
      "created_at": null
    }
  ],
  "open_questions": [
    {
      "text": "Ar nuolaida taikoma ir esamiems klientams?",
      "timestamps_ms": []
    }
  ],
  "sections": [
    {
      "title": "Kainodara",
      "content": "Kainos peržiūrimos kartą per ketvirtį.\nNuolaidos taikomos nuo trečios licencijos."
    }
  ],
  "verification_status": "verified"
}

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