Benutzer und Anforderer validieren

Hinweis: Endpunkte erfordern keine Authentifizierung. Es ist nicht erforderlich, Token- oder Basisauthentifizierung für und /api/login/ValidateRequester /api/login/validate hinzuzufügen
Warnung: Endpunkte unterstützen nur POST-Anfragen. Wenn Sie versuchen, oder /api/login/validate URL /api/login/ValidateRequester in Ihrem Browser zu öffnen oder auf andere Weise eine GET-Anfrage durchzuführen, erhalten Sie eine Fehlermeldung. Dieser Endpunkt unterstützt nur POST.

Anfragende validieren

Wir haben einen großartigen Service Desk, aber vielleicht möchten Sie lieber Ihre eigene Anwendung für externe Benutzer entwickeln. In diesem Fall benötigen Sie eine Möglichkeit, um zu überprüfen, ob ein Anforderer einen gültigen Benutzernamen und ein gültiges Passwort eingegeben hat oder nicht. Dies kann über den ValidateRequester Endpunkt überprüft werden, indem die Anmeldedaten und das Passwort des Anfragenden in der JSON-Nutzlast übergeben werden:

POST to /api/login/ValidateRequester

{
  "Email": "user@external.com",
  "Password": "s86g5w~V!k"
}
curl --header "Content-type: application/json" --url "https://restapi.tpondemand.com/api/login/ValidateRequester" --data "{'Email':'teddy@targetprocess.com','Password':'lq2%m!'}"
Wenn die Anmeldung und das Passwort korrekt waren, erhalten { "isValid": true } Sie als Antwort. Andernfalls erhalten Sie { "isValid": false }

Benutzer validieren

Um zu überprüfen, ob ein Targetprocess-Benutzer einen gültigen Benutzernamen und ein gültiges Passwort eingegeben hat, können Sie den Endpunkt Validate verwenden:
POST to /api/login/validate

{
  "username": "user@internal.com",
  "Password": "s86g5w~V!k"
}
curl --header "Content-type: application/json" --url "https://restapi.tpondemand.com/api/login/validate" --data "{'username':'John','Password':'123'}"
Wenn der Benutzername und das Passwort korrekt waren, erhalten Sie als Antwort den Status 200 OK. Andernfalls erhalten Sie den Fehler 401 Unauthorized.