Prejsť na obsah
Accquix Register
Esc
↑↓navigácia↵otvoriť⌘Jnáhľad
Na tejto stránke

Rýchly štart

Spustite Accquix Register cez docker compose, počkajte na prvú synchronizáciu a pošlite prvé vyhľadávanie a overenie.

Potrebujete Docker s doplnkom compose, približne 10 GB voľného miesta a odchádzajúce HTTPS spojenie. Prvá synchronizácia stiahne asi 1 GB a trvá 7–20 minút, väčšinu času zaberie sťahovanie.

Alebo nechajte svojho AI agenta register spustiť lokálne a overiť, že funguje.

Vyskúšajte demo

Ak chcete API vidieť skôr, než čokoľvek stiahnete, spustite demo: skutočné API nad asi 180 fiktívnymi firmami a živnostníkmi, s platiteľmi DPH, skupinou DPH, zaniknutými subjektmi aj záznamami v rizikových zoznamoch. Keď je obraz zostavený, je pripravené za pár sekúnd.

git clone https://github.com/accquix/register && cd register
docker compose -f deploy/demo/compose.yaml up -d --wait serve
curl -s 'localhost:8080/v1/search?q=zlata'

API kľúč netreba: demo počúva len na localhoste. Každá odpoveď má v attribution text DEMO DATA a /v1/capabilities uvádza "demo": true. Databáza je len v pamäti a po docker compose -f deploy/demo/compose.yaml down zmizne. Synchronizácia demo databázu odmietne, takže demo a reálne dáta sa nikdy nezmiešajú.

Spustenie s reálnymi dátami

Stiahnite kód

git clone https://github.com/accquix/register
cd register/deploy/compose

Vytvorte tajomstvá

./make-secrets.sh

Skript zapíše náhodné heslo k databáze a jeden kľúč API do priečinka secrets/. Kľúč API sa zobrazí iba raz: uložte si ho hneď. Uchováva sa len jeho odtlačok SHA-256.

Spustite služby

docker compose up -d

Compose spustí PostgreSQL 18, aplikuje schému (migrate) a potom spustí API (serve) a hodinovú synchronizáciu (sync --every 1h).

Počkajte na prvú synchronizáciu

docker compose logs -f sync
curl -s localhost:8080/readyz

Kým nie sú zverejnené všetky zdroje, API odpovedá 503 s dôvodom bootstrapping. Keď synchronizácia zapíše fs list applied pre posledný zoznam, /readyz odpovie ready.

Vyhľadajte a overte

export KEY=<váš kľúč>
curl -s -H "Authorization: Bearer $KEY" "localhost:8080/v1/search?q=zlata%20ryb"
curl -s -H "Authorization: Bearer $KEY" "localhost:8080/v1/lookup/99900001"

Vyhľadávanie vráti kandidátov, overenie podľa identifikátora vráti celý subjekt:

{
  "mode": "default",
  "results": [
    {
      "ico": "99900001",
      "name": "Zlatá Rybka, s.r.o.",
      "municipality": "Fiktívne Mesto",
      "kind": "legal_person",
      "active": true
    }
  ],
  "dataAsOf": "2026-11-10",
  "attribution": [
    "Register právnických osôb, Ministerstvo vnútra SR, CC BY 4.0",
    "Zdroj údajov: Finančná správa SR"
  ]
}

Ďalej