Vyhľadávanie

Univerzálne hľadanie kombinuje PostgreSQL fulltext a vector embeddings (sémantické hľadanie cez Vertex AI). Vracia výsledky zoskupené podľa typu entity. Vyhľadáva len v entitách, na ktoré má kľúč scope read.

Podporované typy entít

V parametri types aj v kľúčoch objektu results používame plurál:

• • contacts
• • documents (faktúry, ponuky, ...)
• • expenses
• • business_records
• • catalog
• • cash_registers
• • calendar

Endpoint

Query parametre

• • q – vyhľadávací výraz (min 2 znaky, povinné)
• • types – čiarkou oddelený zoznam typov pre filter (default: všetky, na ktoré má kľúč scope)
• • limit – max počet výsledkov per typ (default 5, max 20)

curl "https://monivio.sk/api/v1/search?q=ACME&types=contacts%2Cdocuments&limit=5" \
  -H "Authorization: Bearer mk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

{
  "data": {
    "query": "ACME",
    "results": {
      "contacts": [
        {
          "id": "con_2hf8pq3rxn4mlkzyt9abwvve",
          "type": "contact",
          "title": "ACME s.r.o.",
          "subtitle": "info@acme.sk",
          "score": 0.94,
          "url": "/app/contacts/con_2hf8pq3rxn4mlkzyt9abwvve"
        }
      ],
      "documents": [
        {
          "id": "doc_4kp9mxn8tq3vyz2lwbcr5shg",
          "type": "invoice",
          "title": "Faktúra FA260042 — ACME s.r.o.",
          "subtitle": "495,00 € · 2026-06-01",
          "score": 0.81,
          "url": "/app/documents/invoices/doc_4kp9mxn8tq3vyz2lwbcr5shg"
        }
      ]
    },
    "total_count": 2,
    "search_time_ms": 47
  }
}

Tipy

• • Score je float 0–1. Výsledky sú zoradené zostupne v rámci typu.
• • Pre lepšie výsledky kombinuj keywords s context-om: napr. "ACME 2026" nájde aj dokumenty kde sa ACME nevyskytuje doslova ale mu sémanticky patria.
• • Search nehľadá v archived/deleted dátach (RLS ich filtruje).