user API

1 files changed, 27 insertions, 6 deletions

diff --git a/libeufin/api-nexus2.rst b/libeufin/api-nexus2.rst
index af940dec..3609b0e0 100644
--- a/libeufin/api-nexus2.rst
+++ b/libeufin/api-nexus2.rst
@@ -7,12 +7,33 @@ HTTP API
 Authentication
 --------------
 
-**Every** request made to nexus must be authenticated
-using the *HTTP basic auth* mechanism.
+Currently every request made to nexus must be authenticated using the *HTTP
+basic auth* mechanism.
+
+Other authentication mechanisms (e.g. OpenID Connect) might
+be supported in the future.
 
 Users Management
 ----------------
 
+.. http:get:: <nexus>/user
+
+  Get information about the current user (based on the authentication information
+  in this request).
+
+  **Response:**
+
+  .. ts:def:: GetUserResponse
+
+     interface UserResponse {
+
+       // User name
+       username: string;
+
+       // Is it a superuser?
+       superuser: boolean;
+     }
+
 .. http:post:: <nexus>/users
 
   Create a new user.  Only the super-user can call this API.
@@ -27,15 +48,15 @@ Users Management
 
   **Details:**
 
-  .. ts:def:: User
+  .. ts:def:: CreateUserRequest
 
      interface User {
 
        // User name
        username: string;
 
-       // Shadow password
-       shadowPassword: string;
+       // Initial password
+       password: string;
      }
 
 Bank Account Management
@@ -164,7 +185,7 @@ Bank Account Management
      interface CollectTransactions {
        // Optional field to specify the bank transport to
        // use for such operation.
-       bankTransport: string;
+       bankTransport?: string;
        // dashed date (YYYY-MM-DD) of the earliest payment
        // in the result. Optional, defaults to "earliest
        // possible" date.