Dokumentácia
Všetko, čo potrebujete na používanie BiLLiO aj na integráciu nášho API do vlastnej aplikácie.
API - Vyhľadávanie firemných dát
1. Čo získate
Naše API vám otvorí dvere k aktuálnym údajom o miliónoch subjektov priamo vo vašom softvéri. Implementujte firemné dáta v priebehu pár sekúnd - bez manuálneho prepisovania, bez obmedzení.
- Nulové náklady - kvalitné dáta dostupné úplne zadarmo
- Bez limitov - škálovanie bez obmedzenia počtu požiadaviek
- Presné zásahy - okamžité vyhľadávanie podľa IČO alebo názvu
- Čistý kód - iba dokonale štruktúrované JSON dáta
2.1 Získanie API kľúča
Pred prvým volaním API potrebujete vygenerovať svoj tajný kľúč. Po prihlásení prejdite do sekcie Osobný účet → API kľúče a vygenerujte nový kľúč. Tento kľúč slúži na autentifikáciu každej požiadavky a je potrebné ho uchovať na bezpečnom mieste.
2.2 Vyhľadávanie subjektov
Endpoint slúži na vyhľadávanie firiem podľa názvu alebo IČO. Vracia zoznam zhodných spoločností z registra.
Query parametre
| Parameter | Typ | Povinný | Popis |
|---|---|---|---|
| q | string | required | Vyhľadávací výraz - názov firmy alebo IČO (napr. 12345678 alebo BiLLiO). |
Hlavičky (Headers)
| Hlavička | Typ | Povinná | Popis | Formát |
|---|---|---|---|---|
| Authorization | string | required | Bearer token - váš API kľúč vygenerovaný v sekcii Osobný účet → API kľúče. | Bearer váš-api-kľúč |
Popis polí odpovede
| Pole | Typ | Popis |
|---|---|---|
| ico | string | IČO subjektu |
| name | string | Obchodné meno subjektu |
| street | string | Ulica a číslo sídla |
| postal_code | string | PSČ |
| city | string | Mesto sídla |
| country | string | Krajina sídla |
| country_iso2 | string | Kód krajiny podľa ISO 3166-1 alpha-2 |
| country_iso3 | string | Kód krajiny podľa ISO 3166-1 alpha-3 |
| dic | stringnull | DIČ subjektu |
| ic_dph | stringnull | IČ DPH subjektu |
| vat_payer | boolean | Informácia, či je subjekt platiteľom DPH |