Skip to content

Handle Check

Calling this endpoint allows you to check the validity of an auth handle

Production:

shellscript
curl -X POST --location 'https://oauth2.authservice.hin.ch/v1/oauth/handle/' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {...}' \
--data '{ "authHandle": "{...}" }'

Test environment:

shellscript
curl -X POST --location 'https://oauth2.authservice-int.hin.ch/v1/oauth/handle/' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {...}' \
--data '{ "authHandle": "{...}" }'

Return value when handle is invalid/expired

http
HTTP/1.1 404 Not Found

Return value when handle is valid

http
HTTP/1.1 200 OK
json
{ 
  "hinid":"musterh",
  "email":"hans.muster@hin.ch",
  "firstname":"Hans",
  "lastname":"Muster",
  "gln":"2000000010366",
  "verificationLevel":20,
  "personcodes":["10"] 
}

version 1.0.0