Handyman API er en tjeneste for å bygge integrasjoner mot Handyman.
Denne guiden beskriver hvordan du gjør Handyman API tilgjengelig på Handyman-serveren.
Fra og med mai 2023 er det ikke nødvendig å ha en lisens for å teknisk bruke API-tilgangen.
1. Åpne Handyman ControlCenter
2. Naviger til fanen for integrasjon
3. Fyll inn et API-nøkkel etter eget valg (ingen krav til kompleksitet eller antall tegn) og et navn for integrasjonen.
- Navnet bør gjenspeile tjenesten den vil være tilkoblet
- API-nøkkelen kan genereres ved å kjøre "select newid()" i SQL Server Management Studio
4. Klikk på Bruk nederst til høyre
5. Naviger til fanen Tjenester
6. Marker HandymanAPI-tjenesten og klikk på Installer i venstre meny
7. Marker HandymanAPI-tjenesten og klikk på Alternativer i venstre meny
8. Fyll inn Lokal IP (Eksempel: http://192.168.1.15) og GSGroup IDM URL (https://idm.gsgroup.io), Klikk OK
9. Åpne Windows-tjenester (Tjenester), finn og åpne egenskapene til HandymanApi
10. Endre oppstart fra manuell til automatisk
11. Bytt til fanen Logg på og velg Lokal systemkonto
12. Klikk OK og start HandymanApi-tjenesten
Tjenesten skal nå kjøre, og for å utføre en test kan den lokale IP-adressen fra punkt 8 limes inn i en nettleser og legge til /swagger (eksempel: http://192.168.1.15/swagger)
Handyman API er nå tilgjengelig på den lokale serveren og kan kontaktes av andre enheter på det samme nettverket.
Feilsøking:
Hvis du ikke får svar på adressen fra andre maskiner, opprett en lokal brannmur-regel for innkommende http-tilkoblinger (Port 80).