{"id":843,"date":"2017-04-21T07:49:57","date_gmt":"2017-04-21T07:49:57","guid":{"rendered":"http:\/\/www.fmsdocumentation.com\/apis\/"},"modified":"2020-06-09T14:22:15","modified_gmt":"2020-06-09T11:22:15","slug":"apis","status":"publish","type":"page","link":"https:\/\/www.fmsdocumentation.com\/cs\/apis\/","title":{"rendered":"API"},"content":{"rendered":"<p>API (application programming interface) umo\u017e\u0148uje u\u017eivatel\u016fm integrovat syst\u00e9m sledov\u00e1n\u00ed s vlastn\u00edmi syst\u00e9my, vytahovat \u010di p\u0159esouvat data o r\u016fzn\u00fdch entit\u00e1ch.<\/p>\n<p>Klient d\u00e1 po\u017eadavek HTTP do syst\u00e9mu, poskytuj\u00edc\u00ed informaci o zam\u00fd\u0161len\u00e9 akci. Obvykle pou\u017e\u00edvan\u00e9 p\u0159\u00edkazy HTTP:<\/p>\n<ul>\n<li><strong>GET<\/strong> \u2013 \u010cti zdroj;<\/li>\n<li><strong>POST<\/strong> \u2013 Zm\u011b\u0148 stav zdroje;<\/li>\n<\/ul>\n<p>Po\u017eadovan\u00fd obsah se poskytyju ve form\u00e1tu <strong>JSON<\/strong> s k\u00f3dov\u00e1n\u00edm\u00a0 UTF-8. Jestli\u017ee je pou\u017eit jin\u00fd form\u00e1t, je to uvedeno v popisu metody.<\/p>\n<p>Stavov\u00fd k\u00f3d HTTP identifikuje stav po\u017eadavku &#8211; pro \u00fasp\u011b\u0161n\u00e9 po\u017eadavky se vrac\u00ed k\u00f3d <strong>200. <\/strong>Spolu s touto odpov\u011bd\u00ed p\u0159ich\u00e1z\u00ed ze serveru po\u017eadovan\u00e1 informace.\u00a0 Odpov\u011bdi se li\u0161\u00ed podle typu pou\u017eit\u00e9ho API. Odpov\u011bdi API pro r\u016fzn\u00e9 typy API jsou pops\u00e1ny v p\u0159\u00edslu\u0161n\u00fdch odd\u00edlech.<\/p>\n<p>Nastane-li chyba p\u0159i odeslan\u00e9m po\u017eadavku, syst\u00e9m vr\u00e1t\u00ed zpr\u00e1vu se stavov\u00fdm k\u00f3dem. Obvykl\u00e9 chybov\u00e9 k\u00f3dy:<\/p>\n<ul>\n<li><strong>K\u00f3d 400<\/strong> \u2013 Chybn\u00fd po\u017eadavek &#8211; nebyl rozpozn\u00e1n po\u017eadavek API.<\/li>\n<li><strong>K\u00f3d 401<\/strong> \u2013 Neautorizovan\u00fd \u2013 Znamen\u00e1 to, \u017ee chyb\u00ed ov\u011b\u0159en\u00ed p\u0159ihla\u0161ovac\u00edch \u00fadaj\u016f nebo jsou nespr\u00e1vn\u00e9;<\/li>\n<li><strong>K\u00f3d 403<\/strong> \u2013 Zak\u00e1z\u00e1no \u2013 Klient nem\u00e1 pr\u00e1vo p\u0159\u00edstupu k po\u017eadovan\u00e9mu zdroji nebo k proveden\u00ed po\u017eadovan\u00e9 akce;<\/li>\n<li><strong>K\u00f3d 404<\/strong> \u2013 Nenalezeno \u2013 Po\u017eadovan\u00fd zdroj nebyl nalezen.<\/li>\n<li><strong>K\u00f3d 500 <\/strong>\u2013 Vnit\u0159n\u00ed chyba serveru \u2013kontaktujte technickou podporu poskytovaltele slu\u017eby.<\/li>\n<\/ul>\n<p>Chybov\u00e9 k\u00f3dy poskytuj\u00ed obecnou informaci o typu chyby, umo\u017e\u0148uji tak u\u017eivateli identifikovat ko\u0159en probl\u00e9mu.<\/p>\n<p>N\u011bkter\u00e1 API maj\u00ed ve sv\u00fdch odpov\u011bd\u00edch voliteln\u00e9 elementy (parametry), voliteln\u00e9 parametry mohou b\u00fdt z r\u016fzn\u00fdch d\u016fvod\u016f syst\u00e9mem p\u0159esko\u010deny (\u017e\u00e1dn\u00e1 data, \u0161patn\u00e1 data,\u00a0 uplynut\u00ed \u010dasu pro odpov\u011b\u010f, atd.). Nelze p\u0159edpokl\u00e1dat, \u017ee ur\u010dit\u00e1 voliteln\u00e1 data budou v\u017edy v odpov\u011bdi zahrnuta.<\/p>\n<hr \/>\n<h3>Limity API<\/h3>\n<p>V\u0161echna API maj\u00ed jedno omezen\u00ed:<\/p>\n<ul>\n<li>Maxim\u00e1ln\u011b 1000 po\u017eadavk\u016f za minutu.<\/li>\n<\/ul>\n<p>Toto omezen\u00ed plat\u00ed pro v\u0161echna existuj\u00edc\u00ed API v syst\u00e9mu sledov\u00e1n\u00ed.<\/p>\n<hr \/>\n<h3>Autentizace API<strong><br \/>\n<\/strong><\/h3>\n<p>Pro pou\u017eit\u00ed API pro r\u016fzn\u00e9 klienty a jejich integraci s r\u016fzn\u00fdmi syst\u00e9my je po\u017eadov\u00e1na autorizace. Pro to je nutno m\u00edt <strong>API_key.<br \/>\n<\/strong><\/p>\n<p>Klienti mohou obdr\u017eet kl\u00ed\u010d API pouze od sv\u00e9ho poskytovatele slu\u017eby. Kl\u00ed\u010d API obsahuje n\u00e1hodn\u011b generovan\u00e9 p\u00edsmena, \u010d\u00edslice a symboly.<\/p>\n<p>P\u0159\u00edklad po\u017eadavku s pou\u017eit\u00edm kl\u00ed\u010de API:<\/p>\n<p><a href=\"https:\/\/www.fmsdocumentation.com\/wp-content\/uploads\/2017\/04\/1.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-589 size-full\" src=\"https:\/\/www.fmsdocumentation.com\/wp-content\/uploads\/2017\/04\/1.png\" alt=\"\" width=\"672\" height=\"92\" srcset=\"https:\/\/www.fmsdocumentation.com\/wp-content\/uploads\/2017\/04\/1.png 672w, https:\/\/www.fmsdocumentation.com\/wp-content\/uploads\/2017\/04\/1-300x41.png 300w\" sizes=\"auto, (max-width: 672px) 100vw, 672px\" \/><\/a><\/p>\n<p>Jestli\u017ee kl\u00ed\u010d API expiroval, byl odstran\u011bn nebo deaktivov\u00e1n, syst\u00e9m vr\u00e1t\u00ed n\u00e1sleduj\u00edc\u00ed odpov\u011b\u010f:<\/p>\n<p><a href=\"https:\/\/www.fmsdocumentation.com\/wp-content\/uploads\/2017\/04\/2-1.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-590 size-full\" src=\"https:\/\/www.fmsdocumentation.com\/wp-content\/uploads\/2017\/04\/2-1.png\" alt=\"\" width=\"416\" height=\"72\" srcset=\"https:\/\/www.fmsdocumentation.com\/wp-content\/uploads\/2017\/04\/2-1.png 416w, https:\/\/www.fmsdocumentation.com\/wp-content\/uploads\/2017\/04\/2-1-300x52.png 300w\" sizes=\"auto, (max-width: 416px) 100vw, 416px\" \/><\/a><\/p>\n<p>Koncov\u00e9 body API, parametry po\u017eadavk\u016f a odpov\u011bdi poskytuje \u201cSwagger\u201d prost\u0159ednictv\u00edm odkazu: <a href=\"https:\/\/api.fm-track.com\/swagger-ui.html\">https:\/\/api.fm-track.com<\/a><\/p>\n<p style=\"background-color: #2e67b1; color: #ffffff; padding-left: 10px; padding-right: 10px;\"><p class=\"note\">Pozn\u00e1mka<br \/>\nVe v\u0161ech typech API se v\u017edy mus\u00ed specifikovat verze API.<\/p><\/p>\n<p style=\"background-color: #2e67b1; color: #ffffff; padding-left: 10px; padding-right: 10px;\"><p class=\"note\">D\u016fle\u017eit\u00e9!<br \/>\nZ d\u016fvodu neust\u00e1l\u00e9ho v\u00fdvoje API i syst\u00e9m\u016f ze kter\u00fdch se po\u017eaduj\u00ed informace, mohou ob\u010das u\u017eivatel\u00e9 obdr\u017eet parametry neuveden\u00e9 v popisech. Doporu\u010duje se ignorovat nezn\u00e1m\u00e9 parametry, je\u017e nejsou v popise jednotliv\u00fdch API dokumentov\u00e1ny.<\/p><\/p>\n<hr \/>\n<p><div class=\"alignleft\"><a href=\"https:\/\/www.fmsdocumentation.com\/cs\/eco-driving-menu\/analysis-by-driver\/\" title=\"Anal\u00fdza podle \u0159idi\u010d\u016f\"><span class=\"arrow\">\u2039 &nbsp <\/span> Anal\u00fdza podle \u0159idi\u010d\u016f <\/a><\/div> <div class=\"alignright\"><a href=\"https:\/\/www.fmsdocumentation.com\/cs\/apis\/history-api\/\" title=\"Historie sou\u0159adnic objektu API\">Historie sou\u0159adnic objektu API <span class=\"arrow\"> &nbsp\u203a <\/span> <\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"<p>API (application programming interface) umo\u017e\u0148uje u\u017eivatel\u016fm integrovat syst\u00e9m sledov\u00e1n\u00ed s vlastn\u00edmi syst\u00e9my, vytahovat \u010di p\u0159esouvat data o r\u016fzn\u00fdch entit\u00e1ch. Klient d\u00e1 po\u017eadavek HTTP do syst\u00e9mu, poskytuj\u00edc\u00ed informaci o zam\u00fd\u0161len\u00e9 akci. Obvykle pou\u017e\u00edvan\u00e9 p\u0159\u00edkazy HTTP: GET \u2013 \u010cti zdroj; POST \u2013 Zm\u011b\u0148 stav zdroje; Po\u017eadovan\u00fd obsah se poskytyju ve form\u00e1tu JSON s k\u00f3dov\u00e1n\u00edm\u00a0 UTF-8. Jestli\u017ee je &hellip; <a href=\"https:\/\/www.fmsdocumentation.com\/cs\/apis\/\" class=\"more-link\">Pokra\u010dov\u00e1n\u00ed textu <span class=\"screen-reader-text\">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-843","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/www.fmsdocumentation.com\/cs\/wp-json\/wp\/v2\/pages\/843","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.fmsdocumentation.com\/cs\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.fmsdocumentation.com\/cs\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.fmsdocumentation.com\/cs\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.fmsdocumentation.com\/cs\/wp-json\/wp\/v2\/comments?post=843"}],"version-history":[{"count":6,"href":"https:\/\/www.fmsdocumentation.com\/cs\/wp-json\/wp\/v2\/pages\/843\/revisions"}],"predecessor-version":[{"id":5690,"href":"https:\/\/www.fmsdocumentation.com\/cs\/wp-json\/wp\/v2\/pages\/843\/revisions\/5690"}],"wp:attachment":[{"href":"https:\/\/www.fmsdocumentation.com\/cs\/wp-json\/wp\/v2\/media?parent=843"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}