Συχνές ερωτήσεις
Απαντήσεις σε όσα ρωτούν πιο συχνά οι προγραμματιστές.
Σύντομες απαντήσεις στις ερωτήσεις που κάνουν πιο συχνά οι προγραμματιστές. Οι λεπτομέρειες βρίσκονται στη σελίδα του συνδέσμου.
Δεδομένα
Από πού προέρχονται τα δεδομένα;
Από τα επίσημα μητρώα και τις δημοσιεύσεις: το Handelsregister (εμπορικό μητρώο), το Unternehmensregister (μητρώο επιχειρήσεων) με τις ετήσιες οικονομικές καταστάσεις και τις ανακοινώσεις αφερεγγυότητας. Οι ειδήσεις και το περιεχόμενο ιστοσελίδων προέρχονται από το διαδίκτυο. Περισσότερα στη Διαθεσιμότητα δεδομένων.
Πολλές λεπτομέρειες τις διαβάζουμε αυτόματα από τα δημοσιευμένα έγγραφα και τις ανακοινώσεις. Χρησιμοποιούμε γι’ αυτό τη νεότερη τεχνολογία και επενδύουμε πολλά στην ποιότητα· μεμονωμένα σφάλματα παραμένουν πιθανά.
Πόσο επίκαιρα είναι τα δεδομένα;
Ένα προφίλ εταιρείας προέρχεται από τη βάση δεδομένων μας. Με τον Πραγματικό χρόνο, το API ρωτά επιπλέον ζωντανά το Handelsregister και επιστρέφει τα πρόσωπα που είναι εγγεγραμμένα αυτή τη στιγμή. Τα έγγραφα το API τα ανακτά από το μητρώο τη στιγμή που τα ζητάς.
Αν το ίδιο έγγραφο ανακτήθηκε λίγο νωρίτερα, μπορεί να είναι έως 24 ωρών.
Οι εταιρείες πρέπει να δημοσιεύουν τις ετήσιες οικονομικές καταστάσεις το αργότερο δώδεκα μήνες μετά την ημερομηνία ισολογισμού, και πολλές αξιοποιούν όλη την προθεσμία. Οι πιο πρόσφατες καταστάσεις αφορούν επομένως συχνά το προπροηγούμενο έτος.
Γιατί λείπει μια τιμή για μια εταιρεία;
Συνήθως επειδή η εταιρεία δεν υποχρεούται να τη δημοσιεύσει. Τι είναι δημόσιο εξαρτάται από τη νομική μορφή και το μέγεθος: μια μικρή GmbH, για παράδειγμα, δεν δημοσιεύει αποτελέσματα χρήσης, οπότε συνήθως δεν υπάρχει κύκλος εργασιών γι’ αυτήν. Οι κενές τιμές εμφανίζονται στην απάντηση ως null ή [].
Τι συμβαίνει αν πολλές εταιρείες έχουν την ίδια επωνυμία;
Για μια επωνυμία που μοιράζονται πολλές εταιρείες, το API μπορεί να επιστρέψει μία από αυτές, όχι απαραίτητα αυτή που εννοείς, ή να απαντήσει με 404. Αν χρειάζεσαι ακρίβεια, κάνε το ερώτημα με δικαστήριο μητρώου και αριθμό μητρώου, για παράδειγμα «Ansbach HRB 6089», ή με το entity_id. Ο αριθμός μητρώου μόνος του δεν αρκεί, γιατί ο ίδιος αριθμός υπάρχει σε πολλά δικαστήρια.
Χρέωση
Κοστίζει πιστώσεις ένα feature αν δεν επιστρέψει δεδομένα;
Όχι. Ένα feature χρεώνεται μόνο όταν επιστρέφει δεδομένα. Η Λειτουργία AI, αντίθετα, χρεώνεται ακόμη και αν δεν βρει εταιρεία. Μόνο αν το API ακυρώσει το αίτημα με 408 δεν χρεώνεται. Ο Πραγματικός χρόνος κοστίζει πιστώσεις για κάθε επιτυχή ζωντανή ανάκτηση, ακόμη και αν δεν δείξει κάτι νέο.
Τι κοστίζει ένα αποτυχημένο αίτημα;
Τίποτα. Ένα αίτημα που τελειώνει με σφάλμα δεν χρεώνεται· η μόνη εξαίρεση είναι η προσαύξηση για τη Λειτουργία AI. Με status 402, το meta.request_credit_cost αναφέρει το μέγιστο που θα κόστιζε το αίτημα. Περισσότερα στα Σφάλματα.
Χρειάζομαι συνδρομή πιστώσεων;
Όχι. Προφίλ εταιρειών, Αναζήτηση & Εξαγωγή, έγγραφα και Signals μπορείς να τα χρησιμοποιείς με κάθε λογαριασμό· πληρώνεις μόνο τις πιστώσεις. Μια συνδρομή πιστώσεων ξεκλειδώνει επιπλέον δεδομένα:
- Plus: το προφίλ προσώπου.
- Pro: τους διευρυμένους Οικονομικούς δείκτες, το feature Δίκτυο εταιρείας, φίλτρα αναζήτησης για ιδιοκτησία, διοίκηση και αφερεγγυότητα, και το θέμα Signals Αφερεγγυότητες.
- Max: όλα όσα έχει το Pro, συν το feature Εταίροι σε βάθος, τις καταστάσεις δραστηριότητας των εταιρειών ενέργειας και το θέμα Signals Μετασχηματισμοί & M&A.
Όλα για τις τιμές και τα πλάνα στη Χρέωση.
Πόσο ισχύουν οι αρχικές πιστώσεις και οι πιστώσεις επαναφόρτισης;
Ένας νέος λογαριασμός λαμβάνει 150 αρχικές πιστώσεις. Χωρίς συνδρομή πιστώσεων, οι αρχικές πιστώσεις και οι πιστώσεις επαναφόρτισης ισχύουν 30 ημέρες. Όσο είναι ενεργή μια συνδρομή πιστώσεων, δεν λήγουν.
Τεχνικά
Ποιο timeout πρέπει να ορίσω;
Για Πραγματικό χρόνο, προφίλ προσώπων και έγγραφα τουλάχιστον 120 δευτερόλεπτα, γιατί αυτά τα αιτήματα διαρκούν περισσότερο. Αν με τον Πραγματικό χρόνο αποτύχει μόνο η ζωντανή ανάκτηση, λαμβάνεις τα αποθηκευμένα δεδομένα χωρίς την προσαύξηση Πραγματικού χρόνου. Αν το αίτημα διαρκέσει πολύ, τελειώνει με 408, για τα έγγραφα με 504. Τότε δεν χρεώνεται τίποτα. Δοκίμασε ξανά αργότερα.
Πόσα αιτήματα μπορώ να κάνω;
Για προφίλ εταιρειών 60 αιτήματα ανά λεπτό και λογαριασμό, για έγγραφα 5. Πάνω από αυτό, το API απαντά με status 429 και αναφέρει τον χρόνο αναμονής στο Retry-After. Όλα τα όρια στα Όρια.
Μπορώ να επαναλάβω ένα αίτημα χωρίς να πληρώσω δύο φορές;
Ναι, για προφίλ εταιρειών, προφίλ προσώπων, αναζήτηση και έγγραφα. Στείλε μια δική σου τιμή στο header Idempotency-Key. Αν επαναλάβεις το αίτημα με το ίδιο κλειδί και τις ίδιες παραμέτρους μέσα σε 24 ώρες, δεν κοστίζει τίποτα.
Μπορώ να χρησιμοποιώ πολλά κλειδιά API;
Ναι. Στο Λογαριασμός › Κλειδιά API δημιουργείς επιπλέον κλειδιά, για παράδειγμα ένα ανά εφαρμογή. Αν διαγράψεις ένα κλειδί, παύει αμέσως να ισχύει. Όλα τα κλειδιά μοιράζονται το υπόλοιπο του λογαριασμού σου.