البدء السريع

أول ملف شركة لك في خمس دقائق.

تحتاج إلى حساب وطرفية (terminal). في النهاية ستكون قد جلبت ملف شركة Hetzner Online GmbH بطلب نموذجي، وتعرف ما تحتويه الاستجابة.

انسخ مفتاح API

أنشئ حسابًا مجانيًا وأكّد عنوان بريدك الإلكتروني. تحصل على 150 رصيد بداية، صالحة لمدة 30 يومًا.

مفتاح API الأول جاهز لك بالفعل تحت الحساب › مفاتيح API. انسخه وتعامل معه ككلمة مرور.

يرسل كل طلب المفتاح في الـ Header ‏x-api-key. تستخدم الأمثلة YOUR_API_KEY بديلًا عنه.

إذا استجابت الـ API بـ 401، فالمفتاح مفقود أو لم يُنسخ كاملًا. ومع 403 لم يُؤكَّد عنوان بريدك الإلكتروني بعد. تجد رابط التأكيد في صندوق بريدك.

اجلب ملف شركة

استدعِ fetch-organization ومرّر اسم الشركة في المعامل q. دون معاملات أخرى تحصل على البيانات الأساسية مقابل 5 رصيد.

انسخ الطلب، وأدخل مفتاحك، ونفّذه. يطبع cURL الـ JSON مباشرةً. وفي Python وJavaScript تكون الاستجابة حينها في data. ومع print(data["name"]) أو console.log(data.name) ترى اسم الشركة.

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

import requests

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

اقرأ الاستجابة

الاستجابة هي ملف الشركة بصيغة JSON. هذه هي الحقول التي تحتاجها أكثر من غيرها:

اقرأ الاستجابة
الحقل	المعنى
entity_id	معرّف الشركة لدى handelsregister.ai. احفظه للطلبات اللاحقة.
name, legal_form, status	اسم الشركة والشكل القانوني وحالة السجل، في المثال `ACTIVE`.
registration	محكمة السجل ونوع السجل ورقم السجل، في المثال Ansbach HRB 6089.
address, seat	عنوان العمل مع الإحداثيات، إضافةً إلى المقر المسجل وفق السجل.
purpose, industry_classification	غرض الشركة والقطاع وفق WZ 2008 وWZ 2025.
representation_scheme	قواعد التمثيل: `current` سارية اليوم، و`history` تُظهر كل حالة مسجلة.
meta	تكلفة الطلب (`request_credit_cost`) ورصيدك بعده (`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 · مثال على استجابة لـ Hetzner Online GmbH، البيانات الأساسية فقط

بالـ entity_id تستعلم لاحقًا عن الشركة نفسها مباشرةً. وهو أيضًا المفتاح لـ fetch-document وSignals. ومحكمة السجل ورقم السجل فريدان بالقدر نفسه، في المثال Ansbach HRB 6089.

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

import requests

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

إلى أين بعد ذلك

إضافة الميزات المديرون أو الشركاء أو البيانات المالية في الطلب نفسه. جلب شركة برقم السجل الطريقة الفريدة عبر محكمة السجل ورقم السجل والـ entity_id. المفاهيم الأساسية كيف تعمل الأرصدة والوقت الفعلي والتاريخ والقيم الفارغة. إضافة ChatGPT البيانات نفسها في محادثة، دون أي كود. Python SDK الـ API في Python، مع دوال جاهزة. Node SDK الـ API في JavaScript وTypeScript.