Instytucje POL-on – scenariusze użycia usługi

https://radon.nauka.gov.pl/api/katalog-udostepniania-danych/dane-polon/polon/reports_institution

Scenariusz 1 – pobranie danych instytucji o wskazanym rodzaju i statusie

Request:

1. Liczba rekordów, która zostanie zwrócona = 1
2. Rodzaj instytucji = 13 (Uczelnia publiczna)
3. Status instytucji = 1 (Działająca)

Request URL: https://radon.nauka.gov.pl/opendata/polon/institutions?resultNumbers=1&iKindCd=13&statusCode=1

Response:

{
  "results": [
    {
      "country": "Polska",
      "city": "Warszawa",
      "regon": "000327830",
      "managerSurname": null,
      "countryCd": "167",
      "pib": "0",
      "institutionUuid": "eea34b38-b88c-44b7-acb1-5c9a8a9f7d66",
      "lNumber": null,
      "siTypeName": null,
      "managerName": null,
      "ministryNumber": "298",
      "eMail": "mpoplawski@awf.edu.pl",
      "supervisingInstitutionID": "2b2e64d0-dc32-4575-ba6c-073f0757f4f9",
      "nip": "5250011875",
      "street": "Marymoncka",
      "www": "http://www.awf.edu.pl",
      "espAddress": "/RektorAWFWarszawa/SkrytkaESP",
      "voivodeship": "mazowieckie",
      "id": "3884",
      "iKindName": "Uczelnia publiczna",
      "lastRefresh": "1628775424292",
      "postalCd": "00-968",
      "bNumber": "34",
      "panNumber": null,
      "branches": [
        {
          "branchUuid": "481c33c6-594c-4276-b211-c0bf8d5967a1",
          "branchName": "Wydział Wychowania Fizycznego i Sportu w Białej Podlaskiej (Filia)",
          "branchCity": "Biała Podlaska"
        },
        {
          "branchUuid": "ddc27da2-0d61-449d-8fc4-1dab84f4079b",
          "branchName": "Wydział Wychowania Fizycznego i Zdrowia",
          "branchCity": "Biała Podlaska"
        },
        {
          "branchUuid": "962a50a7-942d-4f95-a4b7-1b68b2242291",
          "branchName": "Wydział Turystyki i Zdrowia w Białej Podlaskiej (Filia)",
          "branchCity": "Biała Podlaska"
        }
      ],
      "krs": null,
      "supervisingInstitutionName": "Ministerstwo Edukacji i Nauki (poprzednio MNiSW)",
      "iLiqStartDT": null,
      "eunNumber": null,
      "uTypeName": "akademicka",
      "institutionUid": "bW8T71vzldJ2ei1kMfqSN3g",
      "phone": "22 865 10 80",
      "iStartDT": "1929-11-29",
      "iLiqDT": null,
      "name": "Akademia Wychowania Fizycznego Józefa Piłsudskiego w Warszawie",
      "iKindCd": "13",
      "siTypeCd": null,
      "yearPib": null,
      "uTypeCd": "1",
      "dataSource": "POLON",
      "voivodeshipCode": "7",
      "status": "Działająca",
      "statusCode": "1"
    }
  ],
  "pagination": {
    "maxCount": 131,
    "token": "MTYyODc3NTQyNDI5Mg=="
  },
  "version": "1.7.0"
}

Scenariusz 2 – pobranie kolejnej strony z wynikami

Każda poprawna odpowiedź usługi zawiera token, który umożliwia pobranie kolejnej partii danych. Aby pobrać kolejną stronę z wynikami, w następnym zapytaniu należy użyć tokenu, który został zwrócony w poprzedniej odpowiedzi (parametr token).

Request z użyciem tokenu: 

1. Liczba rekordów, która zostanie zwrócona = 1
2. Rodzaj instytucji = 13 (Uczelnia publiczna)
3. Status instytucji = 1 (Działająca)
4. Token (token należy skopiować ze zwróconej poprzednio odpowiedzi)

Request URL: https://radon.nauka.gov.pl/opendata/polon/institutions?resultNumbers=1&token=MTYyODc3NTQyNDI5Mg%3D%3D&iKindCd=13&statusCode=1

Response:

Po użyciu tokenu został zwrócony kolejny rekord.

{
  "results": [
    {
      "country": "Polska",
      "city": "Warszawa",
      "regon": "000275702",
      "managerSurname": null,
      "countryCd": "167",
      "pib": "0",
      "institutionUuid": "47e86fcb-d7b4-4631-822c-b5647a72e885",
      "lNumber": null,
      "siTypeName": null,
      "managerName": null,
      "ministryNumber": "316",
      "eMail": "info@chopin.edu.pl",
      "supervisingInstitutionID": "5b64b6e6-7375-4037-89d8-ef183ea2c1f0",
      "nip": "5250007715",
      "street": "Okólnik",
      "www": "http://www.chopin.edu.pl",
      "espAddress": null,
      "voivodeship": "mazowieckie",
      "id": "3903",
      "iKindName": "Uczelnia publiczna",
      "lastRefresh": "1628775424298",
      "postalCd": "00-368",
      "bNumber": "2",
      "panNumber": null,
      "branches": [
        {
          "branchUuid": "76717999-b71c-4160-9041-6859b164f57b",
          "branchName": "Uniwersytet Muzyczny Fryderyka Chopina Filia w Białymstoku",
          "branchCity": "Białystok"
        }
      ],
      "krs": null,
      "supervisingInstitutionName": "Ministerstwo Kultury i Dziedzictwa Narodowego",
      "iLiqStartDT": null,
      "eunNumber": null,
      "uTypeName": "akademicka",
      "institutionUid": "bv6QBJvPL8aygKOu5jtJPBQ",
      "phone": "+48 22 8277241",
      "iStartDT": "1810-01-01",
      "iLiqDT": null,
      "name": "Uniwersytet Muzyczny Fryderyka Chopina w Warszawie",
      "iKindCd": "13",
      "siTypeCd": null,
      "yearPib": null,
      "uTypeCd": "1",
      "dataSource": "POLON",
      "voivodeshipCode": "7",
      "status": "Działająca",
      "statusCode": "1"
    }
  ],
  "pagination": {
    "maxCount": 131,
    "token": "MTYyODc3NTQyNDI5OA=="
  },
  "version": "1.7.0"
}