taler-docs

Documentation for GNU Taler components, APIs and protocols
Log | Files | Refs | README | LICENSE

post-H_ALIAS.rst (1169B)

      1 .. http:post:: /$H_ALIAS
      2 
      3   This request is the last step of a registration, proving to the TalDir that
      4   the user of the wallet is indeed able to receive messages for the specified
      5   alias.
      6   ``$H_ALIAS`` is the SHA-512 hash of a prefix-free encoding of the
      7   alias to be registered in Crockford Base32 encoding.
      8 
      9   **Request**
     10 
     11   .. ts:def:: IdentityConfirmation
     12 
     13     interface IdentityConfirmation {
     14       // The solution is the SHA-512 hash of the challenge ($PINTAN) value
     15       // chosen by TalDir concatenated with the ``inbox_uri`` (both strings
     16       // are hashed excluding the 0-terminator).
     17       // The hash is provided as string in Crockford base32 encoding.
     18       solution: HashCode;
     19 
     20     }
     21 
     22   **Response**
     23 
     24   :http:statuscode:`204 No Content`:
     25      Registration complete.
     26   :http:statuscode:`403 Forbidden`:
     27      The ``solution`` is invalid. Retrying immediately is allowed.
     28   :http:statuscode:`404 Not found`:
     29      The alias is unknown (original registration attempt may have expired).
     30   :http:statuscode:`429 Too Many Requests`:
     31     The client exceeded the number of allowed attempts for solving
     32     a challenge for this alias in the given timeframe.