Rychlý postup
- Ve workspace otevřete API a zvolte Vygenerovat klíč. Klíče spravuje vlastník firmy.
- Vyberte oprávnění a platnost. Klíč bezpečně uložte. Vlastník firmy ho může později znovu zobrazit tlačítkem Zobrazit klíč. U starších klíčů uložených pouze jako otisk tato možnost není dostupná.
- Klíč uchovávejte na serveru integrace. Volání posílejte na https://workspace.mydiagnostics.app/api/v1 s hlavičkou Authorization: Bearer YOUR_API_KEY.
- Podle dokumentace workspace.mydiagnostics.app/api/docs/ ověřte filtry a stránkování. OpenAPI obsahuje přesné endpointy a formáty odpovědí.
Postup na obrázcích
Skutečné snímky českého rozhraní s ukázkovými daty. Vzhled se může mírně lišit podle jazyka a verze aplikace.
Nejprve popište cíl integrace
API v1 je dostupné ve všech tarifech MyDiagnostics. Vlastník firmy si vytvoří klíč přímo ve workspace.mydiagnostics.app/api/. API umožňuje čtení historie a detailů diagnostiky, výsledků jednotlivých testů, stanic a využití tarifu. Dokumentace s filtry, stránkováním, oprávněními a příklady je na workspace.mydiagnostics.app/api/docs/. Specifikace OpenAPI slouží k importu do Postmanu nebo Swaggeru.
Připravte mapování dat a zařízení
Předem určete jednoznačný způsob přiřazení výsledků. Rozmyslete, jak váš systém pracuje se sériovým číslem, IMEI, interní zakázkou a časem testu. Počítejte s tím, že některé údaje nemusí být na konkrétním zařízení dostupné. Rozlišujte chybějící hodnotu, nedokončený test a platný výsledek. Domluvte také, jak zpracujete opakovanou diagnostiku stejného telefonu, aby pozdější výsledek bez vysvětlení nepřepsal historii předchozího servisního stavu.
Přístupové údaje a oddělení firem
Integrační přístupové údaje uchovávejte na svém serveru. Nevkládejte je do veřejného JavaScriptu, screenshotů nebo běžných e-mailových příloh. Používejte jen oprávnění potvrzená pro vlastní účet a nepřebírejte přístup jiné firmy. Párovací kód stanice není automaticky API klíčem. Způsob autentizace a případnou obnovu přístupů implementujte podle aktuální dokumentace. Při podezření na zveřejnění údaje řešte jeho zneplatnění a nahrazení s odpovědným správcem či podporou.
Ověření před nasazením do provozu
Integraci nejprve ověřte na malém, kontrolovaném vzorku. Zkontrolujte správné zařízení, čas, jednotky a chování při chybě nebo dočasné nedostupnosti. Ošetřete opakované zpracování, abyste nevytvořili duplicitní záznamy či nechtěně nespouštěli další operaci. Do logů ukládejte jen potřebné technické informace, bez hesel a tokenů. Pro konzultaci pošlete popis cíle, použitou verzi dokumentace, čas chyby a anonymizovanou ukázku problému na support@myrepair.app.
Postup se může mírně lišit podle verze aplikace a systému.
Všechny návodyPotřebujete s něčím pomoci?
Free zahrnuje veřejné návody, osobní technická podpora je součástí placených tarifů. Napište na support@myrepair.app. Uveďte název firmy, model zařízení, verzi systému a krok, u kterého jste se zastavili. Neposílejte hesla, přístupové tokeny ani párovací kódy.