API Karty Strzelca dla firm IT

Budujesz system dla strzelnicy, klubu, sklepu albo organizatora zawodów? Zamiast prosić zawodnika o plastiki i przepisywać numery, odczytaj jego licencję i uprawnienia z Karty — jednym zapytaniem po zeskanowaniu kodu.

Porozmawiajmy o integracji

Co udostępnia API

Odczyt zawodnika

po numerze Karty (z kodu QR) albo po numerze licencji PZSS;
licencja zawodnicza ze statusem, dyscyplinami i datą sprawdzenia w PZSS;
uprawnienia: prowadzący strzelanie, sędzia (klasa, ranga), trener, instruktor, patent — z dyscyplinami, ważnością i flagą „ważne dziś”;
starty w roku według dyscyplin.

Zapis zdarzeń

starty i wyniki z zawodów;
wejścia i wyjścia ze strzelnicy;
jeden kontrakt dla wszystkich programów — ten sam start wysłany dwa razy zapisuje się raz;
zdarzenie osoby bez Karty nie ginie — czeka, aż zawodnik ją założy.

Do czego to się przydaje

Rejestr pobytu na strzelnicy. Prowadzący skanuje swoją kartę — system sprawdza, czy ma ważne uprawnienie prowadzącego, i dopiero wtedy wpuszcza zawodników na oś.
System zawodów. Zapis skanem karty: imię, klub, licencja i dyscypliny bez przepisywania. Wyniki wracają na kartę zawodnika i liczą się do jego startów w roku.
Sklep albo strzelnica komercyjna. Rabat dla posiadaczy karty i sprawdzenie ważności licencji przed sprzedażą czy wydaniem broni na tor.
Aplikacja klubowa. Lista członków z aktualnymi uprawnieniami, bez ręcznego pilnowania dat ważności.

Jak wygląda zapytanie

GET /v0/osoby/KS-7K4M-XY3P
X-Karta-Provider: twoj-program
X-Karta-Ts: 1790170000
X-Karta-Sig: HMAC-SHA256(czas + metoda + ścieżka + treść, klucz programu)

{
  "karta": "KS-7K4M-XY3P",
  "licencja": { "numer": "L-12345", "status": "Ważne", "wazna_do": "2026-12-31",
                "dyscypliny": ["Pistolet", "Karabin", "Strzelba"] },
  "uprawnienia": [
    { "rodzaj": "prowadzacy", "numer": "PS-12345/2024", "wazne_dzis": true },
    { "rodzaj": "sedzia_sport", "klasa": "Klasa Druga", "dyscypliny": ["Pistolet"],
      "wazne_do": "2029-12-31", "wazne_dzis": true, "zrodlo": "oswiadczenie" }
  ],
  "starty_w_roku": { "2026": { "Pistolet": 5, "Karabin": 3, "razem": 8 } }
}

Pełną dokumentację i klucz testowy przekażemy po rozmowie.

Bezpieczeństwo i dane osobowe

Każdy program ma własny klucz, a każde zapytanie jest podpisane (HMAC-SHA256) razem z czasem, metodą i adresem — podpis jest ważny 5 minut i nie da się go użyć do innego zapytania.
Limity zapytań na program i blokada adresów, z których idą błędne podpisy — API nie da się zapchać.
Program dostaje tylko te dane, których potrzebuje do swojego zadania; zakres i podstawę przetwarzania opisujemy w umowie.
Źródło każdego uprawnienia jest jawne: potwierdzone w PZSS albo z oświadczenia posiadacza.
Zgody zawodnika na dostęp konkretnego programu — z możliwością cofnięcia w koncie — uruchamiamy razem z pierwszymi integracjami.

Porozmawiajmy o integracji

Napisz, jaki system budujesz i do czego potrzebujesz danych z Karty. Warunki ustalamy indywidualnie.