O tym API
legislation.gov.uk to oficjalny serwis publikujący ustawodawstwo Wielkiej Brytanii, prowadzony przez The National Archives. API pozwala pobrać treść i metadane dowolnego aktu przez dopisanie rozszerzenia formatu do jego adresu — /data.xml zwraca dokument w standardzie CLML (Crown Legislation Markup Language); dostępne są też reprezentacje /data.rdf i /data.html oraz kanały Atom (/data.feed) do śledzenia nowych publikacji. Adresy mają czytelny wzorzec {typ}/{rok}/{numer} (np. ukpga/2015/26 to Small Business, Enterprise and Employment Act 2015). Dane obejmują wersje ujednolicone (z pewnymi ograniczeniami co do zakresu i aktualności) i są udostępniane bez klucza na licencji Open Government Licence v3.0.
Najczęstsze pytania
Czy trzeba mieć klucz API?
Nie. Dostęp jest w pełni otwarty — nie potrzeba rejestracji ani klucza API. Wystarczy wysłać żądanie GET pod adres dokumentu z rozszerzeniem /data.xml.
Jakie dane zwraca to API?
Pełną treść i metadane brytyjskich aktów prawnych — ustaw (Acts), aktów wykonawczych (Statutory Instruments) i wersji ujednoliconych — łącznie z numeracją, datami wejścia w życie, strukturą dokumentu i historią zmian, w formacie XML zgodnym ze schematem CLML.
Czy można wywołać to API bezpośrednio z przeglądarki?
Technicznie tak — endpoint zwraca otwarty nagłówek CORS (Access-Control-Allow-Origin: *), więc zapytanie z przeglądarki się powiedzie. Odpowiedzią jest jednak obszerny dokument XML (CLML), często wielomegabajtowy, a nie zwięzły JSON — nie nadaje się na prosty przycisk demo, dlatego nie ma tu testera na żywo. W praktyce wywołuje się to API po stronie serwera i parsuje XML.
Kto prowadzi to API?
The National Archives — brytyjska instytucja archiwum państwowego. Pełna dokumentacja dla deweloperów jest dostępna pod legislation.gov.uk/developer.