Request Grant

Close to all logins will be followed by collecting the Grant details.

Get the information about a Grant: user_grant

Parameter $user_grant is taken from the application login answer: the url in $session->{endpoints}{user_grant}. The $bearer is also taken from your application login session: the value of $session->{session}{bearer}. Both values do not contain characters which require encoding.

The $code is the user representing token, which

The request will be

  GET $user_grant(path)?code=$code
  Host: $user_grant(host)
  Authentication: Bearer $bearer

The $bearer originates from your application instance login reply: session/bearer (some token containing :T:)

Besides the Application Session Errors, you can also get:

• HTTP_PRECONDITION_FAILED (412) the $code is missing
• HTTP_NOT_ACCEPTABLE (406), the $code is not a valid token or not a comply token
• HTTP_BAD_REQUEST (400), the token is not a comply id
• HTTP_NOT_FOUND (404), the comply related to the token does not exist (anymore)
• HTTP_EXPECTATION_FAILED (417), the comply does not belong the application service
• HTTP_OK (200), grant attached. See Grant specification

All non-5XX responses return a JSON document.