From e4669eaf9700ecc503bee3305315256968bd05e5 Mon Sep 17 00:00:00 2001 From: Adrien Hopkins Date: Wed, 18 Aug 2021 13:45:18 -0500 Subject: Compiled existing api docs to ./apidoc/ --- apidoc/api_project.json | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 apidoc/api_project.json (limited to 'apidoc/api_project.json') diff --git a/apidoc/api_project.json b/apidoc/api_project.json new file mode 100644 index 00000000..828595f0 --- /dev/null +++ b/apidoc/api_project.json @@ -0,0 +1,16 @@ +{ + "title": "CoinOS Server API Documentation", + "url": "https://coinos.io/api", + "name": "coinos", + "version": "0.0.1", + "description": "", + "sampleUrl": false, + "defaultVersion": "0.0.0", + "apidoc": "0.3.0", + "generator": { + "name": "apidoc", + "time": "2021-08-18T18:43:04.642Z", + "url": "https://apidocjs.com", + "version": "0.29.0" + } +} -- cgit v1.2.3 From 2a0252707890c156c008719574f0da000b853ba2 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(-) (limited to 'apidoc/api_project.json') 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