GET /info

This userinfo endpoint of the OAuth 2.0 specification. This endpoint is used by the client to obtain the user’s validated address.

Request:

Must include the token returned to the client from the /token endpoint as a Bearer token in an Authorization header.

Response:

200 OK:

The body contains the address as a ChallengerInfoResponse.

403 Forbidden:

The bearer token is missing or invalid (malformed).

404 Not found:

The bearer token is invalid (includes unknown or expired). Returned with TALER_EC_CHALLENGER_GRANT_UNKNOWN.

500 Internal Server Error:

The challenger service encountered an internal error, typically a database failure. Usually returned with TALER_EC_GENERIC_DB_FETCH_FAILED.

Details::

interface ChallengerInfoResponse {

  // Unique ID of the record within Challenger
  // (identifies the rowid of the token).
  id: Integer;

  // Address that was validated.
  // Key-value pairs, details depend on the
  // address_type.
  address: Object;

 // Type of the address.
  address_type: string;

  // How long do we consider the address to be
  // valid for this user.
  expires: Timestamp;

}