Dokumentacja

API dla instytucji

Dostęp maszynowy do bazy dla kancelarii, wydawnictw prawniczych, uczelni i systemów wewnętrznych. Poniżej kontrakt; o klucz występuje się mailem.

Jak uzyskać dostęp

Klucz nadajemy indywidualnie. Napisz na support@danaco-core.pl, podając nazwę instytucji, przewidywane zastosowanie i szacowaną liczbę zapytań dziennie. Dostęp do samej bazy dla instytucji wyceniamy osobno; limity ustalamy pod obciążenie.

Uwierzytelnianie

Klucz przekazuje się w nagłówku X-Danaco-Klucz. Żądania bez klucza albo z kluczem nieznanym otrzymują odpowiedź o braku uprawnienia. Klucza nie umieszcza się w adresie ani w parametrach zapytania.

Czynności

Wszystkie czynności przyjmują żądanie POST z treścią w formacie JSON i zwracają JSON.

Ścieżka	Pola	Co zwraca
`/szukaj`	zapytanie, zakres, liczba	Wyszukiwanie w wybranym zakresie albo pakiet materiału.
`/artykul`	akt, jednostka	Brzmienie jednostki redakcyjnej wraz z metryką aktu.
`/komentarz`	akt, jednostka	Komentarze przypięte do wskazanej jednostki.
`/orzecznictwo`	zapytanie, liczba	Wyszukiwanie wyłącznie w orzeczeniach.
`/aktualnosc`	akt, jednostka, data	Metryka aktu: status, wejście w życie, publikator.
`/prowenancja`	sygnatura	Pochodzenie orzeczenia i kontrola źródła.
`/wiernosc`	teza, sygnatura	Sprawdzenie, czy teza jest wierna treści orzeczenia.
`/pakiet`	zagadnienie	Przepisy, orzecznictwo i komentarze do jednego zagadnienia.

Przykład

curl -X POST https://api.danaco-lex.pl/szukaj \
  -H "Content-Type: application/json" \
  -H "X-Danaco-Klucz: dlx_..." \
  -d '{"zapytanie":"przedawnienie roszczenia z faktury","zakres":"orzecznictwo","liczba":10}'

Odpowiedź zawiera trafienia rozwiązane do rekordów bazy — każde z identyfikatorem, sygnaturą albo oznaczeniem jednostki. Trafienie, którego nie da się rozwiązać do rekordu, nie jest zwracane.

Limity

Limit dzienny jest przypisany do klucza i liczony od północy UTC. Wysokość limitu ustalamy przy wydaniu klucza — nie ma jednej wartości domyślnej. Po przekroczeniu czynności zwracają odmowę do końca doby.

Zapytania pełnotekstowe na całym zbiorze są kosztowne — jeśli planujesz masowe przetwarzanie, napisz do nas zamiast rozkładać je na wiele kluczy.

Zasady korzystania

Dane pochodzą ze źródeł publicznych; przy ich dalszym udostępnianiu podaj pochodzenie i datę pobrania.
Nie prezentuj wyniku API jako porady prawnej ani jako urzędowego tekstu przepisu.
Zachowaj oznaczenia stanu jednostki — usunięcie ich z interfejsu tworzy ryzyko, którego cały ten projekt unika.
Nie odsprzedawaj dostępu bez uzgodnienia.

Zobacz też Licencję i źródła oraz Czego nie robimy.