Handyman API är en tjänst för att bygga integrationer mot Handyman.
Denna guide beskriver hur man gör Handyman API tillgängligt på Handyman-servern.
Från och med maj 2023 är det inte nödvändigt att ha en licens för att tekniskt använda API-åtkomsten.
1. Öppna Handyman ControlCenter
2. Navigera till fliken Integration
3. Fyll i en API-nyckel efter eget val (ingen krav på komplexitet eller antal tecken) och ett namn för integrationen.
- Namnet bör återspegla den tjänst den kommer att vara ansluten till
- API-nyckel kan genereras med SQL Server Management Studio genom att köra "select newid()"
4. Klicka på Tillämpa i det nedre högra hörnet
5. Navigera till fliken Tjänster
6. Markera HandymanAPI-tjänsten och klicka på Installera i vänstermenyn
7. Markera HandymanAPI-tjänsten och klicka på Alternativ i vänstermenyn
8. Fyll i lokal IP (Exempel: http://192.168.1.15) och GSGroup IDM URL (https://idm.gsgroup.io), klicka på OK
9. Öppna Windows-tjänster (Tjänster), hitta och öppna egenskaperna för HandymanApi
10. Ändra start från manuell till automatisk
11. Byt flik till Logga in och välj Lokalt systemkonto
12. Klicka på OK och starta HandymanApi-tjänsten
Tjänsten bör nu köras och för att göra ett test kan den lokala IP-adressen från punkt 8 klistras in i en webbläsare och lägg till /swagger (exempel: http://192.168.1.15/swagger)
Handyman API är nu tillgängligt på den lokala servern och kan kontaktas av andra enheter på samma nätverk.
Felsökning:
Om du inte får något svar till adressen från andra maskiner, skapa en lokal brandväggsregel för http (Port 80) inkommande.