The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the OtwarteAPI listing page.
Publiczne dane katalogu stojące za otwarteAPI.pl — katalogu publicznych API rządowych z całego świata (Polska, Unia Europejska i kraje z 6 kontynentów — 32 jurysdykcje), opisanych tak by mogły być odkrywane i wywoływane przez agentów AI oraz ludzi.
ai-catalog.json w formacie ARD (Agent Resource Directory) — jeden
maszynowo czytelny plik opisujący każde API: nazwę, opis, endpoint,
wymagany klucz/autoryzację, jurysdykcję (kod kraju, EU lub INT), tagi i
przykładowe zapytania. Ten sam plik serwuje sama strona pod
otwarteapi.pl/.well-known/ai-catalog.json.
Bartosz Kuć (ten sam autor co skanfirmy.pl), prywatny projekt non-profit. Kontakt: firma@bartosza.pl. Więcej na otwarteapi.pl/o-projekcie.
To repozytorium to kopia stanu produkcyjnego, aktualizowana ręcznie. Zaakceptowane PR-y i issue trafiają najpierw tutaj do przeglądu, a dopiero potem są ręcznie przenoszone do prywatnego repo, które faktycznie zasila stronę produkcyjną — nie ma automatycznej synchronizacji w żadną stronę.
entries[] w
ai-catalog.json. Wymagane pola: identifier (URN, np.
urn:air:otwarteapi.pl:api:twoj-slug), displayName, description,
url (dokumentacja techniczna), type, jurisdiction (PL/EU/kod
kraju), tags, metadata.auth (brak jeśli bez klucza), oraz
representativeQueries (2-3 przykładowe pytania, po jednym w
naturalnym języku). API musi być publiczne, oficjalne (rządowe,
samorządowe lub międzynarodowej instytucji publicznej) i mieć żywą,
działającą dokumentację.curl/test), zanim trafi do wersji
produkcyjnej.MIT — patrz LICENSE. Same dane API pozostają własnością i na licencji swoich pierwotnych źródeł (rządów/instytucji UE); ten plik tylko je katalogizuje i linkuje do oficjalnej dokumentacji.