Általános információk
A Cégjelző Kereső API-t az adatbázisunkban nyilvántartott vállalkozások keresésére hoztuk létre. A végpontok segítségével más-más kritériumrendszer szerint lehet keresni.
Információ
Az API úgy lett kialakítva, hogy az alap struktúrát megtartva a felmerülő igények függvényében bővíthető legyen a későbbiekben.
Amennyiben adattartalomra vonatkozó igény merülne fel, kérjük egyeztessen ügyfélszolgálati munkatársunkkal.
Fontos
Az API közvetlenül frontendről történő hívása (pl. Fetch API) nem biztonságos.
Amennyiben egy publikus frontenden keresztül kerül meghívásra, a böngészőből ki lehet olvasni az API kulcsot.
Ez biztonsági kockázat, mert így bárki intézhet hívásokat a kulcs tulajdonosa nevében.
API elérési címek
Teszt API endpoint: https:/search-dev.api.cegjelzo.com
Éles API endpoint: https://search.api.cegjelzo.com
Swagger dokumentáció: https://search.api.cegjelzo.com/v1/docs
Fontos
Az API nem szerződésszerű használata esetén a rendszer automatikusan korlátozza az adott ügyféltől érkező összes hívást, ezért javasoljuk hogy élesítés előtt fokozott figyelemmel nézzék át a beépített terméket.
Korlátozások
Rate limit
Az API rate limitált. Maximum 30 kérés indítható másodpercenként.
Frissítés
Az adatbázisban tárolt vállalkozások adatait az alábbi gyakorisággal frissítjük:
- társas vállalkozások /
companies(Kft., Bt., zRt. ...stb) - Naponta - egyéni vállalkozók /
self_employed- Hetente - civil szervezetek /
civil_orgs(alapítványok, egyesületek, szövetségek) - Havonta - költségvetési szervek /
budget_orgs(önkormányzatok) - Havonta
URL encoding
Az API használata közben előfordul, hogy az ügyfél speciális vagy ékezetes karaktereket, illetve szóközöket vagy írásjeleket is használ egyes lekérdezések során.
Ezeket kérjük minden esetben szíveskedjenek URL encode-oldva továbbítani az API felé, mivel a rendszer csak így tudja őket értelmezni.