taler-docs

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

get-reserves-attest-RESERVE_PUB.rst (1017B)

      1 .. http:get:: /reserves-attest/$RESERVE_PUB
      2 
      3   Request list of available KYC attributes about the owner of a reserve.
      4   Used as a preliminary step to find out which subsets of attributes the
      5   exchange could provide signatures over.
      6 
      7   **Response:**
      8 
      9   :http:statuscode:`200 OK`:
     10     The exchange responds with a `ReserveKycAttributes` object.
     11   :http:statuscode:`400 Bad Request`:
     12     The ``$RESERVE_PUB`` is malformed.
     13     This response comes with a standard `ErrorDetail` response with
     14     a code of ``TALER_EC_GENERIC_RESERVE_PUB_MALFORMED``.
     15   :http:statuscode:`404 Not found`:
     16     The reserve key does not belong to a reserve known to the exchange.
     17   :http:statuscode:`409 Conflict`:
     18     The exchange does not have the requested KYC information.
     19 
     20   **Details:**
     21 
     22   .. ts:def:: ReserveKycAttributes
     23 
     24     interface ReserveKycAttributes {
     25       // Array of KYC attributes available.  The attribute names
     26       // listed are expected to be from the respective GANA
     27       // registry.
     28       details: string[];
     29     }