Prawnet Dane

API grafu cytowań BETA

Programistyczny dostęp do grafu przepis ↔ orzeczenie: te same dane, które napędzają prawnet.pl — na żywo, w JSON, z kluczem API. Bez treści orzeczeń: wyłącznie krawędzie, metadane i liczniki.

Wygeneruj klucz w panelu O Prawnet Dane

Szybki start

Jedno zapytanie i działa

Wygeneruj klucz w panelu (Klucze API), dodaj nagłówek Authorization i wywołaj dowolny endpoint. Klucz pokazujemy tylko raz — przechowujemy wyłącznie jego skrót.

curl -H "Authorization: Bearer pk_live_TWOJ_KLUCZ" \
  "https://api.prawnet.pl/v1/przepisy/1964/93/415/orzeczenia?limit=10"

Prefiks adresów: https://api.prawnet.pl/v1 (równoważnie: https://prawnet.pl/api/v1) — sam prefiks nie jest endpointem, wywołuje się dopiero konkretną ścieżkę poniżej. Odpowiedzi są w JSON (UTF-8) i zawsze prywatne (Cache-Control: private) — każde zapytanie jest zliczane na Twoim kluczu.

Endpointy

Pięć uchwytów do grafu

Wszystkie metodą GET, wszystkie z kluczem. Adresy przepisów używają współrzędnych Dz.U.: rok, pozycja i artykuł (np. 1964 / 93 / 415 = art. 415 k.c.; artykuły z indeksem górnym zapisujemy z łącznikiem: 449-1).

GET/v1/przepisy/{rok}/{poz}/{art}/orzeczenia

Orzeczenia powołujące jeden przepis Dz.U. (najnowsze najpierw) + liczniki per sąd. Metadane i stały link — bez treści orzeczeń.

Parametry: sad (SUPREME | CONSTITUTIONAL_TRIBUNAL | NATIONAL_APPEAL_CHAMBER | COMMON), limit ≤ 200, offset ≤ 5000

Przykład: /v1/przepisy/1964/93/415/orzeczenia?limit=10

GET/v1/przepisy/{rok}/{poz}/{art}/stats

Statystyka jednego przepisu: łączna liczba cytowań, podział per sąd oraz — gdy dostępna — statystyka rozstrzygnięć (rozkład wyników, kwartyle kwot).

Parametry: —

Przykład: /v1/przepisy/1964/93/415/stats

GET/v1/przepisy/{rok}/{poz}/artykuly

Wszystkie artykuły jednego aktu z liczbą orzeczeń (malejąco) — mapa cytowań całej ustawy.

Parametry: —

Przykład: /v1/przepisy/1964/93/artykuly

GET/v1/przepisy/top

Najczęściej cytowane pary (akt, artykuł) w całym grafie.

Parametry: min (próg cytowań, domyślnie 5), limit ≤ 200, offset ≤ 5000

Przykład: /v1/przepisy/top?min=100&limit=20

GET/v1/orzeczenia/{id}/przepisy

Przepisy Dz.U. powołane w jednym orzeczeniu (art = null to powołanie całego aktu).

Parametry: —

Przykład: /v1/orzeczenia/123456/przepisy

Limity i błędy

Plany, nagłówki, kody

Limit jest dzienny (doba UTC), liczony osobno na każdy klucz. Stan limitu odczytasz z nagłówków każdej odpowiedzi.

Plany

Free — 1000 zapytań dziennie na klucz; start bez rozmowy z nami
Pro — 50 000 zapytań dziennie na klucz; napisz do nas
Nagłówki: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (epoch, północ UTC)
Beta: schemat odpowiedzi może się jeszcze doprecyzować — zmiany ogłosimy na tej stronie

Kody błędów

400	nieprawidłowe parametry ścieżki lub zapytania
401	brak nagłówka Authorization: Bearer pk_live_…
403	klucz nieznany lub dezaktywowany
404	zasób nie istnieje (np. orzeczenie o tym id)
429	przekroczony dzienny limit planu — patrz nagłówki X-RateLimit-*
502	chwilowy błąd bazy — ponów zapytanie
503	API chwilowo niedostępne (api-not-ready)

Źródło orzeczeń: publiczny rejestr SAOS (saos.org.pl); graf cytowań jest opracowaniem Prawnet. Użycie API podlega tym samym zasadom licencyjnym co pakiet Prawnet Dane — trenowanie modeli AI/ML wymaga odrębnej licencji.