Die Handyman API ist ein Dienst zum Erstellen von Integrationen mit Handyman.
Diese Anleitung beschreibt, wie Sie die Handyman API auf dem Handyman-Server verfügbar machen.
Seit Mai 2023 ist keine Lizenz erforderlich, um den API-Zugang technisch zu nutzen.
1. Öffnen Sie Handyman ControlCenter
2. Navigieren Sie zur Registerkarte Integration
3. Geben Sie einen API-Schlüssel Ihrer Wahl (keine Anforderungen an Komplexität oder Zeichenanzahl) und einen Namen für die Integration ein.
- Der Name sollte den Dienst widerspiegeln, mit dem er verbunden wird
- Der API-Schlüssel kann mit SQL Server Management Studio durch Ausführen von "select newid()" generiert werden
4. Klicken Sie unten rechts auf Übernehmen
5. Navigieren Sie zur Registerkarte Dienste
6. Markieren Sie den Dienst HandymanAPI und klicken Sie im linken Menü auf Installieren
7. Markieren Sie den Dienst HandymanAPI und klicken Sie im linken Menü auf Optionen
8. Geben Sie die lokale IP (Beispiel: http://192.168.1.15) und die GSG Handyman IDM-URL (https://idm.gsgroup.io) ein, klicken Sie auf OK
9. Öffnen Sie die Windows-Dienste (Dienste), suchen Sie die Eigenschaften von HandymanApi und öffnen Sie sie
10. Ändern Sie den Starttyp von Manuell auf Automatisch
11. Wechseln Sie zur Registerkarte Anmelden und wählen Sie Lokales Systemkonto
12. Klicken Sie auf OK und starten Sie den HandymanApi-Dienst
Der Dienst sollte jetzt laufen. Zum Testen können Sie die lokale IP-Adresse aus Punkt 8 in einen Browser einfügen und /swagger anhängen (Beispiel: http://192.168.1.15/swagger)
Die Handyman API ist nun auf dem lokalen Server verfügbar und kann von anderen Geräten im selben Netzwerk kontaktiert werden.
Fehlerbehebung:
Wenn Sie von anderen Rechnern aus keine Antwort auf die Adresse erhalten, erstellen Sie eine lokale Firewall-Regel für eingehenden http-Verkehr (Port 80).