\u017b\u0105dana zawarto\u015b\u0107 jest dostarczana w formacie JSON<\/strong> z kodowaniem UTF-8. W przypadku zastosowania innego formatu, jest to okre\u015blone w opisie metody.<\/p>\n Kod statusu HTTP to identyfikator statusu \u017c\u0105dania \u2013 w przypadku akceptacji \u017c\u0105dania zwracany kod to 200<\/strong>. Wraz z t\u0105 odpowiedzi\u0105 otrzymywane s\u0105 \u017c\u0105dane informacje z serwera. Takie odpowiedzi b\u0119d\u0105 si\u0119 r\u00f3\u017cni\u0107, w zale\u017cno\u015bci od typu wykorzystywanego interfejsu API. Odpowiedzi interfejsu API dla r\u00f3\u017cnych typ\u00f3w API opisano w odpowiednich rozdzia\u0142ach.<\/p>\n W przypadku wyst\u0105pienia b\u0142\u0119du wys\u0142anego \u017c\u0105dania, system odpowie komunikatem zwrotnym zawieraj\u0105cym kod statusu.\u00a0 Typowe kody b\u0142\u0119d\u00f3w:<\/p>\n Kody b\u0142\u0119d\u00f3w dostarczaj\u0105 og\u00f3lnych informacji o rodzaju b\u0142\u0119du, umo\u017cliwiaj\u0105c u\u017cytkownikowi identyfikacj\u0119 \u017ar\u00f3d\u0142a problemu.<\/p>\n Niekt\u00f3re interfejsy API posiadaj\u0105 w swoich komunikatach zwrotnych opcjonalne elementy (parametry), kt\u00f3re system mo\u017ce z r\u00f3\u017cnych powod\u00f3w pomija\u0107 (brak danych, z\u0142e dane, czas odpowiedzi itp.). U\u017cytkownik nie mo\u017ce zak\u0142ada\u0107, \u017ce komunikat zwrotny b\u0119dzie zawsze zawiera\u0107 okre\u015blone dane opcjonalne.<\/p>\n <\/p>\n Wszystkie interfejsy API maj\u0105 jedno ograniczenie:<\/p>\n To ograniczenie dotyczy wszystkich istniej\u0105cych interfejs\u00f3w API systemu zarz\u0105dzania flot\u0105 (FMS).<\/p>\n <\/p>\n Uwierzytelnianie i autoryzacja API s\u0105 konieczne do kontrolowania wykorzystania interfejs\u00f3w API przez poszczeg\u00f3lnych klient\u00f3w oraz ich integracji z r\u00f3\u017cnymi systemami. Aby wysy\u0142a\u0107 autoryzowane \u017c\u0105dania do systemowych interfejs\u00f3w API, aplikacja wysy\u0142aj\u0105ca zapytania musi w imieniu u\u017cytkownika systemu uzyska\u0107 klucz API API_key<\/strong>.<\/p>\n Jedynym sposobem na uzyskanie klucza API przez klient\u00f3w jest bezpo\u015bredni kontakt z dzia\u0142em wsparcia technicznego dostawcy us\u0142ug. Klucz API sk\u0142ada si\u0119 z losowo generowanych liter, cyfr i symboli.<\/p>\n Przyk\u0142ad \u017c\u0105dania wykorzystuj\u0105cego klucz_API:<\/p>\n <\/p>\n Je\u015bli klucz interfejsu API wygas\u0142, zosta\u0142 usuni\u0119ty lub po prostu wy\u0142\u0105czony, system zwr\u00f3ci nast\u0119puj\u0105c\u0105 odpowied\u017a:<\/p>\n Punkty ko\u0144cowe interfejsu API, parametry \u017c\u0105dania i komunikaty zwrotne mo\u017cna przegl\u0105da\u0107 przy pomocy edytora \u201eSwagger\u201d za po\u015brednictwem: https:\/\/api.fm-track.com<\/a><\/p>\n Uwaga Wa\u017cne! W zwi\u0105zku z tym, \u017ce rozwi\u0105zanie API jest stale aktualizowane, ulepszane i odpowiednio modyfikowane, konieczne jest wyja\u015bnienie poj\u0119cia \u201eZgodno\u015bci\u201d i tego, jak wp\u0142ywa na ona u\u017cytkowanie interfejsu API.<\/p>\n Po aktualizacji interfejsu API nast\u0119puje jedna z dw\u00f3ch poni\u017cszychopcji:<\/p>\n Wersja interfejsu API mo\u017ce zosta\u0107 uznana za wstecznie kompatybiln\u0105, je\u015bli:<\/p>\n <\/p>\n <\/p>\n API (interfejs programowania aplikacji) umo\u017cliwia klientom integracj\u0119 systemu zarz\u0105dzania flot\u0105 (FMS) ze swoimi systemami oraz pobieranie i przesy\u0142anie danych o r\u00f3\u017cnych podmiotach. Klient wysy\u0142a \u017c\u0105dania HTTP do systemu, podaj\u0105c informacje o zamierzonym dzia\u0142aniu. Polecenia HTTP zazwyczaj stosowane w interfejsie API: GET \u2013 odczyt zasobu; POST\u2013 zmiana stanu zasobu; \u017b\u0105dana zawarto\u015b\u0107 jest dostarczana w formacie JSON … Czytaj dalej API<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":116,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-4544","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/www.fmsdocumentation.com\/pl\/wp-json\/wp\/v2\/pages\/4544","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.fmsdocumentation.com\/pl\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.fmsdocumentation.com\/pl\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.fmsdocumentation.com\/pl\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.fmsdocumentation.com\/pl\/wp-json\/wp\/v2\/comments?post=4544"}],"version-history":[{"count":1,"href":"https:\/\/www.fmsdocumentation.com\/pl\/wp-json\/wp\/v2\/pages\/4544\/revisions"}],"predecessor-version":[{"id":4926,"href":"https:\/\/www.fmsdocumentation.com\/pl\/wp-json\/wp\/v2\/pages\/4544\/revisions\/4926"}],"wp:attachment":[{"href":"https:\/\/www.fmsdocumentation.com\/pl\/wp-json\/wp\/v2\/media?parent=4544"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}\n
\nOgraniczenia interfejsu API<\/h3>\n
\n
\nUwierzytelnianie API<\/h3>\n
![\"\"](\"https:\/\/www.fmsdocumentation.com\/wp-content\/uploads\/2017\/04\/1.png\")
<\/a><\/p>\n<\/a><\/p>\n
\nWszystkie typy API wymagaj\u0105 okre\u015blenia wersji interfejsu API.<\/p><\/p>\n
\nW zwi\u0105zku z ci\u0105g\u0142ym rozwojem zar\u00f3wno interfejsu API, jak i systemu z kt\u00f3rego pobiera on informacje, u\u017cytkownicy mog\u0105 niekiedy otrzymywa\u0107 parametry niewymienione w opisach. Nieznane parametry, nieudokumentowane w opisach poszczeg\u00f3lnych interfejs\u00f3w API, zaleca si\u0119 po prostu ignorowa\u0107.<\/p><\/p>\n
\nWersjonowanie i zgodno\u015b\u0107<\/h3>\n
\n
\n
\nMo\u017cna bezpiecznie zak\u0142ada\u0107, \u017ce identyfikatory obiekt\u00f3w generowane przez system nie b\u0119d\u0105 przekracza\u0107 255 znak\u00f3w, natomiast u\u017cytkownik powinien by\u0107 w stanie obs\u0142ugiwa\u0107 identyfikatory o potencjalnej d\u0142ugo\u015bci 255 znak\u00f3w. Na przyk\u0142ad, gdy u\u017cytkownik wykorzystuje MySQL, identyfikatory powinny by\u0107 przechowywane w kolumnie VARCHAR (255) COLLATE utf8_bin (konfiguracja COLLATE zapewnia rozr\u00f3\u017cnianie wielko\u015bci liter w wyszukiwaniu).<\/li>\n
\n