Βασικά στοιχεία
Επωνυμία, νομική μορφή, εγγραφή στο μητρώο, διεύθυνση, σκοπός, κεφάλαιο και κανόνες εκπροσώπησης: τα βασικά στοιχεία κάθε Προφίλ εταιρείας.
Τα Stammdaten (βασικά στοιχεία) περιγράφουν ποια είναι μια εταιρεία: επωνυμία, νομική μορφή, εγγραφή στο μητρώο, διεύθυνση, σκοπός, κεφάλαιο και κανόνες εκπροσώπησης. Ανήκουν στα βασικά δεδομένα και περιλαμβάνονται σε κάθε προφίλ εταιρείας, χωρίς να ζητήσεις feature.
Τα περισσότερα πεδία προέρχονται από το Handelsregister (εμπορικό μητρώο) και τα άλλα επίσημα μητρώα. Επιπλέον συλλέγουμε λέξεις-κλειδιά, προϊόντα και στοιχεία επικοινωνίας από το διαδίκτυο. Τι πρέπει να καταχωρίσει μια εταιρεία εξαρτάται από τη νομική της μορφή· η στήλη Διαθεσιμότητα το δείχνει ανά πεδίο.
Παράδειγμα
Τα παραδείγματα αυτής της σελίδας προέρχονται από ένα παράδειγμα αιτήματος για τη Hetzner Online GmbH, Ansbach HRB 6089. Αν αλλάξει η εγγραφή της, το δικό σου αίτημα επιστρέφει διαφορετικές τιμές.
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();
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 "keywords": [12 "Dedicated Server",13 "Cloud Hosting",14 "Webhosting",15 "Colocation",16 "Object Storage",17 "Domainregistrierung",18 "SSL-Zertifikate",19 "Web-Hosting-Unternehmen"20 ],21 "products_and_services": [22 "Dedizierte Root-Server (Dedicated Servers)",23 "Cloud-Server und virtuelle Server",24 "Managed Server",25 "Webhosting (Shared Hosting)",26 "Colocation Rack / Rechenzentrumsflächen",27 "Storage Box / Object Storage / Storage Share",28 "Domain-Registrierung",29 "SSL-Zertifikate",30 "Load Balancer",31 "DNS Console",32 "Registration Robot",33 "Custom Solutions"34 ],35 "industry_classification": {36 "WZ2008": [37 {38 "code": "62.01.0",39 "label": "Erbringung von Dienstleistungen der Informationstechnologie"40 },41 {42 "code": "63.11.0",43 "label": "Datenverarbeitung, Hosting und damit verbundene Tätigkeiten"44 },45 {46 "code": "61.90.0",47 "label": "Telekommunikation, sonstige"48 }49 ],50 "WZ2025": [51 {52 "code": "62.20.1",53 "label": "Erbringung von Beratungsleistungen auf dem Gebiet der Informationstechnologie"54 },55 {56 "code": "46.50.1",57 "label": "Großhandel mit Datenverarbeitungsgeräten, peripheren Geräten und Software"58 },59 {60 "code": "62.90.0",61 "label": "Erbringung von sonstigen Dienstleistungen der Informationstechnologie"62 }63 ]64 },65 "contact_data": {66 "website": "https://www.hetzner.com/",67 "phone_number": "09831 5050",68 "email": "[email protected]"69 },70 "address": {71 "house_number": "25",72 "street": "Industriestraße",73 "postal_code": "91710",74 "city": "Gunzenhausen",75 "county": "Weißenburg-Gunzenhausen",76 "state": "Bayern",77 "country": "DEU",78 "coordinates": {79 "latitude": 49.12483,80 "longitude": 10.7805281 }82 },83 "seat": {84 "city": "Gunzenhausen"85 },86 "registration_date": null,87 "representation_scheme": {88 "current": [89 "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."90 ],91 "history": [92 {93 "value": [94 "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."95 ],96 "effective_from": "2002-10-15",97 "effective_to": "2015-07-28"98 },99 {100 "value": [101 "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."102 ],103 "effective_from": "2015-07-28",104 "effective_to": null105 }106 ]107 },108 "capital": {109 "current": {110 "amount": 50000,111 "currency": "EUR",112 "kind": "STAMMKAPITAL"113 },114 "history": [115 {116 "value": {117 "amount": 50000,118 "currency": "EUR",119 "kind": "GRUNDKAPITAL"120 },121 "effective_from": "2002-10-15",122 "effective_to": null123 }124 ]125 },126 "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.",127 "meta": {128 "request_credit_cost": 5,129 "credits_remaining": 145130 }131}
Επωνυμία και νομική μορφή
Η επωνυμία, η νομική μορφή και η κατάσταση περιγράφουν την εταιρεία, το entity_id την ταυτοποιεί. Αποθήκευσε το entity_id αν θέλεις να ανακτήσεις ή να παρακολουθήσεις μια εταιρεία ξανά αργότερα ή να τη συνδέσεις με τα δικά σου δεδομένα.
| Πεδίο | Σημασία | Παράδειγμα | Διαθεσιμότητα |
|---|---|---|---|
| entity_idstring | Το ID της εταιρείας στο handelsregister.ai. Αποθήκευσέ το ως κλειδί στα δεδομένα σου. Στην παράμετρο q αντιστοιχεί ακριβώς σε αυτή την εταιρεία.Βασικά στοιχεία |
"94eb910fef13f94585c48c263fa446d4" |
πάντα |
| namestring | Επωνυμία όπως εμφανίζεται στο μητρώο, με την προσθήκη της νομικής μορφής. |
"Hetzner Online GmbH" |
όπως παραπάνω |
| legal_formstring |
Νομική μορφή, συνήθως ως η καθιερωμένη γερμανική συντομογραφία. Σύγκρινε χωρίς διάκριση πεζών-κεφαλαίων, γιατί η γραφή μπορεί να διαφέρει ελαφρώς, για παράδειγμα oHG. Με τη Λειτουργία AI μπορεί να εμφανιστεί η πλήρης μορφή. Η λίστα δείχνει συνήθεις τιμές· υπάρχουν κι άλλες.Τιμές: GmbH Gesellschaft mit beschränkter Haftung (εταιρεία περιορισμένης ευθύνης), UG (haftungsbeschränkt) Unternehmergesellschaft («μίνι GmbH»), AG Aktiengesellschaft (ανώνυμη εταιρεία), SE Societas Europaea (ευρωπαϊκή εταιρεία), KGaA Kommanditgesellschaft auf Aktien (ετερόρρυθμη κατά μετοχές εταιρεία), GmbH & Co. KG KG με μια GmbH ως ομόρρυθμο εταίρο, KG Kommanditgesellschaft (ετερόρρυθμη εταιρεία), OHG Offene Handelsgesellschaft (ομόρρυθμη εταιρεία), e.K. eingetragener Kaufmann (εγγεγραμμένος ατομικός έμπορος), eG eingetragene Genossenschaft (εγγεγραμμένος συνεταιρισμός), PartG Partnerschaftsgesellschaft (εταιρεία ελευθέρων επαγγελματιών), και με περιορισμένη επαγγελματική ευθύνη, e.V. eingetragener Verein (εγγεγραμμένο σωματείο), eGbR eingetragene Gesellschaft bürgerlichen Rechts (εγγεγραμμένη αστική εταιρεία) |
"GmbH" |
όπως παραπάνω |
| statusstring |
Κατάσταση της εταιρείας στο μητρώο. Είναι δυνατές και άλλες τιμές· χειρίσου τις άγνωστες τιμές ως «μη ενεργή».Τιμές: ACTIVE ενεργή, INSOLVENT σε διαδικασία αφερεγγυότητας, DISSOLVED λυμένη, σε εκκαθάριση, TERMINATED διαγραμμένη από το μητρώο |
"ACTIVE" |
όπως παραπάνω |
Εγγραφή στο μητρώο
Το δικαστήριο μητρώου, ο τύπος μητρώου και ο αριθμός μητρώου ταυτοποιούν μια εταιρεία. Τα γράφουμε μαζί, στο παράδειγμά μας ως «Ansbach HRB 6089». Μπορείς να τα περάσεις και σε αυτή τη μορφή στην παράμετρο q.
| Πεδίο | Σημασία | Παράδειγμα | Διαθεσιμότητα |
|---|---|---|---|
| registrationobject|null | Η εγγραφή της εταιρείας στο μητρώο.Κενό όταν η Λειτουργία AI γνωρίζει μια εταιρεία μόνο από πηγές στο διαδίκτυο· το entity_id της ξεκινά τότε με AI_TMP_Βασικά στοιχεία | – | πάντα |
| registration.courtstring | Δικαστήριο μητρώου ως τοπωνύμιο, χωρίς «Amtsgericht» (ειρηνοδικείο), για παράδειγμα Ansbach ή Charlottenburg (Berlin). |
"Ansbach" |
όπως παραπάνω |
| registration.register_typestring |
Τύπος μητρώου, δηλαδή το μητρώο και, για το Handelsregister, το τμήμα του.Τιμές: HRB Handelsregister τμήμα B: GmbH, UG, AG, SE, KGaA, HRA Handelsregister τμήμα A: e.K., OHG, KG, GmbH & Co. KG, GnR Genossenschaftsregister (μητρώο συνεταιρισμών), PR Partnerschaftsregister (μητρώο εταιρειών ελευθέρων επαγγελματιών), VR Vereinsregister (μητρώο σωματείων), GsR Gesellschaftsregister (μητρώο εταιρειών) για την eGbR |
"HRB" |
όπως παραπάνω |
| registration.register_numberstring | Αριθμός μητρώου ως κείμενο. Μοναδικός μόνο μαζί με δικαστήριο μητρώου και τύπο μητρώου. |
"6089" |
όπως παραπάνω |
| registration_datestring|null | Ημερομηνία εγγραφής στο μητρώο, ως χρονοσφραγίδα ISO 8601.Κενό όταν η ημερομηνία δεν είναι καταγεγραμμένη |
"2013-03-18T00:00:00+00:00" |
συνήθως: GmbH, UG, AG, SE, KGaA, KG, OHG, eG, PartG σπάνια: GmbH & Co. KG, e.K. |
Ένας αριθμός μητρώου είναι μοναδικός μόνο μαζί με το δικαστήριο μητρώου του. Πολλά δικαστήρια μπορεί να έχουν τον ίδιο αριθμό.
Διεύθυνση και καταστατική έδρα
Το address είναι η επαγγελματική διεύθυνση, το seat η καταστατική έδρα (Sitz) στο μητρώο. Οι δύο μπορεί να διαφέρουν, για παράδειγμα όταν μια εταιρεία είναι εγγεγραμμένη στο Μόναχο και δραστηριοποιείται στο Gauting.
| Πεδίο | Σημασία | Παράδειγμα | Διαθεσιμότητα |
|---|---|---|---|
| addressobject | Επαγγελματική διεύθυνση της εταιρείας.Βασικά στοιχεία | – | πάντα |
| address.streetstring|null | Οδός χωρίς αριθμό.Κενό όταν η διεύθυνση αποτελείται μόνο από την πόλη |
"Industriestraße" |
συνήθως |
| address.house_numberstring|null | Αριθμός ως κείμενο, και με προσθήκη όπως «6 a».Κενό όταν η διεύθυνση δεν έχει αριθμό |
"25" |
όπως παραπάνω |
| address.postal_codestring|null | Ταχυδρομικός κώδικας ως κείμενο, ώστε να διατηρούνται τα αρχικά μηδενικά.Κενό όταν η διεύθυνση αποτελείται μόνο από την πόλη |
"91710" |
όπως παραπάνω |
| address.citystring | Πόλη της επαγγελματικής διεύθυνσης. |
"Gunzenhausen" |
πάντα |
| address.countystring | Περιφερειακή ενότητα (Landkreis) ή αυτοτελής πόλη. Σε ορισμένες διευθύνσεις λείπει ως κλειδί. |
"Weißenburg-Gunzenhausen" |
συνήθως |
| address.statestring | Ομόσπονδο κρατίδιο (Bundesland). Σε ορισμένες διευθύνσεις λείπει ως κλειδί. |
"Bayern" |
όπως παραπάνω |
| address.countrystring | Χώρα ως τριψήφιος κωδικός ISO 3166, για παράδειγμα DEU. Σε ορισμένες διευθύνσεις λείπει ως κλειδί. |
"DEU" |
όπως παραπάνω |
| address.coordinatesobject | Γεωγραφικές συντεταγμένες της επαγγελματικής διεύθυνσης, για χάρτες και αναζητήσεις σε ακτίνα. | – | όπως παραπάνω |
| address.coordinates.latitudenumber|null | Γεωγραφικό πλάτος σε δεκαδικές μοίρες.Κενό όταν η διεύθυνση δεν μπόρεσε να γεωκωδικοποιηθεί |
49.12483 |
όπως παραπάνω |
| address.coordinates.longitudenumber|null | Γεωγραφικό μήκος σε δεκαδικές μοίρες.Κενό όταν η διεύθυνση δεν μπόρεσε να γεωκωδικοποιηθεί |
10.78052 |
όπως παραπάνω |
| seatobject | Η καταστατική έδρα (Sitz) της εταιρείας στο μητρώο. | – | πάντα |
| seat.citystring | Πόλη της καταστατικής έδρας. Μπορεί να διαφέρει από την επαγγελματική διεύθυνση. |
"Gunzenhausen" |
όπως παραπάνω |
Σκοπός και κλάδος
Ο σκοπός της εταιρείας (Unternehmensgegenstand) είναι καταχωρισμένος στο μητρώο για GmbH, UG, AG, SE, KGaA, eG και PartG. Οι GmbH & Co. KG, KG, OHG και οι ατομικοί έμποροι (e.K.) δεν καταχωρίζουν σκοπό. Κλάδος, λέξεις-κλειδιά και προϊόντα και υπηρεσίες υπάρχουν για κάθε νομική μορφή.
| Πεδίο | Σημασία | Παράδειγμα | Διαθεσιμότητα |
|---|---|---|---|
| purposestring|null | Σκοπός της εταιρείας όπως εμφανίζεται στο μητρώο, στα γερμανικά. Με τη Λειτουργία AI, είναι μια σύντομη περίληψη της δραστηριότητας, και για νομικές μορφές χωρίς καταχωρισμένο σκοπό.Κενό όταν η νομική μορφή δεν καταχωρίζει σκοπό, για παράδειγμα KG, OHG και e.K.Βασικά στοιχεία |
"Die Durchführung von Internet- und Netzwerkdienstleistun…" |
πάντα: GmbH, UG, AG, SE, KGaA, eG, PartG ποτέ: GmbH & Co. KG, KG, OHG, e.K. |
| industry_classificationobject | Κλάδος σύμφωνα με τη γερμανική ταξινόμηση οικονομικών δραστηριοτήτων (WZ), σε δύο εκδόσεις. | – | πάντα |
| industry_classification.WZ2025array | Κωδικοί κλάδου σύμφωνα με τη WZ 2025, την τρέχουσα έκδοση. Το φίλτρο κλάδου της αναζήτησης χρησιμοποιεί επίσης αυτούς τους κωδικούς.Κενό όταν δεν μπόρεσε να αντιστοιχιστεί κλάδος | – | συνήθως |
| industry_classification.WZ2025[].codestring | Πενταψήφιος κωδικός WZ, για παράδειγμα 62.20.1. |
"62.20.1" |
όπως παραπάνω |
| industry_classification.WZ2025[].labelstring | Ονομασία της οικονομικής δραστηριότητας, στα γερμανικά. |
"Erbringung von Beratungsleistungen auf dem Gebiet der In…" |
όπως παραπάνω |
| industry_classification.WZ2008array | Κωδικοί κλάδου σύμφωνα με την παλαιότερη έκδοση WZ 2008, για συστήματα που τη χρησιμοποιούν ακόμη.Κενό όταν δεν υπάρχει αντιστοίχιση WZ 2008 | – | εν μέρει |
| industry_classification.WZ2008[].codestring | Πενταψήφιος κωδικός WZ σύμφωνα με τη WZ 2008. |
"62.01.0" |
όπως παραπάνω |
| industry_classification.WZ2008[].labelstring | Ονομασία της οικονομικής δραστηριότητας, στα γερμανικά. |
"Erbringung von Dienstleistungen der Informationstechnolo…" |
όπως παραπάνω |
| keywordsarray | Λέξεις-κλειδιά για τη δραστηριότητα της εταιρείας, συλλεγμένες από δημόσιες πηγές στο διαδίκτυο. Επεκτείνονται με τη Λειτουργία AI.Κενό όταν η εταιρεία έχει μικρή παρουσία στο διαδίκτυο | – | όπως παραπάνω |
| products_and_servicesarray | Τα προϊόντα και οι υπηρεσίες της εταιρείας ως λίστα, συλλεγμένα από δημόσιες πηγές στο διαδίκτυο. Επεκτείνονται με τη Λειτουργία AI.Κενό όταν η εταιρεία έχει μικρή παρουσία στο διαδίκτυο | – | όπως παραπάνω |
Με τη Λειτουργία AI, το
purpose περιέχει μια σύντομη περίληψη της δραστηριότητας αντί για το κείμενο του μητρώου. Η Λειτουργία AI προσθέτει λέξεις-κλειδιά και προϊόντα και υπηρεσίες από το διαδίκτυο.
Κεφάλαιο
Οι κεφαλαιουχικές εταιρείες καταχωρίζουν το κεφάλαιό τους (Stammkapital, εταιρικό κεφάλαιο, ή Grundkapital, μετοχικό κεφάλαιο), κάθε μεταβολή με την ημερομηνία της. Το current είναι το ισχύον ποσό, το history οι μεταβολές με χρονολογική σειρά. Οι προσωπικές εταιρείες και οι ατομικοί έμποροι δεν έχουν σταθερό κεφάλαιο· εκεί το current είναι null και το history κενό.
| Πεδίο | Σημασία | Παράδειγμα | Διαθεσιμότητα |
|---|---|---|---|
| capitalobject | Καταχωρισμένο κεφάλαιο με το ιστορικό του.Βασικά στοιχεία | – | πάντα |
| capital.currentobject|null | Το ισχύον ποσό κεφαλαίου.Κενό όταν η νομική μορφή δεν καταχωρίζει σταθερό κεφάλαιο, για παράδειγμα KG, OHG, e.K. και PartG | – |
πάντα: GmbH, UG, AG, SE, KGaA σπάνια: eG ποτέ: GmbH & Co. KG, KG, OHG, e.K., PartG |
| capital.current.amountnumber | Ποσό ως αριθμός, στο νόμισμα του currency. |
50000 |
όπως παραπάνω |
| capital.current.currencystring | Νόμισμα ως κωδικός ISO 4217, σχεδόν πάντα EUR. |
"EUR" |
όπως παραπάνω |
| capital.current.kindstring |
Είδος κεφαλαίου. Είναι δυνατές και άλλες τιμές.Τιμές: STAMMKAPITAL Stammkapital (εταιρικό κεφάλαιο) μιας GmbH ή UG, GRUNDKAPITAL Grundkapital (μετοχικό κεφάλαιο) μιας AG, SE ή KGaA, LIABILITY_SUM Haftsumme (ποσό ευθύνης), για παράδειγμα ενός συνεταιρισμού, CONDITIONAL υπό αίρεση κεφάλαιο μιας AG, σε παλαιότερες εγγραφές |
"STAMMKAPITAL" |
όπως παραπάνω |
| capital.historyarray | Όλα τα καταχωρισμένα ποσά με χρονολογική σειρά, μαζί με το ισχύον. | – | όπως παραπάνω |
| capital.history[].valueobject | Το ποσό με amount, currency και kind, με την ίδια δομή όπως το current. | – | όπως παραπάνω |
| capital.history[].value.change_amountobject | Ποσό της μεταβολής σύμφωνα με την εγγραφή μητρώου, με amount και currency. Αν το κεφάλαιο αυξήθηκε ή μειώθηκε προκύπτει από τη σύγκριση με το προηγούμενο ποσό. | – |
εν μέρει: AG, SE, KGaA σπάνια: GmbH, UG, eG ποτέ: GmbH & Co. KG, KG, OHG, e.K., PartG |
| capital.history[].effective_fromstring|null | Ισχύει από αυτή την ημέρα, στη μορφή YYYY-MM-DD. |
"2002-10-15" |
πάντα: GmbH, UG, AG, SE, KGaA σπάνια: eG ποτέ: GmbH & Co. KG, KG, OHG, e.K., PartG |
| capital.history[].effective_tostring|null | Ισχύει έως αυτή την ημέρα.Κενό όταν το ποσό ισχύει ακόμη |
"2005-02-28" |
όπως παραπάνω |
Το ιστορικό κεφαλαίου το διαβάζουμε αυτόματα από τις εγγραφές του μητρώου. Χρησιμοποιούμε γι’ αυτό τη νεότερη τεχνολογία και επενδύουμε πολλά στην ποιότητα· μεμονωμένα σφάλματα παραμένουν πιθανά.
Κανόνες εκπροσώπησης
Οι κανόνες εκπροσώπησης (Vertretungsregelung) ορίζουν ποιος μπορεί να ενεργεί για λογαριασμό της εταιρείας. Η απάντηση τους περιέχει αυτολεξεί από το μητρώο, στα γερμανικά. Στο παράδειγμα αιτήματός μας για τη Hetzner Online GmbH, το ιστορικό ανέφερε το διοικητικό συμβούλιο (Vorstand) έως τις 28 Ιουλίου 2015 και στη συνέχεια τους διαχειριστές. Η εξουσία μεμονωμένων προσώπων βρίσκεται στην Εξουσία εκπροσώπησης.
| Πεδίο | Σημασία | Παράδειγμα | Διαθεσιμότητα |
|---|---|---|---|
| representation_schemeobject | Γενικοί κανόνες εκπροσώπησης της εταιρείας με το ιστορικό τους.Βασικά στοιχεία | – |
πάντα: GmbH, UG, GmbH & Co. KG, KG, OHG, eG, PartG συνήθως: AG, SE, KGaA, e.K. |
| representation_scheme.currentarray|null | Οι ισχύοντες κανόνες ως λίστα παραγράφων κειμένου, αυτολεξεί από το μητρώο.Κενό όταν δεν είναι καταχωρισμένοι κανόνες | – | όπως παραπάνω |
| representation_scheme.historyarray | Όλες οι καταχωρισμένες εκδοχές με την ισχύ τους, μαζί με την ισχύουσα. | – | όπως παραπάνω |
| representation_scheme.history[].valuearray | Το κείμενο αυτής της εκδοχής ως λίστα παραγράφων. | – | όπως παραπάνω |
| representation_scheme.history[].effective_fromstring|null | Ισχύει από αυτή την ημέρα, στη μορφή YYYY-MM-DD. |
"2002-10-15" |
όπως παραπάνω |
| representation_scheme.history[].effective_tostring|null | Ισχύει έως αυτή την ημέρα.Κενό όταν η εκδοχή ισχύει ακόμη |
"2015-07-28" |
όπως παραπάνω |
Με Πραγματικό χρόνο, το
history είναι κενό. Η ισχύουσα εκδοχή βρίσκεται στο current.
Επικοινωνία και διαδίκτυο
Τα στοιχεία επικοινωνίας δεν βρίσκονται στο μητρώο. Τα συλλέγουμε από την ιστοσελίδα της εταιρείας. Αν υπάρχουν εξαρτάται επομένως από το τι δημοσιεύει η εταιρεία στο διαδίκτυο.
| Πεδίο | Σημασία | Παράδειγμα | Διαθεσιμότητα |
|---|---|---|---|
| contact_dataobject | Στοιχεία επικοινωνίας από την ιστοσελίδα της εταιρείας.Βασικά στοιχεία | – | πάντα |
| contact_data.websitestring|null | Διεύθυνση της ιστοσελίδας.Κενό όταν δεν βρέθηκε ιστοσελίδα |
"https://www.hetzner.com/" |
εν μέρει |
| contact_data.phone_numberstring|null | Αριθμός τηλεφώνου όπως τον δημοσιεύει η εταιρεία. Η μορφή δεν είναι κανονικοποιημένη.Κενό όταν δεν βρέθηκε αριθμός |
"09831 5050" |
όπως παραπάνω |
| contact_data.emailstring|null | Γενική διεύθυνση email της εταιρείας.Κενό όταν δεν βρέθηκε διεύθυνση |
"[email protected]" |
όπως παραπάνω |
| website_contentstring|null |
Το κείμενο της ιστοσελίδας ως Markdown, για παράδειγμα για δική σου ανάλυση ή για ένα γλωσσικό μοντέλο. Περιλαμβάνεται με το feature website_content, μόνο μαζί με τη Λειτουργία AI και χωρίς επιπλέον κόστος.Κενό όταν δεν βρέθηκε ιστοσελίδαwebsite_content |
"Dedicated Servers, Cloud & Hosting from Germany | Hetzne…" |
όπως παραπάνω |
Πραγματικός χρόνος
Με realtime_mode=handelsregister-default, το API ρωτά επιπλέον ζωντανά το Handelsregister. Η απάντηση περιέχει τότε τα πρόσωπα που είναι εγγεγραμμένα αυτή τη στιγμή και το _realtime_mode με το αποτέλεσμα του ερωτήματος. Ο Πραγματικός χρόνος χρεώνεται μόνο αν το ερώτημα πετύχει, αλλά τότε ανεξάρτητα από το τι επιστρέφει.
| Πεδίο | Σημασία | Παράδειγμα | Διαθεσιμότητα |
|---|---|---|---|
| _realtime_modeobject | Αποτέλεσμα του ερωτήματος Πραγματικού χρόνου. Υπάρχει στην απάντηση μόνο αν ζήτησες realtime_mode.Βασικά στοιχεία | – | πάντα |
| _realtime_mode.modestring | Η λειτουργία που ζητήθηκε, handelsregister-default. |
"handelsregister-default" |
όπως παραπάνω |
| _realtime_mode.statusstring |
Αν το ζωντανό ερώτημα πέτυχε. Με οποιαδήποτε άλλη τιμή, η απάντηση περιέχει τα αποθηκευμένα δεδομένα και ο Πραγματικός χρόνος δεν χρεώνεται.Τιμές: success το ζωντανό ερώτημα πέτυχε, τα δεδομένα προέρχονται απευθείας από το Handelsregister |
"success" |
όπως παραπάνω |
Ένα ερώτημα Πραγματικού χρόνου διαρκεί περισσότερο, γι’ αυτό όρισε το timeout του client σου σε τουλάχιστον 120 δευτερόλεπτα. Αν το ζωντανό ερώτημα αποτύχει, το API επιστρέφει τα αποθηκευμένα δεδομένα. Το
_realtime_mode.status δεν είναι τότε success και ο Πραγματικός χρόνος δεν χρεώνεται. Αν το αίτημα διαρκέσει πολύ, λαμβάνεις 408 χωρίς κόστος· δοκίμασε ξανά αργότερα.
Συνέχεια
fetch-organization
Το endpoint που επιστρέφει τα βασικά στοιχεία, με παραμέτρους και σφάλματα.
Πρόσωπα και εκπροσώπηση
Διαχειριστές, Prokura και εταίροι με τις εξουσίες τους.
Βασικές έννοιες
Πώς διαβάζεις τα current και history, το null και τις κενές λίστες.
Διαθεσιμότητα δεδομένων
Τι περιέχει το μητρώο ανά νομική μορφή και από πού προέρχονται τα δεδομένα.