{"id":10391,"date":"2024-02-06T14:41:43","date_gmt":"2024-02-06T13:41:43","guid":{"rendered":"https:\/\/help.expertsender.com\/?post_type=ecdp&#038;p=10391"},"modified":"2025-09-18T12:41:29","modified_gmt":"2025-09-18T11:41:29","slug":"jak-korzystac-z-ecdp-api","status":"publish","type":"ecdp","link":"https:\/\/help.expertsender.com\/pl\/ecdp\/jak-korzystac-z-ecdp-api\/","title":{"rendered":"Jak korzysta\u0107 z ECDP API"},"content":{"rendered":"\n<p>Zanim zaczniesz korzysta\u0107 z API ECDP, zapoznaj si\u0119 z podstawowymi wymaganiami dotycz\u0105cymi adres\u00f3w, uwierzytelniania, nag\u0142\u00f3wk\u00f3w oraz formatu \u017c\u0105da\u0144 i odpowiedzi. Poni\u017csze informacje obowi\u0105zuj\u0105 we wszystkich metodach API i s punktem wyj\u015bcia do tworzenia poprawnych zapyta\u0144.<\/p>\n\n\n\n<div style=\"height:var(--wp--preset--spacing--20)\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"zdarzenia-obslugiwane-przez-api\"><strong>Jaki zdarzenia obs\u0142u\u017cysz przez ExpertSender API?<\/strong><\/h2>\n\n\n\n<p>Z pomoc\u0105 ExpertSender API zautomatyzujesz:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Dodawanie nowych <strong>klient\u00f3w<\/strong> do Twojej bazy w platformie,<\/li>\n\n\n\n<li>Zmian\u0119 danych klient\u00f3w znajduj\u0105cych si\u0119 w Twojej bazie,<\/li>\n\n\n\n<li>Rejestracj\u0119 <strong>zam\u00f3wie\u0144<\/strong> klient\u00f3w i zmian\u0119 status\u00f3w tych zam\u00f3wie\u0144,<\/li>\n\n\n\n<li>Dodawanie <strong>zdarze\u0144 niestandardowych w scenariuszach<\/strong>.<\/li>\n\n\n\n<li>Eksport danych klient\u00f3w z wybranych segment\u00f3w.<\/li>\n<\/ul>\n\n\n\n<div style=\"height:var(--wp--preset--spacing--20)\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"jak-korzystac-z-api\">Jak korzysta\u0107 z ECDP API?<\/h2>\n\n\n\n<p>Do korzystania z API potrzebujesz aplikacji (klienta), z kt\u00f3rej mo\u017cesz wysy\u0142a\u0107 zapytania. Najlepiej wybra\u0107 t\u0119, z kt\u00f3rej ju\u017c korzystasz.<\/p>\n\n\n\n<p>Dodaj do niej klucz API swojej jednostki biznesowej i wy\u015blij \u017c\u0105danie (API request) o potrzebne dane. Ka\u017cde \u017c\u0105danie musi zawiera\u0107 Tw\u00f3j klucz API.<\/p>\n\n\n\n<p>\u017b\u0105danie jest cz\u0119\u015bci\u0105 wywo\u0142ania API (API call), kt\u00f3re obejmuje tak\u017ce przetworzenie go przez serwer oraz zwr\u00f3cenie wynik\u00f3w w postaci danych.<\/p>\n\n\n\n<div style=\"height:50px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<div style=\"height:var(--wp--preset--spacing--20)\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"adres-bazowy\"><strong>Adres bazowy<\/strong><\/h2>\n\n\n\n<p>Wszystkie endpointy korzystaj\u0105 z adresu bazowego:<\/p>\n\n\n\n<p><strong>https:\/\/api.ecdp.app\/{resource}<\/strong><\/p>\n\n\n\n<p>Tutaj <code>{resource}<\/code> to nazwa sekcji API, na przyk\u0142ad: <code>orders<\/code>, <code>customers<\/code> lub <code>scenariocustomevents<\/code>.<\/p>\n\n\n\n<div style=\"height:var(--wp--preset--spacing--20)\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<div style=\"height:50px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"klucz-api\"><strong>Klucz API \u2013 uwierzytelnianie<\/strong><\/h2>\n\n\n\n<p>Ka\u017cda <strong>jednostka biznesowa<\/strong> ma w\u0142asny klucz API. Sw\u00f3j klucz znajdziesz w aplikacji ExpertSender w sekcji: <strong><a href=\"https:\/\/help.expertsender.com\/pl\/ecdp\/ustawienia-klucz-api\/\">Ustawienia > API<\/a><\/strong>.<\/p>\n\n\n\n<div class=\"infobox infobox-yellow\">\n  <div class=\"infobox-inner\">\n    <div class=\"infobox-icon\">\n      <svg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\"><path fill-rule=\"evenodd\" clip-rule=\"evenodd\" d=\"M12 8.62988C12.4142 8.62988 12.75 8.96567 12.75 9.37988V13.1199C12.75 13.5341 12.4142 13.8699 12 13.8699C11.5858 13.8699 11.25 13.5341 11.25 13.1199V9.37988C11.25 8.96567 11.5858 8.62988 12 8.62988Z\" fill=\"currentColor\"\/><path fill-rule=\"evenodd\" clip-rule=\"evenodd\" d=\"M11.9939 15.375C11.9956 15.375 11.9973 15.375 11.999 15.375C12.0238 15.375 12.0483 15.3762 12.0725 15.3786C12.5566 15.4197 12.999 15.8152 12.999 16.375C12.999 16.6701 12.8662 16.9159 12.7031 17.0791C12.5399 17.2422 12.2941 17.375 11.999 17.375C11.4255 17.375 10.999 16.8997 10.999 16.375C10.999 15.845 11.4067 15.4141 11.9271 15.3775C11.9475 15.3759 11.9681 15.375 11.989 15.375C11.9906 15.375 11.9923 15.375 11.9939 15.375Z\" fill=\"currentColor\"\/><path fill-rule=\"evenodd\" clip-rule=\"evenodd\" d=\"M13.3559 4.5009C12.7442 3.42451 11.2053 3.42989 10.6034 4.4984L10.6015 4.50185L2.95204 17.9156C2.34706 18.9735 3.11079 20.2903 4.32998 20.2903H19.65C20.8644 20.2903 21.6305 18.965 21.0286 17.9168L21.0276 17.9151L13.4395 4.61952C13.4081 4.58298 13.38 4.54329 13.3559 4.5009ZM14.5885 3.63986C13.3595 1.67728 10.4533 1.71162 9.29754 3.76042C9.2972 3.76102 9.29686 3.76162 9.29652 3.76222L1.64993 17.171C1.64984 17.1711 1.64976 17.1713 1.64967 17.1714C0.473119 19.2295 1.95934 21.7903 4.32998 21.7903H19.65C22.0132 21.7903 23.5071 19.2223 22.3299 17.1707C22.3297 17.1704 22.3296 17.1701 22.3294 17.1699L14.6804 3.76755C14.6541 3.72162 14.6233 3.67887 14.5885 3.63986Z\" fill=\"currentColor\"\/><\/svg>    <\/div>\n    <div class=\"infobox-content\">\n                    <div class=\"infobox-text\">\n          <p>Je\u015bli zarz\u0105dzasz kilkoma jednostkami biznesowymi, ka\u017cda z nich ma przypisany unikalny klucz API.<\/p>\n        <\/div>\n          <\/div>\n  <\/div>\n<\/div>\n\n\n\n<div style=\"height:var(--wp--preset--spacing--20)\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"format-zadan-i-odpowiedzi\">Format \u017c\u0105da\u0144 i odpowiedzi <\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Wszystkie tre\u015bci \u017c\u0105da\u0144 musz\u0105 by\u0107 zapisane w formacie <strong>JSON<\/strong>.<\/li>\n\n\n\n<li>Wszystkie odpowiedzi s\u0105 zwracane w formacie <strong>JSON<\/strong>.<\/li>\n<\/ul>\n\n\n\n<p>Ka\u017cde \u017c\u0105danie musi zawiera\u0107 poni\u017cszy nag\u0142\u00f3wek:<\/p>\n\n\n\n<p><strong>x-api-key: {your-api-key}<\/strong><\/p>\n\n\n\n<div style=\"height:var(--wp--preset--spacing--20)\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"jak-korzystac-z-api\">Nag\u0142\u00f3wki (headers)<\/h2>\n\n\n\n<p>Ka\u017cde \u017c\u0105danie musi zawiera\u0107:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>x-api-key: {your-api-key}<\/li>\n\n\n\n<li>Content-Type: application\/json<\/li>\n<\/ul>\n\n\n\n<div style=\"height:var(--wp--preset--spacing--20)\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<div style=\"height:30px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<ol style=\"list-style-type:1\" class=\"wp-block-list\"><\/ol>\n\n\n\n<div style=\"height:var(--wp--preset--spacing--20)\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"api-wszystkie-kody-odpowiedzi\"><strong>Kody odpowiedzi <\/strong><\/h2>\n\n\n\n<p>Wysy\u0142aj\u0105c zapytanie API dowoln\u0105 metod\u0105 otrzymasz odpowied\u017a serwera wraz z numerem kodu. Najcz\u0119\u015bciej spotykane odpowiedzi na zapytanie API to:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td> <strong>Kod<\/strong><\/td><td><strong>Wiadomo\u015b\u0107<\/strong><\/td><td><strong>Opis<\/strong><\/td><\/tr><tr><td>200<\/td><td>Success<\/td><td>zapytanie zosta\u0142o przetworzone, serwer zwr\u00f3ci\u0142 odpowied\u017a<\/td><\/tr><tr><td>201<\/td><td>Created<\/td><td>\u017c\u0105danie zosta\u0142o utworzone<\/td><\/tr><tr><td>400<\/td><td>Bad request<\/td><td>\u017c\u0105danie nie zosta\u0142o przetworzone. Powodem jest zwykle brakuj\u0105cy lub nieprawid\u0142owy parametr, jak <em>email<\/em>, <em>phone<\/em> itp.<\/td><\/tr><tr><td>401<\/td><td>Unauthorized<\/td><td>w \u017c\u0105daniu brakowa\u0142o klucza API lub prosisz o dost\u0119p do informacji, do kt\u00f3rych nie masz uprawnie\u0144<\/td><\/tr><tr><td>403<\/td><td>Forbidden<\/td><td>zapytanie jest poprawne, ale pytasz o dane, do kt\u00f3rych nie masz uprawnie\u0144<\/td><\/tr><tr><td>404<\/td><td>Not found<\/td><td>na serwerze nie ma danych, kt\u00f3rych szukasz<\/td><\/tr><tr><td>500<\/td><td>Internal server error<\/td><td>nieoczekiwany b\u0142\u0105d serwera. Nic nie musisz robi\u0107, zajmiemy si\u0119 tym<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>Kody odpowiedzi mog\u0105 by\u0107 r\u00f3\u017cne dla poszczeg\u00f3lnych metod, dlatego pod ka\u017cd\u0105 z nich umieszczamy zestaw kod\u00f3w dla niej w\u0142a\u015bciwy.<\/p>\n\n\n\n<div style=\"height:var(--wp--preset--spacing--20)\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"logi-api\"><strong>Logi API<\/strong><\/h2>\n\n\n\n<p>Wszystkie zarejestrowane zapytania <a href=\"https:\/\/help.expertsender.com\/pl\/ecdp\/api-zacznij-tutaj\/\"><strong>API<\/strong><\/a> zwi\u0105zane z jednostk\u0105 biznesow\u0105, kt\u00f3r\u0105 zarz\u0105dzasz znajdziesz w <strong>Ustawienia <\/strong>&gt; <strong>Logi<\/strong> &gt;<strong> Logi API<\/strong>.<\/p>\n\n\n\n<div class=\"infobox infobox-yellow\">\n  <div class=\"infobox-inner\">\n    <div class=\"infobox-icon\">\n      <svg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\"><path fill-rule=\"evenodd\" clip-rule=\"evenodd\" d=\"M12 8.62988C12.4142 8.62988 12.75 8.96567 12.75 9.37988V13.1199C12.75 13.5341 12.4142 13.8699 12 13.8699C11.5858 13.8699 11.25 13.5341 11.25 13.1199V9.37988C11.25 8.96567 11.5858 8.62988 12 8.62988Z\" fill=\"currentColor\"\/><path fill-rule=\"evenodd\" clip-rule=\"evenodd\" d=\"M11.9939 15.375C11.9956 15.375 11.9973 15.375 11.999 15.375C12.0238 15.375 12.0483 15.3762 12.0725 15.3786C12.5566 15.4197 12.999 15.8152 12.999 16.375C12.999 16.6701 12.8662 16.9159 12.7031 17.0791C12.5399 17.2422 12.2941 17.375 11.999 17.375C11.4255 17.375 10.999 16.8997 10.999 16.375C10.999 15.845 11.4067 15.4141 11.9271 15.3775C11.9475 15.3759 11.9681 15.375 11.989 15.375C11.9906 15.375 11.9923 15.375 11.9939 15.375Z\" fill=\"currentColor\"\/><path fill-rule=\"evenodd\" clip-rule=\"evenodd\" d=\"M13.3559 4.5009C12.7442 3.42451 11.2053 3.42989 10.6034 4.4984L10.6015 4.50185L2.95204 17.9156C2.34706 18.9735 3.11079 20.2903 4.32998 20.2903H19.65C20.8644 20.2903 21.6305 18.965 21.0286 17.9168L21.0276 17.9151L13.4395 4.61952C13.4081 4.58298 13.38 4.54329 13.3559 4.5009ZM14.5885 3.63986C13.3595 1.67728 10.4533 1.71162 9.29754 3.76042C9.2972 3.76102 9.29686 3.76162 9.29652 3.76222L1.64993 17.171C1.64984 17.1711 1.64976 17.1713 1.64967 17.1714C0.473119 19.2295 1.95934 21.7903 4.32998 21.7903H19.65C22.0132 21.7903 23.5071 19.2223 22.3299 17.1707C22.3297 17.1704 22.3296 17.1701 22.3294 17.1699L14.6804 3.76755C14.6541 3.72162 14.6233 3.67887 14.5885 3.63986Z\" fill=\"currentColor\"\/><\/svg>    <\/div>\n    <div class=\"infobox-content\">\n                    <div class=\"infobox-text\">\n          <p>Logi API przechowywane s\u0105 w systemie przez 1 miesi\u0105c.<\/p>\n        <\/div>\n          <\/div>\n  <\/div>\n<\/div>\n\n\n\n<p><\/p>\n","protected":false},"author":6,"featured_media":0,"parent":0,"menu_order":0,"template":"","ecdp-category":[109,117,101],"class_list":["post-10391","ecdp","type-ecdp","status-publish","hentry","ecdp-category-api","ecdp-category-settings","ecdp-category-ustawienia"],"acf":[],"_links":{"self":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/ecdp\/10391","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/ecdp"}],"about":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/types\/ecdp"}],"author":[{"embeddable":true,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/users\/6"}],"version-history":[{"count":7,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/ecdp\/10391\/revisions"}],"predecessor-version":[{"id":15524,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/ecdp\/10391\/revisions\/15524"}],"wp:attachment":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/media?parent=10391"}],"wp:term":[{"taxonomy":"ecdp-category","embeddable":true,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/ecdp-category?post=10391"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}