API bazy testów psychologicznych

Publiczne API tylko do odczytu. Możesz pobierać metadane 288 narzędzi (17 bez polskiej adaptacji, 25 z kalkulatorem progów) i używać ich na swojej stronie. Bez klucza, bez rejestracji, CORS otwarty dla każdej domeny.

Szybki start

curl "https://www.statystykana5.pl/api/v1/testy?q=stres&limit=5"

curl "https://www.statystykana5.pl/api/v1/testy/pss-10?lang=en"

Endpointy

GET/api/v1/testy

Lista testów z filtrami i paginacją.

lang: pl (domyślnie) lub en - język pól opisowych
kategoria: identyfikator kategorii, np. stres-lek-radzenie
dostepnosc: platny, darmowy, darmowy_arkusz, rejestracja, nieznana
kategoria_ptp: A, B, B1, B2, C
status: pelny, skrocony, do_weryfikacji
galaz: pl lub en_only (narzędzia bez polskiej adaptacji)
kalkulator: true - tylko testy z kalkulatorem wyniku
q: fraza w nazwie, skrócie i konstrukcie
limit / offset: paginacja, domyślnie 50, maksymalnie 500

GET/api/v1/testy/{slug}

Pełny rekord: budowa, obliczanie, normy, psychometria, dostępność i cena, kalkulator progów, metryka oryginału EN, podgląd arkusza, bibliografia i źródła.

lang: pl lub en

GET/api/v1/kategorie

Słowniki kategorii, typów dostępności i statusów wraz z licznikami wpisów.

GET/api/v1/meta

Metadane bazy: liczba wpisów, statystyki gałęzi językowych, data ostatniej aktualizacji, spis endpointów.

GET/api/v1/openapi.json

Specyfikacja OpenAPI 3.1 do wygenerowania klienta lub importu w Postman i Swagger.

Przykład: JavaScript

const res = await fetch(
  "https://www.statystykana5.pl/api/v1/testy?kategoria=depresja-nastroj&kalkulator=true"
);
const { total, data } = await res.json();

data.forEach((test) => {
  console.log(test.skrot, test.nazwa, test.url);
});

Limity i buforowanie

Bez klucza API i bez rejestracji. Odczyt z dowolnej domeny (CORS otwarty).
Limit 120 zapytań na minutę na adres IP. Po przekroczeniu zwracamy kod 429 z nagłówkiem Retry-After. Każda odpowiedź zawiera X-RateLimit-Remaining.
Odpowiedzi są buforowane na CDN (godzina świeżości, doba stale-while-revalidate). Buforuj wyniki po swojej stronie zamiast odpytywać przy każdym wyświetleniu strony - dane zmieniają się rzadko.
Sprawdzaj updated_at w rekordzie lub endpoint /meta, aby wykryć zmiany.
Potrzebujesz wyższego limitu albo pełnego zrzutu bazy? Napisz do nas.

Licencja i granice

Metadane opisowe udostępniamy na licencji CC BY 4.0. Warunek: podaj źródło i link do https://www.statystykana5.pl/testy.

API nie zawiera treści pozycji testowych, pełnych tabel norm z płatnych podręczników ani skanów arkuszy chronionych prawem autorskim. Zwracamy wyłącznie opisy, parametry psychometryczne z podanych źródeł, linki do wydawców i publikacji oraz progi interpretacyjne opublikowane w otwartym dostępie.

Dane mają charakter informacyjny i edukacyjny. Nie zastępują podręcznika testu ani diagnozy specjalisty. Wpisy oznaczone znacznikiem do weryfikacji wymagają potwierdzenia w źródle pierwotnym.

Endpointy

GET/api/v1/testy

Lista testów z filtrami i paginacją.

lang: pl (domyślnie) lub en - język pól opisowych
kategoria: identyfikator kategorii, np. stres-lek-radzenie
dostepnosc: platny, darmowy, darmowy_arkusz, rejestracja, nieznana
kategoria_ptp: A, B, B1, B2, C
status: pelny, skrocony, do_weryfikacji
galaz: pl lub en_only (narzędzia bez polskiej adaptacji)
kalkulator: true - tylko testy z kalkulatorem wyniku
q: fraza w nazwie, skrócie i konstrukcie
limit / offset: paginacja, domyślnie 50, maksymalnie 500

GET/api/v1/testy/{slug}

Pełny rekord: budowa, obliczanie, normy, psychometria, dostępność i cena, kalkulator progów, metryka oryginału EN, podgląd arkusza, bibliografia i źródła.

lang: pl lub en

GET/api/v1/kategorie

Słowniki kategorii, typów dostępności i statusów wraz z licznikami wpisów.

GET/api/v1/meta

Metadane bazy: liczba wpisów, statystyki gałęzi językowych, data ostatniej aktualizacji, spis endpointów.

GET/api/v1/openapi.json

Specyfikacja OpenAPI 3.1 do wygenerowania klienta lub importu w Postman i Swagger.

const res = await fetch( "https://www.statystykana5.pl/api/v1/testy?kategoria=depresja-nastroj&kalkulator=true" ); const { total, data } = await res.json(); data.forEach((test) => { console.log(test.skrot, test.nazwa, test.url); });

Limity i buforowanie

Bez klucza API i bez rejestracji. Odczyt z dowolnej domeny (CORS otwarty).

Limit 120 zapytań na minutę na adres IP. Po przekroczeniu zwracamy kod 429 z nagłówkiem Retry-After. Każda odpowiedź zawiera X-RateLimit-Remaining.

Odpowiedzi są buforowane na CDN (godzina świeżości, doba stale-while-revalidate). Buforuj wyniki po swojej stronie zamiast odpytywać przy każdym wyświetleniu strony - dane zmieniają się rzadko.

Sprawdzaj updated_at w rekordzie lub endpoint /meta, aby wykryć zmiany.

Potrzebujesz wyższego limitu albo pełnego zrzutu bazy? Napisz do nas.

Licencja i granice

Metadane opisowe udostępniamy na licencji CC BY 4.0. Warunek: podaj źródło i link do https://www.statystykana5.pl/testy.

Dane mają charakter informacyjny i edukacyjny. Nie zastępują podręcznika testu ani diagnozy specjalisty. Wpisy oznaczone znacznikiem do weryfikacji wymagają potwierdzenia w źródle pierwotnym.