Ofte stillede spørgsmål
Svar på det, udviklere oftest spørger om.
Korte svar på de spørgsmål, udviklere oftest stiller. Detaljerne står på den linkede side.
Data
Hvor kommer dataene fra?
Fra de officielle registre og offentliggørelser: Handelsregister (det tyske handelsregister), Unternehmensregister (det tyske virksomhedsregister) med årsregnskaberne og insolvensbekendtgørelserne. Nyheder og hjemmesideindhold kommer fra nettet. Mere under Datatilgængelighed.
Vi læser mange detaljer automatisk ud af de offentliggjorte dokumenter og bekendtgørelser. Vi bruger den nyeste teknologi til det og investerer meget i kvalitet; enkelte fejl er stadig mulige.
Hvor aktuelle er dataene?
En virksomhedsprofil kommer fra vores database. Med Realtid forespørger API’et også Handelsregister live og returnerer de personer, der aktuelt er registreret. API’et henter dokumenter fra registret, når du anmoder om dem.
Hvis det samme dokument blev hentet kort forinden, kan det være op til 24 timer gammelt.
Virksomheder skal offentliggøre årsregnskaber senest tolv måneder efter balancedagen, og mange udnytter hele perioden. Det seneste regnskab dækker derfor ofte forrige år.
Hvorfor mangler en værdi for en virksomhed?
Som regel fordi virksomheden ikke skal offentliggøre den. Hvad der er offentligt, afhænger af selskabsform og størrelse: en lille GmbH offentliggør f.eks. ingen resultatopgørelse, så der er som regel ingen omsætning for den. Tomme værdier optræder som null eller [] i svaret.
Hvad sker der, hvis flere virksomheder har samme navn?
For et navn, som flere virksomheder deler, kan API’et returnere én af dem, ikke nødvendigvis den, du mener, eller svare med 404. Skal det være præcist, så forespørg med registerret og registernummer, f.eks. «Ansbach HRB 6089», eller med entity_id. Registernummeret alene er ikke nok, for det samme nummer findes ved mange retter.
Afregning
Koster en feature kreditter, hvis den ikke returnerer data?
Nej. En feature afregnes kun, når den returnerer data. AI-tilstand afregnes derimod, også hvis den ikke finder nogen virksomhed. Kun hvis API’et afbryder forespørgslen med 408, afregnes den ikke. Realtid koster kreditter for hvert vellykket live-opslag, også hvis det ikke viser noget nyt.
Hvad koster en mislykket forespørgsel?
Intet. En forespørgsel, der ender med en fejl, afregnes ikke; den eneste undtagelse er tillægget for AI-tilstand. Ved status 402 angiver meta.request_credit_cost, hvad forespørgslen højst ville have kostet. Mere under Fejl.
Har jeg brug for et kreditabonnement?
Nej. Du kan bruge virksomhedsprofiler, Søgning & eksport, dokumenter og Signals med enhver konto; du betaler kun kreditterne. Et kreditabonnement låser op for yderligere data:
- Plus: personprofilen.
- Pro: de udvidede Finansielle nøgletal, featuren Virksomhedsnetværk, søgefiltre for ejerskab, ledelse og insolvens samt Signals-emnet Insolvenser.
- Max: alt i Pro plus featuren Dybe ejeroplysninger, aktivitetsregnskaberne fra energiselskaber og Signals-emnet Omdannelser & M&A.
Alt om priser og abonnementer står under Afregning.
Hvor længe er startkreditter og optankningskreditter gyldige?
En ny konto får 150 startkreditter. Uden kreditabonnement er startkreditter og optankningskreditter gyldige i 30 dage. Så længe et kreditabonnement er aktivt, udløber de ikke.
Teknik
Hvilken timeout skal jeg sætte?
For Realtid, personprofiler og dokumenter mindst 120 sekunder, fordi disse forespørgsler tager længere tid. Hvis kun live-opslaget fejler med Realtid, får du de gemte data uden tillægget for Realtid. Tager forespørgslen for lang tid, ender den med 408, for dokumenter med 504. Så trækkes der intet. Prøv igen senere.
Hvor mange forespørgsler kan jeg sende?
For virksomhedsprofiler 60 forespørgsler pr. minut og konto, for dokumenter 5. Derover svarer API’et med status 429 og angiver ventetiden i Retry-After. Alle grænser står under Grænser.
Kan jeg gentage en forespørgsel uden at betale to gange?
Ja, for virksomhedsprofiler, personprofiler, søgning og dokumenter. Send din egen værdi i headeren Idempotency-Key. Gentager du forespørgslen med samme nøgle og samme parametre inden for 24 timer, koster den intet.
Kan jeg bruge flere API-nøgler?
Ja. Under Konto › API-nøgler opretter du flere nøgler, f.eks. én pr. applikation. Sletter du en nøgle, er den ugyldig med det samme. Alle nøgler deler din kontos saldo.