Întrebări frecvente
Răspunsuri la ce întreabă dezvoltatorii cel mai des.
Răspunsuri scurte la întrebările pe care dezvoltatorii le pun cel mai des. Detaliile sunt pe pagina indicată.
Date
De unde vin datele?
Din registrele și publicațiile oficiale: Handelsregister (registrul comerțului), Unternehmensregister (registrul companiilor) cu situațiile financiare anuale și anunțurile de insolvență. Știrile și conținutul site-urilor vin de pe web. Mai multe la Disponibilitatea datelor.
Multe informații le citim automat din documentele și publicațiile apărute. Folosim pentru asta cea mai nouă tehnologie și investim mult în calitate; erori izolate sunt totuși posibile.
Cât de actuale sunt datele?
Un profil de companie vine din baza noastră de date. Cu Timp real, API-ul interoghează în plus live Handelsregister și returnează persoanele înscrise în prezent. Documentele le preia API-ul din registru atunci când le ceri.
Dacă același document a fost preluat cu puțin timp înainte, poate fi vechi de până la 24 de ore.
Companiile trebuie să publice situațiile financiare anuale cel târziu la douăsprezece luni după data bilanțului, iar multe folosesc tot termenul. Cea mai recentă situație acoperă de aceea adesea anul de dinainte de anul trecut.
De ce lipsește o valoare pentru o companie?
De obicei pentru că firma nu trebuie să o publice. Ce este public depinde de forma juridică și mărime: un GmbH mic, de exemplu, nu publică un cont de profit și pierdere, așa că de obicei nu există cifră de afaceri pentru el. Valorile goale apar în răspuns ca null sau [].
Ce se întâmplă dacă mai multe companii au același nume?
Pentru un nume pe care îl au mai multe companii, API-ul poate returna una dintre ele, nu neapărat pe cea la care te gândești, sau poate răspunde cu 404. Dacă ai nevoie de precizie, interoghează cu instanța de registru și numărul de registru, de exemplu „Ansbach HRB 6089”, sau cu entity_id. Numărul de registru singur nu ajunge, pentru că același număr există la multe instanțe.
Facturare
Costă o funcție credite dacă nu returnează date?
Nu. O funcție se taxează doar când returnează date. Modul AI, în schimb, se taxează chiar dacă nu găsește nicio companie. Doar dacă API-ul anulează cererea cu 408 nu se taxează. Timp real costă credite la fiecare preluare live reușită, chiar dacă nu arată nimic nou.
Cât costă o cerere eșuată?
Nimic. O cerere care se termină cu o eroare nu se taxează; singura excepție este suprataxa pentru Modul AI. La statusul 402, meta.request_credit_cost indică maximul pe care l-ar fi costat cererea. Mai multe la Erori.
Am nevoie de un abonament de credite?
Nu. Profilurile de companie, Căutare & Export, documentele și Signals le poți folosi cu orice cont; plătești doar creditele. Un abonament de credite deblochează date suplimentare:
- Plus: profilul de persoană.
- Pro: indicatorii financiari extinși, funcția Rețeaua companiei, filtrele de căutare pentru proprietate, conducere și insolvență, precum și tema Signals Insolvențe.
- Max: tot ce include Pro, plus funcția Asociați detaliat, situațiile de activitate ale furnizorilor de energie și tema Signals Transformări & M&A.
Totul despre prețuri și planuri găsești la Facturare.
Cât timp sunt valabile creditele de start și creditele din reîncărcare?
Un cont nou primește 150 credite de start. Fără abonament de credite, creditele de start și cele din reîncărcare sunt valabile 30 zile. Cât timp un abonament de credite este activ, nu expiră.
Tehnic
Ce timeout ar trebui să setez?
Pentru Timp real, profiluri de persoană și documente cel puțin 120 secunde, pentru că aceste cereri durează mai mult. Dacă la Timp real eșuează doar preluarea live, primești datele salvate fără suprataxa pentru Timp real. Dacă cererea durează prea mult, se termină cu 408, la documente cu 504. Nu se taxează atunci nimic. Încearcă din nou mai târziu.
Câte cereri pot face?
Pentru profiluri de companie 60 cereri pe minut și cont, pentru documente 5. Peste acestea, API-ul răspunde cu statusul 429 și indică timpul de așteptare în Retry-After. Toate limitele sunt la Limite.
Pot repeta o cerere fără să plătesc de două ori?
Da, pentru profiluri de companie, profiluri de persoană, căutare și documente. Trimite o valoare proprie în headerul Idempotency-Key. Dacă repeți cererea cu aceeași cheie și aceiași parametri în 24 de ore, nu costă nimic.
Pot folosi mai multe chei API?
Da. La Cont › Chei API creezi alte chei, de exemplu câte una per aplicație. Dacă ștergi o cheie, este invalidă imediat. Toate cheile împart soldul contului tău.