express-api-example/docs/api_data.js

362 lines
8.4 KiB
JavaScript
Raw Normal View History

2018-11-12 15:26:44 +00:00
define({ "api": [
2018-11-12 17:19:39 +00:00
{
"type": "post",
"url": "/auth/login",
2018-11-14 17:16:00 +00:00
"title": "Get access token",
2018-11-12 17:19:39 +00:00
"name": "Login",
"group": "Auth",
"parameter": {
"fields": {
"Parameter": [
{
"group": "Parameter",
"type": "String",
"optional": false,
"field": "username",
"description": "<p>username of the user.</p>"
},
{
"group": "Parameter",
"type": "String",
"optional": false,
"field": "password",
"description": "<p>password of the user.</p>"
}
]
}
},
"success": {
"fields": {
"Success 200": [
{
"group": "Success 200",
"type": "string",
"optional": false,
2018-11-15 18:28:51 +00:00
"field": "access_token",
"description": "<p>Access token.</p>"
2018-11-12 17:19:39 +00:00
}
]
}
},
"version": "0.0.0",
"filename": "app/routes/auth/index.js",
"groupTitle": "Auth"
},
{
"type": "post",
"url": "/auth/register",
"title": "Register",
"name": "Register",
"group": "Auth",
"parameter": {
"fields": {
"Parameter": [
{
"group": "Parameter",
"type": "String",
"optional": false,
"field": "firstname",
"description": "<p>Firstname of the user.</p>"
},
{
"group": "Parameter",
"type": "String",
"optional": false,
"field": "lastname",
"description": "<p>Lastname of the user.</p>"
},
{
"group": "Parameter",
"type": "String",
"optional": false,
"field": "username",
"description": "<p>username of the user.</p>"
},
{
"group": "Parameter",
"type": "String",
"optional": false,
"field": "password",
"description": "<p>password of the user.</p>"
}
]
}
},
"success": {
"fields": {
"Success 200": [
{
"group": "Success 200",
"type": "Array",
"optional": false,
"field": "Array",
"description": "<p>Array of Note objects.</p>"
}
]
}
},
"version": "0.0.0",
"filename": "app/routes/auth/index.js",
"groupTitle": "Auth"
},
{
"type": "post",
"url": "/note",
"title": "Create note",
"name": "CreateNote",
"group": "Note",
2018-11-15 18:28:51 +00:00
"header": {
"examples": [
{
"title": "Header-Example:",
"content": "{\n \"Authorization\": \"<Access_Token>\"\n}",
"type": "json"
}
]
},
2018-11-12 17:19:39 +00:00
"success": {
"fields": {
"Success 200": [
{
"group": "Success 200",
2018-11-15 18:28:51 +00:00
"type": "string",
2018-11-12 17:19:39 +00:00
"optional": false,
2018-11-15 18:28:51 +00:00
"field": "title",
"description": "<p>Title of the note.</p>"
},
{
"group": "Success 200",
"type": "string",
"optional": false,
"field": "text",
"description": "<p>Text of the note.</p>"
2018-11-12 17:19:39 +00:00
}
]
}
},
"version": "0.0.0",
"filename": "app/routes/note/index.js",
"groupTitle": "Note"
},
{
"type": "delete",
"url": "/note/:id",
2018-11-14 17:16:00 +00:00
"title": "Delete note",
2018-11-12 17:19:39 +00:00
"name": "DeleteNote",
"group": "Note",
2018-11-15 18:28:51 +00:00
"success": {
"examples": [
{
"title": "Success-Response:",
"content": "HTTP/1.1 200 OK\n{\n \"success\": true,\n \"message\": \"Note successfully deleted.\"\n}",
"type": "json"
}
]
},
"error": {
"examples": [
{
"title": "Error-Response:",
"content": "HTTP/1.1 403 Not Found\n{\n \"success\": false,\n \"message\": \"Access forbidden.\",\n \"errors\": []\n}",
"type": "json"
}
]
},
2018-11-14 17:16:00 +00:00
"parameter": {
2018-11-12 15:26:44 +00:00
"fields": {
2018-11-14 17:16:00 +00:00
"Parameter": [
2018-11-12 15:26:44 +00:00
{
2018-11-14 17:16:00 +00:00
"group": "Parameter",
"type": "String",
2018-11-12 15:26:44 +00:00
"optional": false,
2018-11-14 17:16:00 +00:00
"field": "id",
"description": "<p>Note unique ID.</p>"
2018-11-12 15:26:44 +00:00
}
]
}
},
"version": "0.0.0",
"filename": "app/routes/note/index.js",
"groupTitle": "Note"
},
{
"type": "get",
"url": "/note/:id",
2018-11-14 17:16:00 +00:00
"title": "Get note",
2018-11-12 15:26:44 +00:00
"name": "GetNotes",
"group": "Note",
"parameter": {
"fields": {
"Parameter": [
{
"group": "Parameter",
2018-11-14 17:16:00 +00:00
"type": "String",
2018-11-12 15:26:44 +00:00
"optional": false,
"field": "id",
2018-11-14 17:16:00 +00:00
"description": "<p>Note unique ID.</p>"
2018-11-12 15:26:44 +00:00
}
]
}
},
"success": {
"fields": {
"Success 200": [
{
"group": "Success 200",
"type": "string",
"optional": false,
"field": "title",
"description": "<p>Title of the note.</p>"
},
{
"group": "Success 200",
"type": "string",
"optional": false,
"field": "text",
"description": "<p>Text of the note.</p>"
}
]
}
},
"version": "0.0.0",
"filename": "app/routes/note/index.js",
"groupTitle": "Note"
},
2018-11-12 17:19:39 +00:00
{
2018-11-14 17:16:00 +00:00
"type": "put",
"url": "/note/:id",
"title": "Update note",
"name": "UpdateNote",
"group": "Note",
2018-11-12 17:19:39 +00:00
"parameter": {
"fields": {
"Parameter": [
{
"group": "Parameter",
"type": "String",
"optional": false,
2018-11-12 15:26:44 +00:00
"field": "id",
2018-11-14 17:16:00 +00:00
"description": "<p>Note unique ID.</p>"
2018-11-12 15:26:44 +00:00
}
]
}
},
"success": {
"fields": {
"Success 200": [
{
"group": "Success 200",
2018-11-15 18:28:51 +00:00
"type": "string",
"optional": false,
"field": "title",
"description": "<p>Title of the note.</p>"
},
{
"group": "Success 200",
"type": "string",
2018-11-12 15:26:44 +00:00
"optional": false,
2018-11-15 18:28:51 +00:00
"field": "text",
"description": "<p>Text of the note.</p>"
2018-11-12 15:26:44 +00:00
}
]
}
},
"version": "0.0.0",
2018-11-14 17:16:00 +00:00
"filename": "app/routes/note/index.js",
"groupTitle": "Note"
},
{
"type": "delete",
"url": "/user/me",
"title": "Delete account",
"name": "DeleteUser",
"group": "User",
"version": "0.0.0",
2018-11-12 15:26:44 +00:00
"filename": "app/routes/user/index.js",
"groupTitle": "User"
},
2018-11-12 17:19:39 +00:00
{
"type": "get",
"url": "/user/me",
2018-11-14 17:16:00 +00:00
"title": "Get user information",
2018-11-12 17:19:39 +00:00
"name": "GetUser",
"group": "User",
"success": {
"fields": {
"Success 200": [
{
"group": "Success 200",
"type": "String",
"optional": false,
"field": "firstname",
"description": "<p>Firstname of the User.</p>"
},
{
"group": "Success 200",
"type": "String",
"optional": false,
"field": "lastname",
"description": "<p>Lastname of the User.</p>"
},
{
"group": "Success 200",
"type": "String",
"optional": false,
2018-11-15 18:28:51 +00:00
"field": "email",
"description": "<p>Email of the User.</p>"
2018-11-12 17:19:39 +00:00
}
]
}
},
"version": "0.0.0",
"filename": "app/routes/user/index.js",
"groupTitle": "User"
},
{
"type": "put",
"url": "/user/me",
2018-11-14 17:16:00 +00:00
"title": "Update account information",
2018-11-12 17:19:39 +00:00
"name": "UpdateUser",
"group": "User",
2018-11-14 17:16:00 +00:00
"success": {
2018-11-12 17:19:39 +00:00
"fields": {
2018-11-14 17:16:00 +00:00
"Success 200": [
2018-11-12 17:19:39 +00:00
{
2018-11-14 17:16:00 +00:00
"group": "Success 200",
"type": "Object",
2018-11-12 17:19:39 +00:00
"optional": false,
2018-11-14 17:16:00 +00:00
"field": "user",
"description": "<p>User object.</p>"
2018-11-12 17:19:39 +00:00
}
]
}
},
"version": "0.0.0",
"filename": "app/routes/user/index.js",
"groupTitle": "User"
},
{
"type": "get",
"url": "/user/me/notes",
2018-11-14 17:16:00 +00:00
"title": "Get all notes",
"name": "GetNotesByUserId",
"group": "User_notes",
2018-11-12 17:19:39 +00:00
"success": {
"fields": {
"Success 200": [
{
"group": "Success 200",
2018-11-14 17:16:00 +00:00
"type": "Array",
2018-11-12 17:19:39 +00:00
"optional": false,
2018-11-14 17:16:00 +00:00
"field": "Array",
"description": "<p>Notes of the user.</p>"
2018-11-12 17:19:39 +00:00
}
]
}
},
"version": "0.0.0",
"filename": "app/routes/user/index.js",
2018-11-14 17:16:00 +00:00
"groupTitle": "User_notes"
2018-11-12 15:26:44 +00:00
}
] });