{"id":17459,"date":"2026-07-08T09:06:31","date_gmt":"2026-07-08T08:06:31","guid":{"rendered":"https:\/\/help.expertsender.com\/?post_type=ecdp&p=17459"},"modified":"2026-07-08T15:38:14","modified_gmt":"2026-07-08T14:38:14","slug":"urzadzenia-mobilne-rejestracja-i-wyrejestrowanie","status":"publish","type":"ecdp","link":"https:\/\/help.expertsender.com\/pl\/ecdp\/urzadzenia-mobilne-rejestracja-i-wyrejestrowanie\/","title":{"rendered":"Urz\u0105dzenia mobilne \u2013 rejestracja i wyrejestrowanie"},"content":{"rendered":"\n

U\u017cyj metod POST i DELETE, aby po\u0142\u0105czy\u0107 telefon lub tablet klienta z Twoj\u0105 aplikacj\u0105 mobiln\u0105. Dzi\u0119ki temu mo\u017cesz wysy\u0142a\u0107 powiadomienia push i mie\u0107 kontrol\u0119 nad zgodami zwi\u0105zanymi z aplikacj\u0105.<\/p>\n\n\n\n

<\/div>\n\n\n\n

POST \/customermobiledevices \u2013 rejestracja lub aktualizacja urz\u0105dzenia<\/h2>\n\n\n\n

Metoda POST rejestruje urz\u0105dzenie, kt\u00f3re zainstalowa\u0142o aplikacj\u0119 mobiln\u0105 lub aktualizuje jego dane, je\u015bli urz\u0105dzenie jest ju\u017c powi\u0105zane z aplikacj\u0105. Dodatkowo \u0142\u0105czy urz\u0105dzenie z profilem klienta i dodaje zgod\u0119 powi\u0105zan\u0105 z dan\u0105 aplikacj\u0105, je\u015bli klient jeszcze jej nie ma.<\/p>\n\n\n\n

<\/div>\n\n\n\n

Endpoint<\/h3>\n\n\n\n

POST \/customermobiledevices<\/p>\n\n\n\n

Host:<\/strong> https:\/\/api.ecdp.app<\/p>\n\n\n\n

<\/div>\n\n\n\n

Parametry zapytania<\/h3>\n\n\n\n
Parametr<\/strong><\/td>Lokalizacja<\/strong><\/td>Typ<\/strong><\/td>Wymagane<\/strong><\/td>Opis<\/strong><\/td>Dozwolone warto\u015bci \/ uwagi<\/strong><\/td><\/tr><\/thead>
x-api-key<\/td>header<\/td>string<\/td>tak<\/td>Klucz API do uwierzytelniania.<\/td>Dost\u0119pny w Ustawienia > API.<\/td><\/tr>
Content-Type<\/td>header<\/td>string<\/td>tak<\/td>Typ zawarto\u015bci zapytnia.<\/td>application\/json<\/td><\/tr>
mobileApplicationId<\/td>body<\/td>integer<\/td>tak<\/td>Aplikacja mobilna, do kt\u00f3rej ma by\u0107 przypisane urz\u0105dzenie.<\/td>ID Twojej aplikacji dost\u0119pne w Ustawienia > Aplikacje mobilne.<\/td><\/tr>
device<\/td>body<\/td>object<\/td>tak<\/td>Dane urz\u0105dzenia.<\/td>Zobacz Dane urz\u0105dzenia<\/strong> poni\u017cej.<\/td><\/tr>
customer<\/td>body<\/td>object<\/td>nie<\/td>Identyfikacja klienta.<\/td>Zobacz Dane klienta<\/strong> poni\u017cej.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n

Dane urz\u0105dzenia<\/h4>\n\n\n\n
Parametr<\/strong><\/td>Lokalizacja<\/strong><\/td>Typ<\/strong><\/td>Wymagane<\/strong><\/td>Opis<\/strong><\/td>Dozwolone warto\u015bci \/ uwagi<\/strong><\/td><\/tr><\/thead>
deviceId<\/td>body<\/td>string<\/td>tak<\/td>Unikalny identyfikator urz\u0105dzenia lub instalacji aplikacji.<\/td>Maks. 50 znak\u00f3w.<\/td><\/tr>
token<\/td>body<\/td>string<\/td>tak<\/td>Token push wydany przez Firebase Cloud Messaging (FCM).<\/td>Maks. 200 znak\u00f3w.<\/td><\/tr>
osType<\/td>body<\/td>string<\/td>nie<\/td>System operacyjny urz\u0105dzenia.<\/td>Android, Ios, WindowsPhone, Unknown.<\/td><\/tr>
osVersion<\/td>body<\/td>string<\/td>nie<\/td>Wersja systemu operacyjnego.<\/td>Maks. 50 znak\u00f3w.<\/td><\/tr>
deviceBrand<\/td>body<\/td>string<\/td>nie<\/td>Producent urz\u0105dzenia.<\/td>Maks. 50 znak\u00f3w.<\/td><\/tr>
deviceModel<\/td>body<\/td>string<\/td>nie<\/td>Model urz\u0105dzenia.<\/td>Maks. 50 znak\u00f3w.<\/td><\/tr>
appVersion<\/td>body<\/td>string<\/td>nie<\/td>Wersja Twojej aplikacji mobilnej zainstalowanej na urz\u0105dzeniu.<\/td>Maks. 50 znak\u00f3w.<\/td><\/tr>
language<\/td>body<\/td>string<\/td>nie<\/td>J\u0119zyk urz\u0105dzenia lub aplikacji.<\/td>Maks. 10 znak\u00f3w.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n

Dane klienta<\/h4>\n\n\n\n

U\u017cyj tych p\u00f3l, aby po\u0142\u0105czy\u0107 urz\u0105dzenie z profilem istniej\u0105cego klientem. Podaj co najmniej jeden z parametr\u00f3w: email, phone lub crmId, aby zidentyfikowa\u0107 klienta. Je\u015bli je pominiesz, urz\u0105dzenie zostanie zarejestrowane samodzielnie, bez powi\u0105zania z klientem.<\/p>\n\n\n\n

Parametr<\/strong><\/td>Lokalizacja<\/strong><\/td>Typ<\/strong><\/td>Wymagane<\/strong><\/td>Opis<\/strong><\/td>Dozwolone warto\u015bci \/ uwagi<\/strong><\/td><\/tr><\/thead>
email<\/td>body<\/td>string<\/td>warunkowo<\/td>Adres e-mail klienta.<\/td>Maks. 320 znak\u00f3w.<\/td><\/tr>
phone<\/td>body<\/td>string<\/td>warunkowo<\/td>Numer telefonu klienta.<\/td>Maks. 20 znak\u00f3w, bez spacji.<\/td><\/tr>
crmId<\/td>body<\/td>string<\/td>warunkowo<\/td>Identyfikator CRM klienta.<\/td>Maks. 1280 znak\u00f3w.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Jeden klient mo\u017ce mie\u0107 zarejestrowanych kilka urz\u0105dze\u0144 jednocze\u015bnie, na przyk\u0142ad telefon i tablet \u2013 ka\u017cde z w\u0142asn\u0105 subskrypcj\u0105.<\/p>\n\n\n\n

<\/div>\n\n\n\n

Przyk\u0142adowe zapytanie<\/h3>\n\n\n\n

Zarejestruj urz\u0105dzenie i po\u0142\u0105cz je z klientem<\/strong><\/p>\n\n\n\n

Wymagany format: JSON<\/p>\n\n\n\n

<\/path><\/path><\/svg><\/span>
{<\/span><\/span>\n  <\/span>"<\/span>mobileApplicationId<\/span>"<\/span>: <\/span>1<\/span>,<\/span><\/span>\n  <\/span>"<\/span>device<\/span>"<\/span>: <\/span>{<\/span><\/span>\n    <\/span>"<\/span>deviceId<\/span>"<\/span>:<\/span> <\/span>"<\/span>device123...<\/span>"<\/span>,<\/span><\/span>\n    <\/span>"<\/span>token<\/span>"<\/span>:<\/span> <\/span>"<\/span>fcm_token...<\/span>"<\/span>,<\/span><\/span>\n    <\/span>"<\/span>osType<\/span>"<\/span>:<\/span> <\/span>"<\/span>Android<\/span>"<\/span>,<\/span><\/span>\n    <\/span>"<\/span>osVersion<\/span>"<\/span>:<\/span> <\/span>"<\/span>14<\/span>"<\/span>,<\/span><\/span>\n    <\/span>"<\/span>deviceBrand<\/span>"<\/span>:<\/span> <\/span>"<\/span>Samsung<\/span>"<\/span>,<\/span><\/span>\n    <\/span>"<\/span>deviceModel<\/span>"<\/span>:<\/span> <\/span>"<\/span>Galaxy S23<\/span>"<\/span>,<\/span><\/span>\n    <\/span>"<\/span>appVersion<\/span>"<\/span>:<\/span> <\/span>"<\/span>2.4.1<\/span>"<\/span>,<\/span><\/span>\n    <\/span>"<\/span>language<\/span>"<\/span>:<\/span> <\/span>"<\/span>en<\/span>"<\/span><\/span>\n  <\/span>},<\/span><\/span>\n  <\/span>"<\/span>customer<\/span>"<\/span>: <\/span>{<\/span><\/span>\n    <\/span>"<\/span>email<\/span>"<\/span>:<\/span> <\/span>"<\/span>anna.kowalska@domena.pl<\/span>"<\/span>,<\/span><\/span>\n    <\/span>"<\/span>phone<\/span>"<\/span>:<\/span> <\/span>"<\/span>48987654321<\/span>"<\/span>,<\/span><\/span>\n    <\/span>"<\/span>crmId<\/span>"<\/span>:<\/span> <\/span>"<\/span>CRM-005678<\/span>"<\/span><\/span>\n  <\/span>}<\/span><\/span>\n}<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
<\/div>\n\n\n\n
Kody odpowiedzi<\/h3>\n\n\n\n
Kod<\/strong><\/td>Status<\/strong><\/td>Opis<\/strong><\/td><\/tr><\/thead>
201<\/td>Created<\/td>Rejestracja zosta\u0142a przyj\u0119ta i skierowana do przetwarzania.<\/td><\/tr>
400<\/td>Bad request<\/td>Nieprawid\u0142owe parametry lub brak wymaganych p\u00f3l.<\/td><\/tr>
401<\/td>Unauthorized<\/td>Brak klucza API lub nieprawid\u0142owy klucz API.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
DELETE \/customermobiledevices \u2013 dezaktywacja rejestracji urz\u0105dzenia<\/h2>\n\n\n\n
U\u017cyj tej metody, gdy klient rezygnuje z powiadomie\u0144 push lub odinstalowuje aplikacj\u0119. Metoda oznacza pasuj\u0105ce urz\u0105dzenie jako nieaktywne. Je\u015bli by\u0142o to ostatnie aktywne urz\u0105dzenie klienta dla danej aplikacji, powi\u0105zana zgoda zostaje automatycznie cofni\u0119ta \u2013 nie musisz zarz\u0105dza\u0107 tym osobno.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Endpoint<\/h3>\n\n\n\n
DELETE \/customermobiledevices<\/p>\n\n\n\n
Host:<\/strong> https:\/\/api.ecdp.app<\/p>\n\n\n\n
<\/div>\n\n\n\n
Parametry zapytania<\/h3>\n\n\n\n
Parametr<\/strong><\/td>Lokalizacja<\/strong><\/td>Typ<\/strong><\/td>Wymagane<\/strong><\/td>Opis<\/strong><\/td>Dozwolone warto\u015bci \/ uwagi<\/strong><\/td><\/tr><\/thead>
x-api-key<\/td>header<\/td>string<\/td>tak<\/td>Klucz API do uwierzytelniania.<\/td>Dost\u0119pny w Ustawienia > API.<\/td><\/tr>
mobileApplicationId<\/td>body<\/td>integer<\/td>tak<\/td>Aplikacja mobilna, do kt\u00f3rej przypisane jest urz\u0105dzenie.<\/td>Ta sama warto\u015b\u0107 u\u017cyta podczas rejestracji urz\u0105dzenia.<\/td><\/tr>
deviceId<\/td>body<\/td>string<\/td>tak<\/td>Urz\u0105dzenie do dezaktywacji.<\/td>Ta sama warto\u015b\u0107 u\u017cyta podczas rejestracji urz\u0105dzenia.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
Przyk\u0142adowe zapytanie<\/h3>\n\n\n\n
Dezaktywuj urz\u0105dzenie<\/strong><\/p>\n\n\n\n
Format \u017c\u0105dania: JSON<\/p>\n\n\n\n
<\/path><\/path><\/svg><\/span>
{<\/span><\/span>\n  <\/span>"<\/span>mobileApplicationId<\/span>"<\/span>: <\/span>1<\/span>,<\/span><\/span>\n  <\/span>"<\/span>deviceId<\/span>"<\/span>: <\/span>"<\/span>device123...<\/span>"<\/span><\/span>\n}<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
<\/div>\n\n\n\n
Kody odpowiedzi<\/h3>\n\n\n\n
Kod<\/strong><\/td>Status<\/strong><\/td>Opis<\/strong><\/td><\/tr><\/thead>
200<\/td>OK<\/td>Rejestracja urz\u0105dzenia zosta\u0142a pomy\u015blnie dezaktywowana<\/td><\/tr>
401<\/td>Unauthorized<\/td>Brak klucza API lub nieprawid\u0142owy klucz API<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
Walidacja i zasady i dzia\u0142ania<\/h2>\n\n\n\n