Gyorsindítás

Az első cégprofilod öt perc alatt.

Egy fiókra és egy terminálra van szükséged. A végén egy példakéréssel lekérted a Hetzner Online GmbH cégprofilját, és tudod, mit tartalmaz a válasz.

Másold ki az API-kulcsodat

Hozz létre egy ingyenes fiókot, és erősítsd meg az e-mail-címedet. 150 kezdő kreditet kapsz, 30 napig érvényeset.

Az első API-kulcsod már vár rád a Fiók › API-kulcsok alatt. Másold ki, és kezeld úgy, mint egy jelszót.

Minden kérés az x-api-key headerben küldi a kulcsot. A példákban az AZ_API_KULCSOD áll a helyén.

Ha az API 401-gyel válaszol, a kulcs hiányzik, vagy nem teljesen másoltad ki. 403 esetén az e-mail-címed még nincs megerősítve. A megerősítő linket a postafiókodban találod.

Kérj le egy cégprofilt

Hívd meg a fetch-organization végpontot, és add meg a cégnevet a q paraméterben. További paraméterek nélkül az alapadatokat kapod 5 kreditért.

Másold ki a kérést, illeszd be a kulcsodat, és futtasd. A cURL közvetlenül kiírja a JSON-t. Pythonban és JavaScriptben a válasz ezután a data változóban van. A print(data["name"]) vagy a console.log(data.name) megmutatja a cégnevet.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: AZ_API_KULCSOD" \
  --data-urlencode 'q=Hetzner Online GmbH'

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/fetch-organization",
    headers={"x-api-key": "AZ_API_KULCSOD"},
    params={
        "q": "Hetzner Online GmbH",
    },
)
data = response.json()

const url = new URL("https://handelsregister.ai/api/v1/fetch-organization");
url.searchParams.append("q", "Hetzner Online GmbH");

const response = await fetch(url, {
  headers: { "x-api-key": "AZ_API_KULCSOD" },
});
const data = await response.json();

Olvasd el a választ

A válasz a cégprofil JSON-ként. Ezekre a mezőkre lesz a leggyakrabban szükséged:

Olvasd el a választ
Mező	Jelentés
entity_id	A cég azonosítója a handelsregister.ai-nál. Mentsd el a további kérésekhez.
name, legal_form, status	Cégnév, jogi forma és nyilvántartási státusz, a példában `ACTIVE`.
registration	Cégbíróság, nyilvántartás típusa és cégjegyzékszám, a példában Ansbach HRB 6089.
address, seat	Üzleti cím koordinátákkal, plusz a székhely a nyilvántartás szerint.
purpose, industry_classification	Tevékenységi kör és iparág a WZ 2008 és a WZ 2025 szerint.
representation_scheme	Képviseleti szabályok: a `current` a ma érvényes, a `history` minden bejegyzett állapotot mutat.
meta	Mennyibe került a kérés (`request_credit_cost`), és mennyi az egyenleged utána (`credits_remaining`).

1{2  "entity_id": "94eb910fef13f94585c48c263fa446d4",3  "name": "Hetzner Online GmbH",4  "status": "ACTIVE",5  "legal_form": "GmbH",6  "registration": {7    "court": "Ansbach",8    "register_type": "HRB",9    "register_number": "6089"10  },11  "industry_classification": {12    "WZ2008": [13      {14        "code": "62.01.0",15        "label": "Erbringung von Dienstleistungen der Informationstechnologie"16      },17      {18        "code": "63.11.0",19        "label": "Datenverarbeitung, Hosting und damit verbundene Tätigkeiten"20      },21      {22        "code": "61.90.0",23        "label": "Telekommunikation, sonstige"24      }25    ],26    "WZ2025": [27      {28        "code": "62.20.1",29        "label": "Erbringung von Beratungsleistungen auf dem Gebiet der Informationstechnologie"30      },31      {32        "code": "46.50.1",33        "label": "Großhandel mit Datenverarbeitungsgeräten, peripheren Geräten und Software"34      },35      {36        "code": "62.90.0",37        "label": "Erbringung von sonstigen Dienstleistungen der Informationstechnologie"38      }39    ]40  },41  "address": {42    "house_number": "25",43    "street": "Industriestraße",44    "postal_code": "91710",45    "city": "Gunzenhausen",46    "county": "Weißenburg-Gunzenhausen",47    "state": "Bayern",48    "country": "DEU",49    "coordinates": {50      "latitude": 49.12483,51      "longitude": 10.7805252    }53  },54  "seat": {55    "city": "Gunzenhausen"56  },57  "registration_date": null,58  "representation_scheme": {59    "current": [60      "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."61    ],62    "history": [63      {64        "value": [65          "Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. Sind mehrere Vorstandsmitglieder bestellt, so wird die Gesellschaft durch zwei Vorstandsmitglieder oder durch ein Vorstandsmitglied gemeinsam mit einem Prokuristen vertreten."66        ],67        "effective_from": "2002-10-15",68        "effective_to": "2015-07-28"69      },70      {71        "value": [72          "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."73        ],74        "effective_from": "2015-07-28",75        "effective_to": null76      }77    ]78  },79  "purpose": "Die Durchführung von Internet- und Netzwerkdienstleistungen, das Erstellen und Vertreiben von Software, der Handel mit Hard- und Software, der Betrieb einer Werbeagentur,darüber hinaus der Im- und Export von Waren aller Art, soweit sie keiner Einfuhr- oder Ausfuhrbeschränkung unterliegen und soweit keine Genehmigungen erforderlich sind.",80  "meta": {81    "request_credit_cost": 5,82    "credits_remaining": 14583  }84}

200 · Példaválasz a Hetzner Online GmbH-ra, csak alapadatokkal

Az entity_id-val később közvetlenül lekérdezed ugyanazt a céget. Ez a kulcs a fetch-document-hez és a Signalshoz is. A cégbíróság és a cégjegyzékszám ugyanilyen egyedi, a példában Ansbach HRB 6089.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: AZ_API_KULCSOD" \
  --data-urlencode 'q=94eb910fef13f94585c48c263fa446d4'

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/fetch-organization",
    headers={"x-api-key": "AZ_API_KULCSOD"},
    params={
        "q": "94eb910fef13f94585c48c263fa446d4",
    },
)
data = response.json()

const url = new URL("https://handelsregister.ai/api/v1/fetch-organization");
url.searchParams.append("q", "94eb910fef13f94585c48c263fa446d4");

const response = await fetch(url, {
  headers: { "x-api-key": "AZ_API_KULCSOD" },
});
const data = await response.json();

Hogyan tovább

Funkciók hozzáadása Ügyvezetők, tagok vagy pénzügyek ugyanabban a kérésben. Cég lekérése cégjegyzékszám alapján Az egyértelmű út cégbírósággal, cégjegyzékszámmal és entity_id-val. Alapfogalmak Hogyan működnek a kreditek, a valós idejű mód, az előzmények és az üres értékek. ChatGPT-plugin Ugyanazok az adatok chatben, kód nélkül. Python SDK Az API Pythonban, kész metódusokkal. Node SDK Az API JavaScriptben és TypeScriptben.