API-Beispielseite für ASP

Im Lieferumfang des VSA-API-Webdiensts befindet sich auch eine Testclient-ASP-Seite, die Ihnen hilft, sich mit den verschiedenen API-Vorgängen vertraut zu machen. Sie können daraus ersehen, wie der ASP-Client konstruiert wurde, und auch beliebige Teile dieses Codes in Ihre eigene Anwendung integrieren. Die Benutzer können die tatsächliche Seite unter "/vsaWS/KaseyaWS.asmx" auf einem beliebigen Kaseya Server aufrufen, eine Webmethode auswählen und die exakte XML-SOAP-Anfragestruktur aus der WSDL kopieren und einfügen. 

Die Authentifizierung findet in einem eigenen Rahmen am oberen Rand der Seite statt. Die Sitzungs-ID einer erfolgreichen Authentifizierung wird angezeigt und kann kopiert und in nachfolgende XML-Anforderungen eingefügt werden. 

Hinweis: Diese Seite schließt die angezeigte Sitzungs-ID nicht automatisch in nachfolgende Anfrageanweisungen ein, wie dies bei der API-Beispielanwendung für C# der Fall ist.

Beispiel 1: Authentifizierung

1. Greifen Sie über http://<your-KServer>/vsaWS/TestClient/TestClient.asp auf den ASP-Testclient des VSA-API-Webdiensts zu.
2. Geben Sie einen gültigen Benutzernamen und das Passwort eines VSA-Administrators ein und klicken Sie auf "Anmelden".
3. Wählen Sie die gewünschte Option für den Hash-Algorithmus aus. Details finden Sie unter Authenticate.

   

   In das Textfeld der Sitzungs-ID wird die bei Ihrer Anmeldung generierte Sitzungs-ID eingetragen. Sie müssen diese Sitzungs-ID kopieren und in nachfolgende XML-Anforderungen einfügen.

   

Beispiel 2 - Abrufen-Anforderung erstellen

1. Verwenden Sie in einem zweiten Browser-Fenster die Seite /vsaWS/KaseyaWS.asmx, um eine Methode wie beispielsweise GetLogEntry auszuwählen.

   

2. Jede Methode zeigt die XML SOAP-Struktur für die Anforderung dieser Methode an. Kopieren Sie nur den Teil der Anfragestruktur dieser Methode, der mit <req> beginnt und mit </req> endet.

   

3. Fügen Sie die Anforderungsstruktur in den Bereich 'Anforderung' der Seite 'TestClient.asp' ein. Geben Sie den Namen der Methode in das Feld 'Name' der Webmethode ein. Ersetzen Sie den Platzhalter 'Dezimalwert' durch die Sitzungs-ID, die Sie während der Authentifizierung erhalten haben. Ersetzen Sie nach Bedarf andere Platzhalterinhalte durch gültige Daten. Klicken Sie anschließend auf 'Senden'.

   Hinweis: Das Element  <BrowserIP></BrowserIP> kann in allen Methoden ignoriert werden. Weitere Informationen finden Sie unter Beschränkung von Anfragen nach IP-Adresse und Benutzer.

   

   Die Ergebnisse werden im Antwort-Bereich angezeigt.