Developer

Dokumentacja API

REST API do kolejek SOR, katalogu placówek, oddziałów szpitali i świadczeń NFZ. Poniżej pełne requesty i response’y oraz tester — wklej klucz z panelu konta i wyślij żądanie. Plany i limity: /cennik. Skrót autoryzacji: /dokumentacja-api.

Baza: https://kolejkisor.pl/api/public

Auth: X-Api-Key + X-Api-Secret

Format: JSON · limity per plan

GEThospitals.listStarter

Lista SOR-ów

/api/public/hospitals

Aktywne jednostki kolejkowe SOR z metrykami obciążenia. Nie mylić z katalogiem szpitali (/facilities).

Parametry

Parametr	Lokalizacja	Typ	Wartość	Opis
voivodeship	query	string		Filtr po województwie (np. Mazowieckie).

Wypróbuj

/api/public/hospitals

curl "https://kolejkisor.pl/api/public/hospitals" \
  -H "X-Api-Key: sor_live_…" \
  -H "X-Api-Secret: <sekret>"

Odpowiedź 200

Lista SOR-ów i źródło danych.

{
  "hospitals": [
    {
      "id": "a1b2c3d4-0000-0000-0000-000000000001",
      "name": "Szpital Wojewódzki — SOR",
      "city": "Warszawa",
      "voivodeship": "Mazowieckie",
      "main_wait_minutes": 95,
      "total_patients": 42,
      "load_index": 68,
      "load_category": "wysokie",
      "freshness": "fresh"
    }
  ],
  "source": "pacjent.gov.pl"
}

Błędy

401

{
  "error": {
    "code": "unauthorized",
    "message": "Brakuje nagłówków X-Api-Key / X-Api-Secret."
  }
}

403

{
  "error": {
    "code": "plan_upgrade_required",
    "message": "Twój plan nie obejmuje tego endpointu."
  }
}

429

{
  "error": {
    "code": "rate_limited",
    "message": "Przekroczono limit minutowy — spróbuj później."
  }
}