Ofte stilte spørsmål
Svar på det utviklere spør oftest om.
Korte svar på spørsmålene utviklere stiller oftest. Detaljene står på den lenkede siden.
Data
Hvor kommer dataene fra?
Fra de offisielle registrene og publikasjonene: Handelsregister (handelsregisteret), Unternehmensregister (foretaksregisteret) med årsregnskapene, og insolvenskunngjøringene. Nyheter og nettstedsinnhold kommer fra nettet. Mer i Datatilgjengelighet.
Mange opplysninger leser vi automatisk fra de publiserte dokumentene og kunngjøringene. Vi bruker den nyeste teknologien til dette og investerer mye i kvalitet; enkelte feil er likevel mulige.
Hvor aktuelle er dataene?
En firmaprofil kommer fra databasen vår. Med Sanntid spør API-et i tillegg Handelsregister live og returnerer personene som er registrert nå. Dokumenter henter API-et fra registeret når du ber om dem.
Ble det samme dokumentet hentet kort tid før, kan det være opptil 24 timer gammelt.
Firmaer må publisere årsregnskap senest tolv måneder etter balansedagen, og mange bruker hele perioden. Det nyeste regnskapet gjelder derfor ofte året før i fjor.
Hvorfor mangler en verdi for et firma?
Som regel fordi firmaet ikke må publisere den. Hva som er offentlig, avhenger av selskapsform og størrelse: en liten GmbH publiserer for eksempel ikke noe resultatregnskap, så det finnes som regel ingen omsetning for den. Tomme verdier vises som null eller [] i svaret.
Hva skjer hvis flere firmaer har samme navn?
For et navn som flere firmaer deler, kan API-et returnere ett av dem, ikke nødvendigvis det du mener, eller svare med 404. Må det være nøyaktig, spør du med registerdomstol og registernummer, for eksempel «Ansbach HRB 6089», eller med entity_id. Registernummeret alene er ikke nok, fordi det samme nummeret finnes ved mange domstoler.
Avregning
Koster en funksjon kreditter hvis den ikke returnerer data?
Nei. En funksjon belastes bare når den returnerer data. AI-modus belastes derimot også når den ikke finner noe firma. Bare hvis API-et avbryter forespørselen med 408, belastes den ikke. Sanntid koster kreditter for hver vellykket live-henting, også når den ikke viser noe nytt.
Hva koster en mislykket forespørsel?
Ingenting. En forespørsel som ender med en feil, belastes ikke; eneste unntak er tillegget for AI-modus. Ved status 402 oppgir meta.request_credit_cost det meste forespørselen ville ha kostet. Mer i Feil.
Trenger jeg et kredittabonnement?
Nei. Firmaprofiler, Søk & eksport, dokumenter og Signals kan du bruke med enhver konto; du betaler bare kredittene. Et kredittabonnement låser opp flere data:
- Plus: personprofilen.
- Pro: de utvidede Økonomiske KPI-ene, funksjonen Firmanettverk, søkefiltre for eierskap, ledelse og insolvens, og Signals-temaet Insolvenser.
- Max: alt i Pro, pluss funksjonen Dype eierdata, aktivitetsregnskapene til energiselskaper og Signals-temaet Omdannelser og M&A.
Alt om priser og abonnementer står i Avregning.
Hvor lenge gjelder startkreditter og påfyllskreditter?
En ny konto får 150 startkreditter. Uten kredittabonnement gjelder startkreditter og påfyllskreditter i 30 dager. Så lenge et kredittabonnement er aktivt, utløper de ikke.
Teknisk
Hvilket tidsavbrudd bør jeg sette?
For Sanntid, personprofiler og dokumenter minst 120 sekunder, fordi disse forespørslene tar lengre tid. Mislykkes bare live-hentingen med Sanntid, får du de lagrede dataene uten tillegget for Sanntid. Tar forespørselen for lang tid, ender den med 408, for dokumenter med 504. Ingenting belastes da. Prøv igjen senere.
Hvor mange forespørsler kan jeg gjøre?
For firmaprofiler 60 forespørsler per minutt og konto, for dokumenter 5. Over det svarer API-et med status 429 og oppgir ventetiden i Retry-After. Alle grenser står i Grenser.
Kan jeg gjenta en forespørsel uten å betale to ganger?
Ja, for firmaprofiler, personprofiler, søk og dokumenter. Send en egen verdi i headeren Idempotency-Key. Gjentar du forespørselen med samme nøkkel og samme parametere innen 24 timer, koster den ingenting.
Kan jeg bruke flere API-nøkler?
Ja. Under Konto › API-nøkler oppretter du flere nøkler, for eksempel én per applikasjon. Sletter du en nøkkel, er den ugyldig umiddelbart. Alle nøkler deler saldoen til kontoen din.