Najczęstsze pytania
Odpowiedzi na to, o co programiści pytają najczęściej.
Krótkie odpowiedzi na pytania, które programiści zadają najczęściej. Szczegóły są na podlinkowanej stronie.
Dane
Skąd pochodzą dane?
Z urzędowych rejestrów i publikacji: Handelsregister (rejestr handlowy), Unternehmensregister (rejestr przedsiębiorstw) ze sprawozdaniami finansowymi oraz obwieszczeń upadłościowych. Wiadomości i treści stron internetowych pochodzą z sieci. Więcej w Dostępności danych.
Wiele informacji odczytujemy automatycznie z opublikowanych dokumentów i obwieszczeń. Używamy do tego najnowszej technologii i dużo inwestujemy w jakość; pojedyncze błędy są jednak możliwe.
Jak aktualne są dane?
Profil firmy pochodzi z naszej bazy danych. W trybie czasu rzeczywistego API dodatkowo odpytuje Handelsregister na żywo i zwraca aktualnie wpisane osoby. Dokumenty API pobiera z rejestru w chwili, gdy o nie prosisz.
Jeśli ten sam dokument był pobierany niedawno, może mieć do 24 godzin.
Firmy muszą publikować sprawozdania finansowe najpóźniej dwanaście miesięcy po dniu bilansowym, a wiele wykorzystuje pełny okres. Najnowsze sprawozdanie dotyczy więc często roku przedostatniego.
Dlaczego dla firmy brakuje wartości?
Zwykle dlatego, że firma nie musi jej publikować. Co jest publiczne, zależy od formy prawnej i wielkości: mała GmbH np. nie publikuje rachunku zysków i strat, więc zwykle nie ma dla niej przychodów. Puste wartości pojawiają się w odpowiedzi jako null lub [].
Co się dzieje, gdy kilka firm ma tę samą nazwę?
Dla nazwy, którą dzieli kilka firm, API może zwrócić jedną z nich, niekoniecznie tę, o którą ci chodzi, albo odpowiedzieć 404. Jeśli potrzebujesz dokładności, pytaj z sądem rejestrowym i numerem rejestru, np. „Ansbach HRB 6089”, albo z entity_id. Sam numer rejestru nie wystarcza, bo ten sam numer istnieje w wielu sądach.
Rozliczanie
Czy feature kosztuje kredyty, jeśli nie zwraca danych?
Nie. Feature jest naliczany tylko wtedy, gdy zwraca dane. Tryb AI jest natomiast naliczany także wtedy, gdy nie znajdzie firmy. Nie jest naliczany tylko wtedy, gdy API przerwie zapytanie z kodem 408. Tryb czasu rzeczywistego kosztuje kredyty przy każdym udanym pobraniu na żywo, nawet jeśli nie pokazuje nic nowego.
Ile kosztuje nieudane zapytanie?
Nic. Zapytanie zakończone błędem nie jest naliczane; jedynym wyjątkiem jest dopłata za tryb AI. Przy statusie 402 meta.request_credit_cost podaje maksymalny koszt, jaki miałoby zapytanie. Więcej w Błędach.
Czy potrzebuję subskrypcji kredytów?
Nie. Z profili firm, Wyszukiwania i eksportu, dokumentów i Signals korzystasz na każdym koncie; płacisz tylko kredyty. Subskrypcja kredytów odblokowuje dodatkowe dane:
- Plus: profil osoby.
- Pro: rozszerzone Wskaźniki finansowe, feature Sieć powiązań firmy, filtry wyszukiwania dotyczące własności, zarządu i niewypłacalności oraz temat Signals Niewypłacalności.
- Max: wszystko z Pro, a do tego feature Szczegółowe dane wspólników, sprawozdania z działalności przedsiębiorstw energetycznych i temat Signals Przekształcenia i M&A.
Wszystko o cenach i planach znajdziesz w Rozliczaniu.
Jak długo ważne są kredyty startowe i z doładowań?
Nowe konto dostaje 150 kredytów startowych. Bez subskrypcji kredytów kredyty startowe i z doładowań są ważne przez 30 dni. Dopóki subskrypcja kredytów jest aktywna, nie wygasają.
Technika
Jaki timeout ustawić?
Dla trybu czasu rzeczywistego, profili osób i dokumentów co najmniej 120 sekund, bo te zapytania trwają dłużej. Jeśli w trybie czasu rzeczywistego nie uda się tylko pobranie na żywo, dostajesz zapisane dane bez dopłaty. Jeśli zapytanie trwa za długo, kończy się kodem 408, przy dokumentach 504. Nic nie jest wtedy naliczane. Spróbuj ponownie później.
Ile zapytań mogę wysłać?
Dla profili firm 60 zapytań na minutę i konto, dla dokumentów 5. Powyżej tego API odpowiada statusem 429 i podaje czas oczekiwania w Retry-After. Wszystkie limity znajdziesz w Limitach.
Czy mogę powtórzyć zapytanie bez podwójnej opłaty?
Tak, dla profili firm, profili osób, wyszukiwania i dokumentów. Wyślij własną wartość w nagłówku Idempotency-Key. Jeśli powtórzysz zapytanie z tym samym kluczem i tymi samymi parametrami w ciągu 24 godzin, nic nie kosztuje.
Czy mogę używać kilku kluczy API?
Tak. W Konto › Klucze API tworzysz kolejne klucze, np. jeden na aplikację. Usunięty klucz traci ważność natychmiast. Wszystkie klucze korzystają z salda twojego konta.