# Cégjelző Kapcsolati Háló API leírás

Utolsó módosítás dátuma: 2023-02-03

# API elérési címek

Teszt API endpoint: https://connections-dev.api.cegjelzo.com/v1 (opens new window)

Éles API endpoint: https://connections.api.cegjelzo.com/v1 (opens new window)

Swagger dokumentáció: https://connections-dev.api.cegjelzo.com/v1/docs (opens new window) .

Itt megtekinthetők a request és response modellek.

# Általános információk

A Cégjelző Kapcsolati Háló API-t az adatbázisunkban nyilvántartott társas vállalkozások (Kft-k, Bt-k, zRt-k ... stb.) kapcsolatainak feltérképezésre hoztuk létre. Segítségével lekérdezhetők a vállalkozás közvetlen kapcsolatai.

  • a cégben kik a bejegyzett tulajdonosok ( members ) és mik a részletes adataik
  • a cég milyen más vállalkozásokban rendelkezik tulajdonrésszel **( interests ) **
  • a tulajdonosok milyen más társas vállalkozásokban rendelkeznek tulajdonrésszel ( other connections )

Az api a kapcsolódó cégekről az adótörzsszámot adja vissza. Amennyiben bővebb információra lenne szükség (pl. cégkivonat), akkor azok a Cégjelző Céginformációs API segítségével kérdezhető le.

Ha nagyobb mélységű kapcsolati gráfra van szükség, akkor a kapcsolódó adótörzsszámokat külön-külön le kell kérdezni.

# 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 kapcsolati adatokat hetente frissítjük.

Limit - Az egy hónapban lekérdezhető cégek számát a szerződésben foglaltak szabályozzák.

# API végpontok

# Kapcsolatok lekérdezése

Az adatbázisunkban nyilvántartott társas vállalkozások (Kft-k, Bt-k, zRt-k ... stb.) közvetlen kapcsaolatainak egyszerű lekérdezése.

A lekérdezéshez meg kell adni a {tax_id} helyén az adószámot, illetve a header-ben a hozzáféréshez kapott X-API-KEY-t

A válasz tartalmazni fogja a keresett vállalkozás fontosabb adatait, emelett a tagok tulajdonosok fontosabb adatait, és egyéb kapcsolatait.

A request- és response modellek-ről a Swagger dokumentációban (opens new window) olvashat bővebben.