[GNUnet-SVN] [taler-bank] branch master updated: Documenting the /history API.

[gnunet]

This is an automated email from the git hooks/post-receive script.

marcello pushed a commit to branch master
in repository bank.

The following commit(s) were added to refs/heads/master by this push:
     new c6ff493  Documenting the /history API.
c6ff493 is described below

commit c6ff493f37ae587254aa841999b97ea3aa8321f3
Author: Marcello Stanisci <address@hidden>
AuthorDate: Thu Jul 27 22:45:34 2017 +0200

    Documenting the /history API.
---
 doc/taler-bank.texi             | 39 +++++++++++++++++++++++++++++++++++++++
 talerbank/app/static/web-common |  2 +-
 2 files changed, 40 insertions(+), 1 deletion(-)

diff --git a/doc/taler-bank.texi b/doc/taler-bank.texi
index 0eea349..fca47b9 100644
--- a/doc/taler-bank.texi
+++ b/doc/taler-bank.texi
@@ -38,6 +38,7 @@ Texts.  A copy of the license is included in the section 
entitled
 @subtitle Version @value{VERSION}
 @subtitle @value{UPDATED}
 @author Florian Dold (@email{florian.dold@@inria.fr})
address@hidden Marcello Stanisci (@email{marcello.stanisci@@inria.fr})
 @page
 @vskip 0pt plus 1filll
 @insertcopying
@@ -203,6 +204,44 @@ However, the bank will define two additional values for 
this API: @code{executio
 (a operation's timestamp), and @code{transfer_details} (just a "seed" to make 
unique the
 operation).  See 
@url{https://docs.taler.net/api/api-exchange.html#administrative-api-bank-transactions}.
 
+The polling mechanism is possbile thanks to the @code{/history} API provided
+by the bank.  The exchange will periodically use this API to see if it has
+received new wire transfers; upon receiving a new wire transfer, the exchange
+will automatically create a reserve and allow the money sender to withdraw.
+
address@hidden @code
+
address@hidden GET /history
+Ask the bank to return a list of money transactions related to a caller's
+bank account.
+
address@hidden
+
address@hidden @code{auth} a string indicating the authentication method to use;
+only @code{"basic"} value is accepted so far. The username and password
+credentials have to be sent along the HTTP request headers.  Namely, the
+bank will look for the following two headers: @code{X-Taler-Bank-Username}
+and @code{X-Taler-Bank-Password}, which will contain those plain text 
credentials.
+
address@hidden @code{delta} returns the first @code{N} records younger (older) 
than @code{start}
+if @code{+N} (@code{-N}) is specified.
+
address@hidden @code{start} according to delta, only those records with row id
+strictly greater (lesser) than start will be returned. This argument is
+optional; if not given, delta youngest records will be returned.
+
address@hidden @code{direction} optional argument taking values debit or credit,
+according to the caller willing to receive both incoming and outgoing,
+only outgoing, or only incoming records
+
address@hidden @code{account_number} optional argument indicating the bank 
account
+number whose history is to be returned. If not given, then the history of
+the calling user will be returned
+
address@hidden itemize
+
address@hidden table
+
 
 @subsection Exchange pays merchant
 
diff --git a/talerbank/app/static/web-common b/talerbank/app/static/web-common
index d7e0135..489a9e3 160000
--- a/talerbank/app/static/web-common
+++ b/talerbank/app/static/web-common
@@ -1 +1 @@
-Subproject commit d7e013594d15388b1a7342a44a0e9c8d4ecca82d
+Subproject commit 489a9e38e6960fdce309ab8cf5ff66d930ecb3bc

-- 
To stop receiving notification emails like this one, please contact
address@hidden