Start rapid

Primul tău profil de companie în cinci minute.

Ai nevoie de un cont și de un terminal. La final ai preluat profilul de companie al Hetzner Online GmbH cu o cerere exemplu și știi ce conține răspunsul.

Copiază cheia API

Creează un cont gratuit și confirmă adresa de e-mail. Primești 150 credite de start, valabile 30 zile.

Prima ta cheie API te așteaptă deja la Cont › Chei API. Copiaz-o și tratează-o ca pe o parolă.

Fiecare cerere trimite cheia în headerul x-api-key. Exemplele folosesc YOUR_API_KEY în locul ei.

Dacă API-ul răspunde cu 401, cheia lipsește sau nu a fost copiată complet. Cu 403, adresa ta de e-mail nu este încă confirmată. Linkul de confirmare îl găsești în inbox.

Preia un profil de companie

Apelează fetch-organization și transmite denumirea companiei în parametrul q. Fără alți parametri primești datele de bază pentru 5 credite.

Copiază cererea, inserează cheia și rulează. cURL afișează JSON-ul direct. În Python și JavaScript, răspunsul se află apoi în data. Cu print(data["name"]) sau console.log(data.name) vezi denumirea companiei.

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

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/fetch-organization",
    headers={"x-api-key": "CHEIA_TA_API"},
    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": "CHEIA_TA_API" },
});
const data = await response.json();

Citește răspunsul

Răspunsul este profilul companiei ca JSON. Acestea sunt câmpurile de care ai nevoie cel mai des:

Citește răspunsul
Câmp	Semnificație
entity_id	ID-ul companiei la handelsregister.ai. Salvează-l pentru cererile următoare.
name, legal_form, status	Denumirea companiei, forma juridică și statusul în registru, în exemplu `ACTIVE`.
registration	Instanța de registru, tipul de registru și numărul de registru, în exemplu Ansbach HRB 6089.
address, seat	Adresa de afaceri cu coordonate, plus sediul conform registrului.
purpose, industry_classification	Obiectul de activitate și industria conform WZ 2008 și WZ 2025.
representation_scheme	Regulile de reprezentare: `current` se aplică azi, `history` arată fiecare stare înregistrată.
meta	Cât a costat cererea (`request_credit_cost`) și soldul tău după aceea (`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 · Răspuns exemplu pentru Hetzner Online GmbH, doar date de bază

Cu entity_id interoghezi mai târziu direct aceeași companie. Este și cheia pentru fetch-document și Signals. Instanța de registru și numărul de registru sunt la fel de unice, în exemplu Ansbach HRB 6089.

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

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/fetch-organization",
    headers={"x-api-key": "CHEIA_TA_API"},
    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": "CHEIA_TA_API" },
});
const data = await response.json();

Cum continui

Adaugă funcții Administratori, asociați sau date financiare în aceeași cerere. Preia o companie după numărul de registru Calea unică prin instanța de registru, numărul de registru și entity_id. Concepte de bază Cum funcționează creditele, Timp real, istoricul și valorile goale. Plugin ChatGPT Aceleași date într-un chat, fără cod. Python SDK API-ul în Python, cu metode gata făcute. Node SDK API-ul în JavaScript și TypeScript.