Podporte nás
Apino.sk ponúka vývojárom prvé plnohodnotné REST API na Register právnických osôb s unikátnym sledovaním zmien a historickými dátami
Každý kto sa niekedy pokúšal programaticky získať dáta zo slovenského Registra právnických osôb (RPO), respektíve obchodného registra (ORSR), vie, aké to je frustrujúce. Neexistujúce alebo zastaralé rozhrania, žiadna štruktúrovaná dokumentácia, komplikovaný prístup k historickým údajom. Slovenský projekt Apino.sk prichádza s riešením — moderným REST API, ktoré sprístupňuje údaje o viac ako 2,2 milióna slovenských organizácií s priemernou dobou odozvy pod 50 milisekúnd a výbornou api dokumentáciou.
Od frustrácie k produktu
Za projektom stojí Michal Piják, bratislavský vývojár, ktorý si problém zažil na vlastnej koži. „Pracoval som na projekte, kde som potreboval overiť existenciu firmy podľa IČO v obchodnom registri a stiahnuť jej aktuálne údaje. Oficiálne zdroje nemali použiteľné API a existujúce riešenia boli buď pomalé, neaktuálne, alebo nemali dobrú dokumentáciu,” vysvetľuje. Namiesto ďalšieho jednorazového scrappera sa rozhodol vybudovať službu, ktorú by sám chcel používať a nakoniec ju aj používa na viacerých projektoch.
Výsledkom je Apino.sk — API, ktoré .denne automaticky synchronizuje dáta priamo z oficiálneho RPO (registra, z ktorého čerpá aj obchodný register ORSR) a sprístupňuje ich cez čisté, dobre zdokumentované RESTful rozhranie.
Čo Apino ponúka
Jadrom služby je fulltextové vyhľadávanie naprieč celým obchodným registrom. Vývojári môžu vyhľadávať firmy a živnostníkov podľa názvu, adresy alebo IČO, pričom API automaticky zvláda slovenskú diakritiku — vyhľadávanie „Škoda” nájde výsledky aj pri zadaní „skoda”. Odpoveď príde štandardne do 50 milisekúnd.
Okrem základného vyhľadávania ponúka Apino niekoľko funkcií, ktoré ho odlišujú od konkurencie:
Sledovanie zmien na úrovni polí
Apino nesleduje len to, že sa niečo v zázname firmy zmenilo — vie presne povedať čo sa zmenilo a kedy. Zmena štatutára, sídla, obchodného mena alebo predmetu podnikania — všetko je zachytené s časovou pečiatkou. Históriu zmien pritom eviduje roky dozadu vďaka spracovaniu temporálnych dát z pôvodného registra.
Vyhľadávanie osôb a obchodné prepojenia
API umožňuje vyhľadávať osoby podľa mena a roly (štatutár, spoločník) naprieč celým registrom. Unikátnou funkciou je endpoint na odhaľovanie prepojení medzi firmami — stačí zadať IČO a Apino identifikuje spoločnosti prepojené cez spoločné osoby v orgánoch.
Dávkové spracovanie
Pre aplikácie, ktoré potrebujú overiť desiatky firiem naraz, je k dispozícii batch endpoint spracujúci až 100 IČO v jednej požiadavke.
Štatistiky registra
Agregované dáta o mesačných a ročných registráciách vrátane rozdelenia podľa obcí, plus celkový prehľad stavu registra.
Český register a dáta z Finančnej správy
Okrem slovenského RPO Apino sprístupňuje aj český Register ekonomických subjektov (RES) s viac ako 3 miliónmi subjektov — spolu tak pokrýva 5,5 milióna firiem z dvoch krajín. Dáta z RES sa aktualizujú dvojtýždenne.
Novinkou je aj napojenie na Finančnú správu SR — API umožňuje overiť, či je firma platcom DPH, zistiť jej IČ DPH, daňovú spoľahlivosť a prípadné daňové nedoplatky. Tieto údaje sa synchronizujú týždenne.
Pre vývojárov, od vývojára
Apino je navrhnuté s dôrazom na developer experience. API má kompletnú OpenAPI 3.1 špecifikáciu a interaktívnu dokumentáciu, kde si vývojári môžu API endpointy vyskúšať priamo v prehliadači. Odpovede sú v štruktúrovanom JSON formáte s konzistentnou pagináciou, ETag podporou a Gzip kompresiou.
Každý API kľúč je možné obmedziť na konkrétne domény (CORS), IP adresy alebo nastaviť dátum expirácie. Dashboard poskytuje detailnú analytiku využitia vrátane grafov a logov jednotlivých požiadaviek.
„Chcel som, aby integrácia trvala minúty, nie dni,” hovorí. „Registrácia je zadarmo, API kľúč dostanete okamžite a prvých tisíc požiadaviek mesačne je na vyskúšanie zdarma.”
Cenový model
Apino používa transparentný model s štyrmi úrovňami:
| Plán | Cena | Požiadaviek/mesiac | Pre koho |
|---|---|---|---|
| Free | Zadarmo | 100 | Vyskúšanie a hobby projekty |
| Starter | 7 €/mes. | 1 000 | Menšie projekty |
| Pro | 15 €/mes. | 5 000 | Malé aplikácie |
| Business | 29 €/mes. | 15 000 | Produkčné nasadenie |
Pre veľkých zákazníkov je k dispozícii Enterprise plán s individuálnymi limitmi, SLA a dedikovanou podporou. Predplatné je možné kedykoľvek zrušiť bez záväzkov.
Kto už Apino používa
Službu v produkčnom prostredí využíva AOMVSR (Automobilové opravovne MV SR) aj Pychle — platforma na prácu s verejnými zákazkami a tendrovými dokumentmi. Oba prípady ukazujú šírku využitia — od štátnej správy po B2B SaaS.
Pripravované vylepšenie do budúcnosti
Apino aktuálne rozširuje portfólio beta funkcií — sledovanie zmien, vyhľadávanie osôb a štatistiky sú už dostupné vo všetkých platených plánoch. V pláne je rozšírenie o webhooky pre notifikácie o zmenách vo vybraných firmách a rozšírenie pokrytia o ďalšie verejné registre.
„Slovensko má obrovské množstvo verejných dát — obchodný register, register DPH, finančná správa — ktoré sú prakticky nepoužiteľné pre vývojárov. Apino je prvý krok k tomu, aby sa to zmenilo,” uzatvára Piják.potreboval overiť existenciu firmy podľa IČO v obchodnom registri
