From 4d2b17ca203c389b4ed678007377a0fd93b889eb Mon Sep 17 00:00:00 2001 From: Adrien Hopkins Date: Wed, 18 Aug 2021 14:22:32 -0500 Subject: Documented /api/info --- apidoc/api_data.js | 37 +++++++++++++++++++++++++++++++++++++ apidoc/api_data.json | 37 +++++++++++++++++++++++++++++++++++++ apidoc/api_project.js | 2 +- apidoc/api_project.json | 2 +- routes/info.js | 9 +++++++++ 5 files changed, 85 insertions(+), 2 deletions(-) diff --git a/apidoc/api_data.js b/apidoc/api_data.js index 961f82a7..63c793fa 100644 --- a/apidoc/api_data.js +++ b/apidoc/api_data.js @@ -374,6 +374,43 @@ define({ "api": [ "filename": "routes/admin.js", "groupTitle": "Admin" }, + { + "type": "get", + "url": "/info", + "title": "Request server information", + "name": "GetInfo", + "group": "Info", + "success": { + "fields": { + "Success 200": [ + { + "group": "Success 200", + "type": "Object", + "optional": false, + "field": "fx", + "description": "

Exchange rates relative to USD - fx.CUR is the value of one CUR in USD.

" + }, + { + "group": "Success 200", + "type": "String[]", + "optional": false, + "field": "networks", + "description": "

Array of supported networks; possible values are "bitcoin", "liquid" and "lightning".

" + }, + { + "group": "Success 200", + "type": "String", + "optional": false, + "field": "clientVersion", + "description": "

the current git commit of the ui

" + } + ] + } + }, + "version": "0.0.0", + "filename": "routes/info.js", + "groupTitle": "Info" + }, { "type": "post", "url": "/grant", diff --git a/apidoc/api_data.json b/apidoc/api_data.json index 180cbe16..5bab3ee7 100644 --- a/apidoc/api_data.json +++ b/apidoc/api_data.json @@ -374,6 +374,43 @@ "filename": "routes/admin.js", "groupTitle": "Admin" }, + { + "type": "get", + "url": "/info", + "title": "Request server information", + "name": "GetInfo", + "group": "Info", + "success": { + "fields": { + "Success 200": [ + { + "group": "Success 200", + "type": "Object", + "optional": false, + "field": "fx", + "description": "

Exchange rates relative to USD - fx.CUR is the value of one CUR in USD.

" + }, + { + "group": "Success 200", + "type": "String[]", + "optional": false, + "field": "networks", + "description": "

Array of supported networks; possible values are "bitcoin", "liquid" and "lightning".

" + }, + { + "group": "Success 200", + "type": "String", + "optional": false, + "field": "clientVersion", + "description": "

the current git commit of the ui

" + } + ] + } + }, + "version": "0.0.0", + "filename": "routes/info.js", + "groupTitle": "Info" + }, { "type": "post", "url": "/grant", diff --git a/apidoc/api_project.js b/apidoc/api_project.js index ef1b3f4c..b382cf76 100644 --- a/apidoc/api_project.js +++ b/apidoc/api_project.js @@ -9,7 +9,7 @@ define({ "apidoc": "0.3.0", "generator": { "name": "apidoc", - "time": "2021-08-18T18:43:04.642Z", + "time": "2021-08-18T19:13:24.486Z", "url": "https://apidocjs.com", "version": "0.29.0" } diff --git a/apidoc/api_project.json b/apidoc/api_project.json index 828595f0..42943876 100644 --- a/apidoc/api_project.json +++ b/apidoc/api_project.json @@ -9,7 +9,7 @@ "apidoc": "0.3.0", "generator": { "name": "apidoc", - "time": "2021-08-18T18:43:04.642Z", + "time": "2021-08-18T19:13:24.486Z", "url": "https://apidocjs.com", "version": "0.29.0" } diff --git a/routes/info.js b/routes/info.js index 6d9d5f32..8d098a2f 100644 --- a/routes/info.js +++ b/routes/info.js @@ -1,6 +1,15 @@ const sequelize = require("sequelize"); const { Op } = sequelize; +/** + * @api {get} /info Request server information + * @apiName GetInfo + * @apiGroup Info + * + * @apiSuccess {Object} fx Exchange rates relative to USD - fx.CUR is the value of one CUR in USD. + * @apiSuccess {String[]} networks Array of supported networks; possible values are "bitcoin", "liquid" and "lightning". + * @apiSuccess {String} clientVersion the current git commit of the ui + */ app.get("/info", ah(async (req, res, next) => { const { clientVersion } = config; -- cgit v1.2.3