REST API reference.

Malé, předvídatelné JSON API nad vašimi schůzkami. Vypište je, načtěte jednu s jejím přepisem a výstupy, hledejte napříč všemi hovory a položte otázku k jedné schůzce. Autentizace přes bearer token, JSON na vstupu i výstupu.

Základní URL

Každá cesta níže je relativní k této základní URL. Všechny odpovědi jsou application/json.

Autentizace

Autentizujte se pomocí Notabium API klíče, vytvořeného v aplikaci na stránce API keys. Pošlete ho jako bearer token u každého požadavku:

Authorization: Bearer ntb_live_...

Požadavek bez klíče nebo s neplatným či zrušeným klíčem vrátí 401. Klíče slouží pouze ke čtení a dotazování (viz rozsah níže).

Rozsah a limity

API klíče mohou používat endpointy pro čtení a dotazování uvedené na této stránce. Nemohou vytvářet ani mazat schůzky, měnit sdílení, spravovat fakturaci ani spravovat jiné API klíče. To vyžaduje přihlášenou relaci v aplikaci a při pokusu s klíčem vrátí 403 {"error":"session_required"}. Spravujte a rušte své klíče na stránce API keys. Buďte rozumní s objemem požadavků; trvalé intenzivní používání může být omezeno.

Endpointy

Výpis schůzek

GET /v1/meetings?limit=&offset=

Vrátí vaše nejnovější schůzky, od nejnovější. limit je výchozí 50 (max 200).

Požadavek

curl https://api.notabium.com/v1/meetings \
  -H "Authorization: Bearer ntb_live_..."

Odpověď 200

{
  "meetings": [
    {
      "id": "6f1c2e8a-2b4d-4a1e-9c3f-7a0b1d2e3f44",
      "source": "extension_meet",
      "title": "Pricing sync with Acme",
      "platform": "google_meet",
      "status": "complete",
      "duration_s": 1840,
      "created_at": "2026-06-08T15:02:11.000Z",
      "completed_at": "2026-06-08T15:34:02.000Z"
    }
  ]
}

Získání schůzky

GET /v1/meetings/:id

Vrátí záznam schůzky, její transcript (nebo null, pokud ještě není přepsaná) a její pole outputs. Výstupy jsou artefakty vygenerované AI; každý má kind typu summary, next_steps nebo email_draft. Vrátí 404, pokud schůzka neexistuje nebo není vaše.

Požadavek

curl https://api.notabium.com/v1/meetings/6f1c2e8a-2b4d-4a1e-9c3f-7a0b1d2e3f44 \
  -H "Authorization: Bearer ntb_live_..."

Odpověď 200

{
  "meeting": {
    "id": "6f1c2e8a-2b4d-4a1e-9c3f-7a0b1d2e3f44",
    "title": "Pricing sync with Acme",
    "source": "extension_meet",
    "platform": "google_meet",
    "status": "complete",
    "duration_s": 1840,
    "lang": "en",
    "created_at": "2026-06-08T15:02:11.000Z",
    "completed_at": "2026-06-08T15:34:02.000Z"
  },
  "transcript": {
    "meeting_id": "6f1c2e8a-2b4d-4a1e-9c3f-7a0b1d2e3f44",
    "full_text": "Alex: Let's lock the pricing tiers before launch. Sam: Agreed, I think 19.99 holds...",
    "lang": "en"
  },
  "outputs": [
    {
      "kind": "summary",
      "content": "The team agreed to keep Pro at 19.99/mo and ship a 7-day trial..."
    },
    {
      "kind": "next_steps",
      "content": "1. Sam updates the pricing page. 2. Alex drafts the launch email..."
    },
    {
      "kind": "email_draft",
      "content": "Hi team, quick recap of today's pricing sync..."
    }
  ],
  "is_owner": true
}

Hledání schůzek

GET /v1/meetings/search?q=...&limit=

Hledání bez rozlišování velikosti písmen v názvech vašich schůzek a textu přepisu. limit je výchozí 20 (max 50). Každý výsledek obsahuje krátký snippet kolem první shody (text přepisu, pokud je k dispozici, jinak název).

Požadavek

curl "https://api.notabium.com/v1/meetings/search?q=pricing" \
  -H "Authorization: Bearer ntb_live_..."

Odpověď 200

{
  "meetings": [
    {
      "id": "6f1c2e8a-2b4d-4a1e-9c3f-7a0b1d2e3f44",
      "title": "Pricing sync with Acme",
      "platform": "google_meet",
      "created_at": "2026-06-08T15:02:11.000Z",
      "duration_s": 1840,
      "snippet": "...lock the pricing tiers before launch. Sam: Agreed, I think 19.99 holds for Pro..."
    }
  ]
}

Otázka ke schůzce

POST /v1/meetings/:id/chat

Položte otázku v přirozeném jazyce; odpoví na ni AI nad přepisem dané schůzky. Pošlete JSON tělo s message. Otázka i odpověď se uloží do chatového vlákna schůzky a odpověď se vrátí. Vrátí 409 {"error":"no_transcript"}, pokud schůzka ještě nebyla přepsána.

Požadavek

curl https://api.notabium.com/v1/meetings/6f1c2e8a-2b4d-4a1e-9c3f-7a0b1d2e3f44/chat \
  -H "Authorization: Bearer ntb_live_..." \
  -H "Content-Type: application/json" \
  -d '{"message":"What did we decide about pricing?"}'

Odpověď 200

{
  "message": {
    "id": "b2d4f6a8-1c3e-5a7b-9d0f-2e4a6c8b0d1f",
    "role": "assistant",
    "content": "You agreed to keep Pro at 19.99 per month and ship a 7-day free trial. Sam owns the pricing page update.",
    "created_at": "2026-06-09T09:14:30.000Z"
  }
}

Chyby

Chyby vracejí stavový kód mimo 2xx a JSON tělo ve tvaru {"error":"..."}. Běžné případy: