taler-docs

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

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

      1 .. http:get:: /reserves/$RESERVE_PUB/attest
      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 `ReserveKycAttributesAvailableResponse`
     11     object.
     12   :http:statuscode:`400 Bad Request`:
     13     The ``$RESERVE_PUB`` is malformed.
     14     This response comes with a standard `ErrorDetail` response with
     15     a code of ``TALER_EC_GENERIC_RESERVE_PUB_MALFORMED``.
     16   :http:statuscode:`404 Not found`:
     17     The reserve key does not belong to a reserve known to the exchange.
     18   :http:statuscode:`409 Conflict`:
     19     The exchange does not have the requested KYC information.
     20 
     21   **Details:**
     22 
     23   .. ts:def:: ReserveKycAttributesAvailableResponse
     24 
     25     interface ReserveKycAttributesAvailableResponse {
     26       // Array of KYC attributes available.  The attribute names
     27       // listed are expected to be from the respective GANA
     28       // registry.
     29       details: string[];
     30     }