Handyman API er en service til at bygge integrationer mod Handyman.
Denne vejledning beskriver, hvordan du gør Handyman API tilgængelig på Handyman-serveren.
Fra maj 2023 er det ikke nødvendigt at have en licens for teknisk at bruge API-adgangen.
1. Åbn Handyman ControlCenter
2. Naviger til fanen Integration
3. Indtast en API-nøgle efter eget valg (ingen krav til kompleksitet eller antal tegn) og et navn til integrationen.
- Navnet skal afspejle den service, den vil være forbundet til
- API-nøgle kan genereres via SQL Server Management Studio ved at køre "select newid()"
4. Klik på Anvend i nederste højre hjørne
5. Naviger til fanen Tjenester
6. Marker HandymanAPI-tjenesten og klik på Installer i venstre menu
7. Marker HandymanAPI-tjenesten og klik på Indstillinger i venstre menu
8. Udfyld Lokal IP (Eksempel: http://192.168.1.15) og GSGroup IDM URL (https://idm.gsgroup.io), Klik på OK
9. Åbn Windows-tjenester (Services), find og åbn egenskaberne for HandymanApi
10. Skift opstart fra manuel til automatisk
11. Skift til fanen Log På og vælg Lokalt systemkonto
12. Klik på OK og start HandymanApi-tjenesten
Tjenesten burde nu køre, og for at lave en test kan den lokale IP-adresse fra punkt 8 indsættes i en browser sammen med /swagger (eksempel: http://192.168.1.15/swagger)
Handyman API er nu tilgængelig på den lokale server og kan kontaktes af andre enheder på det samme netværk.
Fejlfinding:
Hvis du ikke får svar fra adressen fra andre maskiner, skal du oprette en lokal firewall-regel for indgående http (Port 80).