Γρήγορη εκκίνηση
Το πρώτο σου προφίλ εταιρείας σε πέντε λεπτά.
Χρειάζεσαι έναν λογαριασμό και ένα τερματικό. Στο τέλος, θα έχεις ανακτήσει το προφίλ εταιρείας της Hetzner Online GmbH με ένα παράδειγμα αιτήματος και θα ξέρεις τι περιέχει η απάντηση.
Αντίγραψε το κλειδί API σου
Δημιούργησε έναν δωρεάν λογαριασμό και επιβεβαίωσε τη διεύθυνση email σου. Λαμβάνεις 150 αρχικές πιστώσεις, που ισχύουν 30 ημέρες.
Το πρώτο σου κλειδί API σε περιμένει ήδη στο Λογαριασμός › Κλειδιά API. Αντίγραψέ το και χειρίσου το σαν κωδικό πρόσβασης.
Κάθε αίτημα στέλνει το κλειδί στο header x-api-key. Τα παραδείγματα χρησιμοποιούν το YOUR_API_KEY στη θέση του.
Αν το API απαντήσει με 401, το κλειδί λείπει ή δεν αντιγράφηκε ολόκληρο. Με 403, η διεύθυνση email σου δεν έχει επιβεβαιωθεί ακόμη. Τον σύνδεσμο επιβεβαίωσης θα τον βρεις στα εισερχόμενά σου.
Ανάκτησε ένα προφίλ εταιρείας
Κάλεσε το 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 | Το 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}
Με το 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();
Πού να συνεχίσεις
Προσθήκη features
Διαχειριστές, εταίροι ή οικονομικά στοιχεία στο ίδιο αίτημα.
Ανάκτηση εταιρείας με αριθμό μητρώου
Ο μονοσήμαντος τρόπος μέσω δικαστηρίου μητρώου, αριθμού μητρώου και entity_id.
Βασικές έννοιες
Πώς λειτουργούν οι πιστώσεις, ο Πραγματικός χρόνος, το ιστορικό και οι κενές τιμές.
Plugin του ChatGPT
Τα ίδια δεδομένα σε μια συνομιλία, χωρίς κώδικα.
Python SDK
Το API στην Python, με έτοιμες μεθόδους.
Node SDK
Το API σε JavaScript και TypeScript.