{"id":2934,"date":"2019-09-28T17:56:22","date_gmt":"2019-09-28T17:56:22","guid":{"rendered":"http:\/\/newhelp.iwareprint.pl\/?post_type=helpdesk&#038;p=2934"},"modified":"2024-04-08T20:38:11","modified_gmt":"2024-04-08T20:38:11","slug":"iwareprint-api-instrukcja-dla-programistow","status":"publish","type":"pakiet_wdrozeniowy","link":"https:\/\/iwareprint.pl\/help\/pakiet-wdrozeniowy\/iwareprint-api-instrukcja-dla-programistow\/","title":{"rendered":"IwarePrint API \u2013 Instrukcja dla programist\u00f3w"},"content":{"rendered":"\r\n<p>\u2757\ufe0f<strong>Uwaga:<\/strong> Od wersji 10.3 wprowadzane s\u0105 nowe zabiezpieczenia bezpiecze\u0144stwa. Zapytania do API <strong>z poziomu przegl\u0105darki b\u0119d\u0105\u00a0blokowane<\/strong>, oraz klucz b\u0119dzie <strong>usuwany<\/strong>. Zapytania nale\u017cy wywo\u0142ywa\u0107 tylko\u00a0z poziomu serwera.<\/p>\r\n\r\n\r\n\r\n<p>&nbsp;<\/p>\r\n\r\n\r\n\r\n<p>&nbsp;<\/p>\r\n\r\n<p>IwarePrint API jest to API daj\u0105ce dost\u0119p i operacje na obiektach w drukarni internetowej takich jak m.in. zam\u00f3wienia, produkty, pliki klient\u00f3w i u\u017cytkownicy. <span style=\"color: #00ccff;\"><a style=\"color: #00ccff;\" href=\"https:\/\/iwareprint.pl\/blog\/ogolne\/pakiet-wdrozeniowy-w-iwareprint-3-0\/\"><strong>Do dzia\u0142ania API wymagane jest posiadanie aktywnego Pakietu Wdro\u017ceniowego.<\/strong><\/a><\/span> Po\u0142\u0105czenia do API odbywaj\u0105 si\u0119 poprzez protok\u00f3\u0142 HTTP\/HTTPS i dane s\u0105 przekazywane w formacie JSON.<\/p>\r\n<h2><strong>Przekazywanie danych<\/strong><\/h2>\r\n<p>Dane wej\u015bciowe do danej metody mog\u0105 by\u0107 przekazywane jako parametry REQUEST, lub jako obiekt JSON, przesy\u0142any pod parametrem REQUEST o nazwie <strong>json<\/strong>.<\/p>\r\n<p>Przyk\u0142adowe wywo\u0142anie:\u00a0<code>\/api\/nazwa\/metody\/?json={kod json}<\/code><\/p>\r\n<p>Druga opcja jest bardziej zalecana ze wzgl\u0119du na z\u0142o\u017cono\u015b\u0107 danych np. przy dodawaniu zam\u00f3wienia.<\/p>\r\n<h2><strong>Klucz dost\u0119pu<\/strong><\/h2>\r\n<p>Ka\u017cde odwo\u0142anie do API musi zawiera\u0107 jako jeden z parametr\u00f3w klucz dost\u0119pu, wygenerowany wcze\u015bniej w danej drukarni internetowej iwarePRINT w zak\u0142adce Ustawienia-&gt;API. Klucz zapewnia dost\u0119p do okre\u015blonych metod zaznaczonych przy jego generowaniu. Przyk\u0142adowe odwo\u0142anie z wykorzystaniem klucza:\u00a0\/api\/nazwa\/metody\/?key=&lt;klucz&gt;&amp;json={kod json}<\/p>\r\n<h2>Metody<\/h2>\r\n<p>Opis metod i poszczeg\u00f3lnych warto\u015bci wysy\u0142anych i zwracanych jest dost\u0119pny w ka\u017cdej drukarni pod \u015bcie\u017ck\u0105 Ustawienia-&gt;Api.<\/p>\r\n<p>Instrukcja ta przedstawia metody kt\u00f3re s\u0105 aktualnie zaimplementowane w danej\u00a0wersji drukarni.<\/p>\r\n<h2>Dane zwracane<\/h2>\r\n<p>Dane zwracane s\u0105 w formacie JSON. Przy tym ka\u017cda odpowied\u017a ma nast\u0119puj\u0105cy format:<\/p>\r\n<pre>{\r\n    status: \"ok\/error\",\r\n    result: {}\r\n}<\/pre>\r\n<p>status\u00a0\u2013 Zale\u017cnie od powodzenia operacji zwracany jest \u201cok\u201d w trakcie powodzenia, lub \u201cerror\u201d w przypadku b\u0142\u0119du.<\/p>\r\n<p>result\u00a0\u2013 W przypadku powodzenia operacji, tutaj zwracany jest obiekt w\u0142a\u015bciwy. W przypadku b\u0142\u0119du, zwracany jest komunikat tekstowy o danym b\u0142\u0119dzie.<\/p>\r\n<h2><strong>Przyk\u0142adowe wywo\u0142ania<\/strong><\/h2>\r\n<h3>Pobranie danych o u\u017cytkowniku na podstawie podanego id \u2013 w tym przypadku &#8222;1&#8221;:<\/h3>\r\n<ul>\r\n<li>metoda:\u00a0\/api\/user\/get\/{id}<\/li>\r\n<li>adres wywo\u0142ania:\u00a0<a class=\"broken_link\" href=\"http:\/\/twoja-drukarnia.iwareprint.pl\/api\/user\/get\/1\" rel=\"nofollow\">http:\/\/twoja-drukarnia.iwareprint.pl\/api\/user\/get\/1<\/a><\/li>\r\n<li>parametry:\u00a0?key=dcc85e54d4a43a37139bfe3<\/li>\r\n<li>przyk\u0142adowa odpowied\u017a:\r\n<pre>{\"status\":\"ok\",\"result\":{\"id\":\"1\",\"invoiceData\":{\"company\":\"Agencja testowa\",\"name\":null,\"surname\":null,\"addressLine\":\"Kr\\u00f3tka 12\\\/4\",\"city\":\"Warszawa\",\"postalCode\":\"00-952\",\"phone\":null},\"shipmentData\":{\"company\":\"Agencja testowa\",\"name\":null,\"surname\":null,\"addressLine\":\"D\\u0142uga 12\\\/4\",\"city\":\"Wroc\\u0142aw\",\"postalCode\":\"54-952\",\"phone\":null},\"email\":\"firma.iware@wp.pl\",\"verified\":\"1\",\"registrationDate\":\"2014-01-31 14:07:27\",\"points\":\"330\",\"printingHouseId\":null}}<\/pre>\r\n<\/li>\r\n<\/ul>\r\n<h3>Pobranie dw\u00f3ch ostatnio zarejestrowanych u\u017cytkownik\u00f3w:<\/h3>\r\n<ul>\r\n<li>metoda:\u00a0<code>\/api\/user\/find\/<\/code><\/li>\r\n<li>adres wywo\u0142ania:\u00a0<code>http:\/\/twoja-drukarnia.iwareprint.pl\/api\/user\/find\/<\/code><\/li>\r\n<li>parametry:\u00a0<code>?key=dcc85e54d4a43a37139bfe3&amp;json={\"orderBy\":\"id\", \"orderByType\":\"desc\u201d,\"limit\":1}<\/code><\/li>\r\n<li>przyk\u0142adowa odpowied\u017a:\r\n<pre>{\"status\":\"ok\",\"result\":[{\"id\":\"1\",\"invoiceData\":{\"company\":\"Agencja testowa\",\"firstName\":null,\"lastName\":null,\"street\":\"Kr\\u00f3tka\",\"buildingNumber\":\"12\",\"apartmentNumber\":\"4\",\"postal\":\"00-952\",\"city\":\"Warszawa\",\"phone\":\"22 1237654\"},\"shipmentData\":{\"company\":\"Agencja testowa\",\"firstName\":null,\"lastName\":null,\"street\":\"D\\u0142uga\",\"buildingNumber\":\"12\",\"apartmentNumber\":\"4\",\"postal\":\"54-952\",\"city\":\"Wroc\\u0142aw\",\"phone\":\"22 1237654\"},\"email\":\"firma.iware@wp.pl\",\"verified\":\"1\",\"registrationDate\":\"2014-01-31 14:07:27\",\"points\":\"330\",\"printingHouseId\":null},{\"id\":\"2\",\"invoiceData\":{\"company\":\"Mira\\u017c\",\"firstName\":\"\",\"lastName\":\"\",\"street\":\"Marsza\\u0142kowska\",\"buildingNumber\":\"2\",\"apartmentNumber\":\"\",\"postal\":\"00950\",\"city\":\"Warszawa\",\"phone\":\"22 65454321\"},\"shipmentData\":{\"company\":\"Mira\\u017c\",\"firstName\":null,\"lastName\":null,\"street\":\"Marsza\\u0142kowska\",\"buildingNumber\":\"2\",\"apartmentNumber\":null,\"postal\":\"00950\",\"city\":\"Warszawa\",\"phone\":\"22 65454321\"},\"email\":\"test_8@wp.pl\",\"verified\":\"1\",\"registrationDate\":\"2014-01-31 14:08:38\",\"points\":\"30\",\"printingHouseId\":null}]}<\/pre>\r\n<\/li>\r\n<\/ul>","protected":false},"parent":0,"menu_order":10,"template":"single-helpdesk.php","kategorie":[108],"class_list":["post-2934","pakiet_wdrozeniowy","type-pakiet_wdrozeniowy","status-publish","hentry","kategorie-pakiet-wdrozeniowy"],"acf":[],"_links":{"self":[{"href":"https:\/\/iwareprint.pl\/help\/wp-json\/wp\/v2\/pakiet_wdrozeniowy\/2934","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/iwareprint.pl\/help\/wp-json\/wp\/v2\/pakiet_wdrozeniowy"}],"about":[{"href":"https:\/\/iwareprint.pl\/help\/wp-json\/wp\/v2\/types\/pakiet_wdrozeniowy"}],"wp:attachment":[{"href":"https:\/\/iwareprint.pl\/help\/wp-json\/wp\/v2\/media?parent=2934"}],"wp:term":[{"taxonomy":"kategorie","embeddable":true,"href":"https:\/\/iwareprint.pl\/help\/wp-json\/wp\/v2\/kategorie?post=2934"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}