Po\u017eadovan\u00fd obsah sa poskytuje vo form\u00e1te JSON s k\u00f3dovan\u00edm UTF-8. Ak je pou\u017eit\u00fd in\u00fd form\u00e1t, je to uveden\u00e9 v popise met\u00f3dy.<\/p>\n
Stavov\u00fd k\u00f3d HTTP identifikuje stav po\u017eiadavke – pre \u00faspe\u0161n\u00e9 po\u017eiadavky sa vracia k\u00f3d 200. Spolu s touto odpove\u010fou prich\u00e1dza zo servera po\u017eadovan\u00e9 inform\u00e1cie. Odpovede sa l\u00ed\u0161i pod\u013ea typu pou\u017eit\u00e9ho API. Odpovede API pre r\u00f4zne typy API s\u00fa pop\u00edsan\u00e9 v pr\u00edslu\u0161n\u00fdch oddieloch.<\/p>\n
Ak nastane chyba pri odoslanom po\u017eiadavke, syst\u00e9m vr\u00e1ti spr\u00e1vu s k\u00f3dom stavu. Obvykl\u00e9 chybov\u00e9 k\u00f3dy:<\/p>\n
- \n
- K\u00f3d 400<\/strong> – Nespr\u00e1vna po\u017eiadavka – nebol rozpoznan\u00fd po\u017eiadavka API.<\/li>\n
- K\u00f3d 401<\/strong> – Neautorizovan\u00fd – Znamen\u00e1 to, \u017ee ch\u00fdba overenie prihlasovac\u00edch \u00fadajov alebo s\u00fa nespr\u00e1vne;<\/li>\n
- K\u00f3d 403<\/strong> – Zak\u00e1zan\u00e9 – Klient nem\u00e1 pr\u00e1vo pr\u00edstupu k po\u017eadovan\u00e9mu zdroju alebo na vykonanie po\u017eadovanej akcie;<\/li>\n
- K\u00f3d 404<\/strong> – Nen\u00e1jden\u00e9 – Po\u017eadovan\u00fd zdroj nebol n\u00e1jden\u00fd.<\/li>\n
- K\u00f3d 500 <\/strong>– Vn\u00fatorn\u00e1 chyba servera -kontaktujte technick\u00fa podporu poskytovale\u013ea slu\u017eby.<\/li>\n<\/ul>\n
Chybov\u00e9 k\u00f3dy poskytuj\u00fa v\u0161eobecn\u00fa inform\u00e1ciu o type chyby, umo\u017e\u0148uj\u00fa tak u\u017e\u00edvate\u013eovi identifikova\u0165 kore\u0148 probl\u00e9mu.<\/p>\n
Niektor\u00e9 API maj\u00fa vo svojich odpovediach volite\u013en\u00e9 elementy (parametre), volite\u013en\u00e9 parametre m\u00f4\u017eu by\u0165 z r\u00f4znych d\u00f4vodov syst\u00e9mom presko\u010dia (\u017eiadne d\u00e1ta, zl\u00e9 d\u00e1ta, uplynut\u00ed \u010dasu na odpove\u010f, at\u010f.). Nemo\u017eno predpoklada\u0165, \u017ee ur\u010dit\u00e1 volite\u013en\u00e1 d\u00e1ta bud\u00fa v\u017edy v odpovedi zahrnut\u00e1.<\/p>\n
\nLimity API<\/h3>\n
V\u0161etky API maj\u00fa jedno obmedzenie:<\/p>\n
- \n
- Maxim\u00e1lne 1000 po\u017eiadaviek za min\u00fatu.<\/li>\n<\/ul>\n
Toto obmedzenie plat\u00ed pre v\u0161etky existuj\u00face API v syst\u00e9me sledovania.<\/p>\n
\nAutentiz\u00e1cia API<\/h3>\n
Na pou\u017eitie API pre r\u00f4zne klientov a ich integr\u00e1ciu s r\u00f4znymi syst\u00e9mami je po\u017eadovan\u00e1 autoriz\u00e1cia. Pre to je nutn\u00e9 ma\u0165 API_key.<\/p>\n
Klienti m\u00f4\u017eu z\u00edska\u0165 k\u013e\u00fa\u010d API iba od svojho poskytovate\u013ea slu\u017eby. K\u013e\u00fa\u010d API obsahuje n\u00e1hodne generovan\u00e9 p\u00edsmen\u00e1, \u010d\u00edslice a symboly.<\/p>\n
Pr\u00edklad po\u017eiadavke s pou\u017eit\u00edm k\u013e\u00fa\u010da API:<\/p>\n
![\"\"](\"https:\/\/www.fmsdocumentation.com\/wp-content\/uploads\/2017\/04\/1.png\")
<\/a><\/p>\nAk k\u013e\u00fa\u010d API expiroval, bol odstr\u00e1nen\u00fd alebo deaktivovan\u00fd, syst\u00e9m vr\u00e1ti nasleduj\u00face odpove\u010f:<\/p>\n
![\"\"](\"https:\/\/www.fmsdocumentation.com\/wp-content\/uploads\/2017\/04\/2-1.png\")
<\/a><\/p>\nKoncov\u00e9 body API, parametre po\u017eiadaviek a odpovede poskytuje “Swagger” prostredn\u00edctvom odkazu: https:\/\/api.fm-track.com<\/a><\/u><\/p>\n
Pozn\u00e1mka
\nVo v\u0161etk\u00fdch typoch API sa v\u017edy mus\u00ed \u0161pecifikova\u0165 verzia API.<\/p><\/p>\nD\u00f4le\u017eit\u00e9!
\nZ d\u00f4vodu neust\u00e1leho v\u00fdvoja API aj syst\u00e9mov z ktor\u00fdch sa vy\u017eaduj\u00fa inform\u00e1cie, m\u00f4\u017eu ob\u010das u\u017e\u00edvatelia obdr\u017ea\u0165 parametre neuveden\u00e9 v popisoch. Odpor\u00fa\u010da sa ignorova\u0165 nezn\u00e1me parametre, ktor\u00e9 nie s\u00fa v popise jednotliv\u00fdch API dokumentovan\u00e9.<\/p><\/p>\n
\n\u2039 <\/span> Anal\u00fdza pod\u013ea vodi\u010dov <\/a><\/div>Hist\u00f3ria s\u00faradn\u00edc objektu API \u203a <\/span> <\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"API (Aplika\u010dn\u00e9 programovacie rozhranie) umo\u017e\u0148uje pou\u017e\u00edvate\u013eom integrova\u0165 syst\u00e9m sledovania s vlastn\u00fdmi syst\u00e9mami, vy\u0165ahova\u0165 \u010di pres\u00fava\u0165 d\u00e1ta o r\u00f4znych entit\u00e1ch. Klient d\u00e1 po\u017eiadavku HTTP do syst\u00e9mu, poskytuj\u00face inform\u00e1ciu o zam\u00fd\u0161\u013eanej akcii. Obvykle pou\u017e\u00edvan\u00e9 pr\u00edkazy HTTP: GET – \u010c\u00edtaj zdroj; POST – Zme\u0148 stav zdroje; Po\u017eadovan\u00fd obsah sa poskytuje vo form\u00e1te JSON s k\u00f3dovan\u00edm UTF-8. Ak je … Pokra\u010dova\u0165 v \u010d\u00edtan\u00ed: API<\/span><\/a><\/p>\n","protected":false},"author":5,"featured_media":0,"parent":0,"menu_order":116,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-6618","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/www.fmsdocumentation.com\/sk\/wp-json\/wp\/v2\/pages\/6618","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.fmsdocumentation.com\/sk\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.fmsdocumentation.com\/sk\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.fmsdocumentation.com\/sk\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/www.fmsdocumentation.com\/sk\/wp-json\/wp\/v2\/comments?post=6618"}],"version-history":[{"count":5,"href":"https:\/\/www.fmsdocumentation.com\/sk\/wp-json\/wp\/v2\/pages\/6618\/revisions"}],"predecessor-version":[{"id":6680,"href":"https:\/\/www.fmsdocumentation.com\/sk\/wp-json\/wp\/v2\/pages\/6618\/revisions\/6680"}],"wp:attachment":[{"href":"https:\/\/www.fmsdocumentation.com\/sk\/wp-json\/wp\/v2\/media?parent=6618"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
- K\u00f3d 401<\/strong> – Neautorizovan\u00fd – Znamen\u00e1 to, \u017ee ch\u00fdba overenie prihlasovac\u00edch \u00fadajov alebo s\u00fa nespr\u00e1vne;<\/li>\n