{"id":4402,"date":"2019-11-14T17:17:48","date_gmt":"2019-11-14T16:17:48","guid":{"rendered":"https:\/\/polon.nauka.gov.pl\/pomoc\/?post_type=lsvr_lore_kb&#038;p=4402"},"modified":"2025-08-25T13:22:45","modified_gmt":"2025-08-25T11:22:45","slug":"dokumentacja-api-dla-pol-on-2-0","status":"publish","type":"lsvr_lore_kb","link":"https:\/\/polon.nauka.gov.pl\/pomoc\/knowledge-base\/dokumentacja-api-dla-pol-on-2-0\/","title":{"rendered":"Dokumentacja API dla POL-on 2.0"},"content":{"rendered":"\n<p><strong>W tym wpisie znajdziesz linki do specyfikacji us\u0142ug API REST.<\/strong><\/p>\n\n\n\n<p class=\"has-black-color has-text-color has-background has-link-color wp-elements-8091a7d8495a5d3b31f6b7bd74fe518a\" style=\"background-color:#dce8f6\">Dotychczasowe <a href=\"http:\/\/polon.nauka.gov.pl\/api-rest\" target=\"_blank\" rel=\"noreferrer noopener\">API systemu POL-on<\/a> b\u0119dzie systematycznie wygaszane wraz migracj\u0105 poszczeg\u00f3lnych us\u0142ug do nowego systemu POL-on 2.0.<br>Specyfikacj\u0119 API REST&nbsp;przedstawion\u0105 w trakcie konsultacji technicznych znajdziesz pod linkiem: <a href=\"https:\/\/polon.nauka.gov.pl\/pomoc\/wp-content\/uploads\/2020\/03\/POL-on-Specyfikacja-API-REST-w-systemie-POL-on-wersja-1.0.1.pdf\">POL-on &#8211; Specyfikacja API REST w systemie POL-on &#8211; wersja 1.0<\/a><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">\u015arodowisko produkcyjne <strong><a href=\"https:\/\/polon2.opi.org.pl\/home\/login\">https:\/\/polon2.opi.org.pl\/home\/login<\/a><\/strong><\/h2>\n\n\n\n<p><a href=\"https:\/\/radon.nauka.gov.pl\/api\/katalog-edycji-danych\/polon-v2\" data-type=\"link\" data-id=\"https:\/\/radon.nauka.gov.pl\/api\/katalog-edycji-danych\/polon-v2\" target=\"_blank\" rel=\"noreferrer noopener\">Us\u0142ugi edycji danych POL-on 2.0<\/a> obejmuj\u0105 nast\u0119puj\u0105ce dziedziny:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Us\u0142uga Role i Uprawnienia (Users)<\/li>\n\n\n\n<li>Pracownicy (Employees)<\/li>\n\n\n\n<li>S\u0142owniki dla us\u0142ugi Pracownicy<\/li>\n\n\n\n<li>Kierunki studi\u00f3w (Fields of study)<\/li>\n\n\n\n<li>Instytucje (Institutions)<\/li>\n\n\n\n<li>Osoby ubiegaj\u0105ce si\u0119 o stopie\u0144 doktora (PHD Students)<\/li>\n\n\n\n<li>Szko\u0142y doktorskie (Doctoral Schools)<\/li>\n\n\n\n<li>Post\u0119powania awansowe (Promotions i Promotion)<\/li>\n\n\n\n<li>Patenty i prawa ochronne (Patents)<\/li>\n\n\n\n<li>Projekty naukowe (Projects)<\/li>\n\n\n\n<li>Dane finansowe jednostki (Financial data)<\/li>\n\n\n\n<li>Osi\u0105gni\u0119cia artystyczne (Artistic Achievement)<\/li>\n\n\n\n<li>Cudzoziemcy (Foreigners)<\/li>\n<\/ul>\n\n\n\n<p>Katalog us\u0142ug RAD-on zawieraj\u0105cy dost\u0119p do danych (bez zapisu) og\u00f3lnodost\u0119pnych znajdziesz pod adresem: <a href=\"https:\/\/radon.nauka.gov.pl\/api\/katalog-udostepniania-danych\">https:\/\/radon.nauka.gov.pl\/api\/katalog-udostepniania-danych<\/a><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">\u015arodowisko demonstracyjne (DEMO) <a href=\"https:\/\/polon2-demo.opi.org.pl\/home\/login\"><strong>https:\/\/polon2-demo.opi.org.pl\/home\/login<\/strong><\/a><\/h2>\n\n\n\n<p>\u015arodowisko demonstracyjne s\u0142u\u017cy do cel\u00f3w testowych u\u017cytkownikom systemu POL-on 1 oraz POL-on 2.0.<\/p>\n\n\n\n<p>\u015arodowiska produkcyjne i demonstracyjne wykorzystuj\u0105 do autoryzacji ten sam system MCL. Uprawnienia i ustawienia kont z produkcji systemu POL-on 1 i POL-on 2.0 obowi\u0105zuj\u0105 tak\u017ce na \u015brodowisku testowym. <strong>Dane s\u0105 synchronizowane z danymi produkcyjnymi raz w tygodniu (wtorek)<\/strong>. Oznacza to, \u017ce dane na \u015brodowisku demonstracyjnym s\u0105 nadpisywane danymi produkcyjnymi.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Specyfikacja us\u0142ug API REST do przetestowania na DEMO<\/strong><\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Us\u0142uga Role i Uprawnienia (Users) : <a href=\"https:\/\/polon2-demo.opi.org.pl\/users-api\/swagger-ui.html\">https:\/\/polon2-demo.opi.org.pl\/users-api\/swagger-ui.html<\/a><\/li>\n\n\n\n<li>Pracownicy (Employees): <a href=\"https:\/\/polon2-demo.opi.org.pl\/employees-api\/swagger-ui.html\">https:\/\/polon2-demo.opi.org.pl\/employees-api\/swagger-ui.html<\/a><\/li>\n\n\n\n<li>S\u0142owniki dla us\u0142ugi Pracownicy: <a href=\"https:\/\/polon2-demo.opi.org.pl\/employees-api\/swagger-ui.html\">https:\/\/polon2-demo.opi.org.pl\/employees-api\/swagger-ui.html<\/a><\/li>\n\n\n\n<li>Kierunki studi\u00f3w (Fields of study): <a href=\"https:\/\/polon2-demo.opi.org.pl\/\/fields-of-study-api\/swagger-ui.html\">https:\/\/polon2-demo.opi.org.pl\/\/fields-of-study-api\/swagger-ui.html<\/a><\/li>\n\n\n\n<li>Instytucje (Institutions): <a href=\"https:\/\/polon2-demo.opi.org.pl\/institutions-api\/swagger-ui.html\">https:\/\/polon2-demo.opi.org.pl\/institutions-api\/swagger-ui.html<\/a><\/li>\n\n\n\n<li>Osoby ubiegaj\u0105ce si\u0119 o stopie\u0144 doktora (PHD Students):&nbsp;<a href=\"https:\/\/polon2-demo.opi.org.pl\/pdat-api\/swagger-ui.html\">https:\/\/polon2-demo.opi.org.pl\/pdat-api\/swagger-ui.html<\/a><\/li>\n\n\n\n<li>Szko\u0142y doktorskie (Doctoral Schools): <a href=\"https:\/\/polon2-demo.opi.org.pl\/doctoral-studies-api\/swagger-ui.html\">https:\/\/polon2-demo.opi.org.pl\/doctoral-studies-api\/swagger-ui.html<\/a><\/li>\n\n\n\n<li>ORPPD 2.0 (Theses repository v.2.0): <a href=\"https:\/\/polon2-demo.opi.org.pl\/rppd-api\/swagger-ui.html\">https:\/\/polon2-demo.opi.org.pl\/rppd-api\/swagger-ui.html<\/a><\/li>\n\n\n\n<li>Post\u0119powania awansowe (Promotions i Promotion): <a href=\"https:\/\/polon2-demo.opi.org.pl\/pdat-api\/swagger-ui.html\">https:\/\/polon2-demo.opi.org.pl\/pdat-api\/swagger-ui.html<\/a><\/li>\n\n\n\n<li>Patenty i prawa ochronne (Patents): <a href=\"https:\/\/polon2-demo.opi.org.pl\/patents-api\/swagger-ui.html\">https:\/\/polon2-demo.opi.org.pl\/patents-api\/swagger-ui.html<\/a><\/li>\n\n\n\n<li>Projekty naukowe (Projects):&nbsp;<a href=\"https:\/\/polon2-demo.opi.org.pl\/projects-api\/swagger-ui.html\">https:\/\/polon2-demo.opi.org.pl\/projects-api\/swagger-ui.html<\/a><\/li>\n\n\n\n<li>Dane finansowe jednostki (Financial data): <a href=\"https:\/\/polon2.opi.org.pl\/dfi-api\/swagger-ui.html\">https:\/\/polon2.opi.org.pl\/dfi-api\/swagger-ui.html<\/a><\/li>\n\n\n\n<li>Osi\u0105gni\u0119cia artystyczne (Artistic Achievement): <a href=\"https:\/\/polon2-demo.opi.org.pl\/arts-api\/swagger-ui.html\">https:\/\/polon2-demo.opi.org.pl\/arts-api\/swagger-ui.html<\/a><\/li>\n\n\n\n<li>Studenci (Students): <a href=\"https:\/\/polon2-demo.opi.org.pl\/fields-of-study-api\/swagger-ui.html\">https:\/\/polon2-demo.opi.org.pl\/fields-of-study-api\/swagger-ui.html<\/a><\/li>\n\n\n\n<li>Cudzoziemcy (Foreigners): <a href=\"https:\/\/polon2-demo.opi.org.pl\/foreigners-api\/swagger-ui\/index.html\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/polon2-demo.opi.org.pl\/foreigners-api\/swagger-ui\/index.html<\/a><\/li>\n<\/ol>\n\n\n\n<p class=\"has-black-color has-text-color has-background has-link-color wp-elements-b094069b76c0d4623b8a8f0c0b282509\" style=\"background-color:#dce8f6\">Powy\u017csze us\u0142ugi dost\u0119pne s\u0105 tak\u017ce <strong>dla \u015brodowiska produkcyjnego<\/strong>. Adres domeny \u015brodowiska to  <a href=\"https:\/\/polon2.opi.org.pl zamiast https:\/\/polon2-demo.opi.org.pl\">https:\/\/polon2.opi.org.pl<\/a> (zamiast <a href=\"https:\/\/polon2.opi.org.pl zamiast https:\/\/polon2-demo.opi.org.pl\">https:\/\/polon2-demo.opi.org.pl<\/a>). Ko\u0144c\u00f3wki s\u0105 takie same.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Scenariusze<\/strong><\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/polon.nauka.gov.pl\/pomoc\/knowledge-base\/pol-on-2-0-rest-api-scenariusze\/\" target=\"_blank\" rel=\"noreferrer noopener\">Scenariusze REST API dla wybranych modu\u0142\u00f3w POL-on 2.0<\/a><\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Przyk\u0142adowy kod programu oparty na REST API POL-on 2.0<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li> <a href=\"https:\/\/polon.nauka.gov.pl\/pomoc\/wp-content\/uploads\/2019\/11\/sample-oauth-polon2-client-v1.0.0.zip\" target=\"_blank\" rel=\"noreferrer noopener\">Kod programu do pobrania (.zip)<\/a> (pobranie tokena dost\u0119powego MCL oraz uwierzytelnienie wywo\u0142ania jednej z us\u0142ug z domeny pracownicy)<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Przyk\u0142adowe dzia\u0142anie REST API w ramach domeny pracownicy<\/strong><\/h3>\n\n\n\n<p>Poni\u017cej znajdziesz przyk\u0142ady uzyskane na \u015brodowisku testowym z wykorzystaniem oprogramowania POSTMAN.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/polon.nauka.gov.pl\/pomoc\/wp-content\/uploads\/2019\/11\/API-REST-v4.docx\" target=\"_blank\" rel=\"noreferrer noopener\">R\u00f3\u017cne konteksty u\u017cycia poszczeg\u00f3lnych us\u0142ug REST API domeny pracownicy (.docx)<\/a><\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>U\u017cycie opcji &#8222;Try it out&#8221; swaggera<\/strong><\/h3>\n\n\n\n<p><strong>Wywo\u0142anie REST z wykorzystaniem swagger-ui<\/strong> (przyk\u0142ad dla \u015brodowiska polon2-dev)<\/p>\n\n\n\n<figure class=\"wp-block-video\"><video controls src=\"https:\/\/polon.nauka.gov.pl\/pomoc\/wp-content\/uploads\/2019\/11\/Employment_find_withAuth-v3.mp4\"><\/video><\/figure>\n\n\n\n<p><\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Konfiguracja i u\u017cycie programu POSTMAN w kontek\u015bcie domeny pracownicy<\/strong><\/h3>\n\n\n\n<p><strong>Wywo\u0142anie REST z wykorzystaniem POSTMAN<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>ustawienie zmiennych \u015brodowiskowych<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-video\"><video controls src=\"https:\/\/polon.nauka.gov.pl\/pomoc\/wp-content\/uploads\/2019\/11\/ustawienie_zmiennych_srodowiskowych.mp4\"><\/video><\/figure>\n\n\n\n<p><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>przyk\u0142adowy REST<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-video\"><video controls src=\"https:\/\/polon.nauka.gov.pl\/pomoc\/wp-content\/uploads\/2019\/11\/nowy-request.mp4\"><\/video><\/figure>\n\n\n\n<p><\/p>\n\n\n\n<li>Pre-request script\n<div class=\"code panel\">\n<div class=\"codeContent panelContent\">\n<pre class=\"code-java\">pm.sendRequest({\nurl: pm.environment.get(<span class=\"code-quote\">\"MCL_URL\"<\/span>), \nmethod: <span class=\"code-quote\">'POST'<\/span>,\nheader: {\n<span class=\"code-quote\">'Accept'<\/span>: <span class=\"code-quote\">'application\/json'<\/span>,\n<span class=\"code-quote\">'Content-Type'<\/span>: <span class=\"code-quote\">'application\/x-www-form-urlencoded'<\/span>,\n},\nbody: {\nmode: <span class=\"code-quote\">'urlencoded'<\/span>,\nurlencoded: [\n{key: <span class=\"code-quote\">\"client_id\"<\/span>, value: pm.environment.get(<span class=\"code-quote\">\"MCL_CLIENT_ID\"<\/span>), disabled: <span class=\"code-keyword\">false<\/span>, description: {content:<span class=\"code-quote\">\"\", type:\"<\/span>text\/plain\"}},\n{key: <span class=\"code-quote\">\"grant_type\"<\/span>, value: <span class=\"code-quote\">\"password\"<\/span>, disabled: <span class=\"code-keyword\">false<\/span>},\n{key: <span class=\"code-quote\">\"username\"<\/span>, value: pm.environment.get(<span class=\"code-quote\">\"MCL_USER\"<\/span>), disabled: <span class=\"code-keyword\">false<\/span>},\n{key: <span class=\"code-quote\">\"password\"<\/span>, value: pm.environment.get(<span class=\"code-quote\">\"MCL_PASS\"<\/span>), disabled: <span class=\"code-keyword\">false<\/span>}\n\n]\n}\n}, function (err, res) {\npm.environment.set(<span class=\"code-quote\">\"TOKEN\"<\/span>, res.json().access_token);\npm.environment.set(<span class=\"code-quote\">\"REFRESH_TOKEN\"<\/span>, res.json().refresh_token);\n});<\/pre>\n<\/div>\n<\/div>\n<\/li>\n\n\n\n<p><strong>Pliki importowe dla POSTMAN<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>zmienne \u015brodowiskowe<br><a href=\"https:\/\/polon.nauka.gov.pl\/pomoc\/wp-content\/uploads\/2019\/11\/srodowisko_do_testow.postman_environment.zip\" target=\"_blank\" rel=\"noreferrer noopener\">\u015arodowisko do test\u00f3w postman environment (.zip)<\/a><\/li>\n\n\n\n<li>przyk\u0142adowy REST<br><a href=\"https:\/\/polon.nauka.gov.pl\/pomoc\/wp-content\/uploads\/2019\/11\/przykladowy_rest.postman_collection.zip\" target=\"_blank\" rel=\"noreferrer noopener\">Przykladowy REST postman collection (.zip)<\/a><\/li>\n<\/ul>\n\n\n\n<p><strong>Zaimportowanie plik\u00f3w<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>import zmiennych \u015brodowiskowych<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-video\"><video controls src=\"https:\/\/polon.nauka.gov.pl\/pomoc\/wp-content\/uploads\/2019\/11\/import_zmiennych_srodowiskowych.mp4\"><\/video><\/figure>\n\n\n\n<p><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>import przyk\u0142adowego REST<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-video\"><video controls src=\"https:\/\/polon.nauka.gov.pl\/pomoc\/wp-content\/uploads\/2019\/11\/import_przykladowego_rest.mp4\"><\/video><\/figure>\n","protected":false},"excerpt":{"rendered":"<p>W tym wpisie znajdziesz linki do specyfikacji us\u0142ug API REST. Dotychczasowe API systemu POL-on b\u0119dzie systematycznie wygaszane wraz migracj\u0105 poszczeg\u00f3lnych us\u0142ug do nowego systemu POL-on 2.0.Specyfikacj\u0119 API REST&nbsp;przedstawion\u0105 w trakcie konsultacji technicznych znajdziesz pod linkiem: POL-on &#8211; Specyfikacja API REST w systemie POL-on &#8211; wersja 1.0 \u015arodowisko produkcyjne https:\/\/polon2.opi.org.pl\/home\/login Us\u0142ugi edycji danych POL-on 2.0 obejmuj\u0105 [&hellip;]<\/p>\n","protected":false},"author":8,"comment_status":"closed","ping_status":"closed","template":"","format":"video","meta":{"footnotes":""},"class_list":["post-4402","lsvr_lore_kb","type-lsvr_lore_kb","status-publish","format-video","hentry","lsvr_lore_kb_cat-api-rest-masowe-interfejsy","lsvr_lore_kb_tag-import","lsvr_lore_kb_tag-api","post-item"],"categories":"REST API","tags":"import, REST API","date_content_updated":"","_links":{"self":[{"href":"https:\/\/polon.nauka.gov.pl\/pomoc\/wp-json\/wp\/v2\/lsvr_lore_kb\/4402","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/polon.nauka.gov.pl\/pomoc\/wp-json\/wp\/v2\/lsvr_lore_kb"}],"about":[{"href":"https:\/\/polon.nauka.gov.pl\/pomoc\/wp-json\/wp\/v2\/types\/lsvr_lore_kb"}],"author":[{"embeddable":true,"href":"https:\/\/polon.nauka.gov.pl\/pomoc\/wp-json\/wp\/v2\/users\/8"}],"replies":[{"embeddable":true,"href":"https:\/\/polon.nauka.gov.pl\/pomoc\/wp-json\/wp\/v2\/comments?post=4402"}],"version-history":[{"count":54,"href":"https:\/\/polon.nauka.gov.pl\/pomoc\/wp-json\/wp\/v2\/lsvr_lore_kb\/4402\/revisions"}],"predecessor-version":[{"id":22229,"href":"https:\/\/polon.nauka.gov.pl\/pomoc\/wp-json\/wp\/v2\/lsvr_lore_kb\/4402\/revisions\/22229"}],"wp:attachment":[{"href":"https:\/\/polon.nauka.gov.pl\/pomoc\/wp-json\/wp\/v2\/media?parent=4402"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}