O tym API
Departament Stanu stanu Nowy Jork prowadzi rejestr wszystkich zgłoszeń każdej spółki zarejestrowanej w tym stanie. Zbiór „Active Corporations: Beginning 1800" obejmuje podmioty aktywne na koniec danego miesiąca i dla każdego zwraca m.in. numer DOS ID, aktualną nazwę, datę pierwszego zgłoszenia, typ podmiotu, hrabstwo oraz nazwę i adres do doręczeń (agenta procesowego). Dane wystawia platforma Socrata (SODA), więc filtrujesz je parametrami SoQL: $where, $q, $select i $limit. Endpoint zwraca nagłówek CORS (Access-Control-Allow-Origin: *), dzięki czemu można go odpytywać bezpośrednio z kodu przeglądarki, bez klucza i bez rejestracji.
Najczęstsze pytania
Czy trzeba mieć klucz API?
Nie. Endpoint jest w pełni otwarty — działa bez klucza API i bez rejestracji. Socrata pozwala opcjonalnie dodać bezpłatny token aplikacji (App Token), aby uzyskać wyższe limity zapytań, ale nie jest on wymagany do korzystania z danych.
Jakie dane zwraca to API?
Listę czynnych spółek zarejestrowanych w Departamencie Stanu stanu Nowy Jork. Dla każdego podmiotu zwraca m.in. numer DOS ID, aktualną nazwę, datę pierwszego zgłoszenia, typ podmiotu (np. DOMESTIC BUSINESS CORPORATION), hrabstwo oraz nazwę i adres do doręczeń. Odpowiedź jest w formacie JSON i można ją filtrować zapytaniami SoQL.
Czy można wywołać to API bezpośrednio z przeglądarki?
Tak. Endpoint zwraca nagłówek CORS (Access-Control-Allow-Origin: *), więc możesz odpytywać go bezpośrednio z kodu frontendu, bez pośrednika po stronie serwera. Dlatego na tej stronie działa przycisk „Wypróbuj".
Kto prowadzi to API?
Departament Stanu stanu Nowy Jork (Wydział Korporacji), który prowadzi stanowy rejestr spółek. Dane publikuje na stanowym portalu otwartych danych data.ny.gov, działającym na platformie Socrata.