| 1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279 |
- [
- {
- "type": "post",
- "url": "/accounts",
- "title": "Create account",
- "version": "1.0.0",
- "name": "Create_account",
- "group": "Accounts",
- "parameter": {
- "fields": {
- "Parameter": [
- {
- "group": "Parameter",
- "type": "<p>String</p> ",
- "optional": false,
- "field": "name",
- "description": "<p>Name for the new account</p> "
- },
- {
- "group": "Parameter",
- "type": "<p>String</p> ",
- "optional": false,
- "field": "reference",
- "description": "<p>A reference (bank account number) for the new account</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Request-Example: ",
- "content": "{\n name: 'Home',\n reference: '1234567890'\n}",
- "type": "json"
- }
- ]
- },
- "header": {
- "fields": {
- "Header": [
- {
- "group": "Header",
- "type": "String",
- "optional": false,
- "field": "Content-Type",
- "description": "<p>application/json</p> "
- },
- {
- "group": "Header",
- "type": "String",
- "optional": false,
- "field": "Authentication",
- "description": "<p>The valid JWT token provided by the {post} /users/login resource</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Authentication header example:",
- "content": "{ \n \"Authentication\": \"JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiNTVlNmU0ZTAwNTIzMGY0OTI3MWM3MDc4IiwiaWF0IjoxNDQxMTk1MjMyfQ.eWh9nuXVVSVDKKCmTMDoc9FBU55-KgkiOJH1hrdQRTQ\" \n }",
- "type": "string"
- }
- ]
- },
- "error": {
- "fields": {
- "400": [
- {
- "group": "400",
- "type": "<p>json</p> ",
- "optional": false,
- "field": "BadRequest",
- "description": "<p>The user can't be found.</p> "
- }
- ],
- "401": [
- {
- "group": "401",
- "type": "<p>json</p> ",
- "optional": false,
- "field": "AuthenticationFailed",
- "description": "<p>The user can't be found.</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "AuthenticationFailed:",
- "content": "HTTP/1.1 401 Not Found\n{\n \"message\": \"Authentication failed\"\n}",
- "type": "json"
- },
- {
- "title": "BadRequest:",
- "content": "HTTP/1.1 400 Bad Request\n [\n {\n \"field\": \"name\",\n \"rule\": \"required\",\n \"message\": \"Path `name` is required.\"\n }\n ]",
- "type": "json"
- }
- ]
- },
- "success": {
- "fields": {
- "201": [
- {
- "group": "201",
- "type": "<p>Object</p> ",
- "optional": false,
- "field": "account",
- "description": "<p>The new account with its (sub)categories.</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Success-Response:",
- "content": "HTTP/1.1 201 Created\n {\n \"name\": \"Home\",\n \"reference\": \"1234567890\",\n \"user_id\": \"55e6e4e005230f49271c7078\",\n \"_id\": \"55e8218912c65a1730c34858\",\n \"created_at\": \"2015-09-03T10:31:37.889Z\",\n \"categories\": [\n {\n \"key\": \"alimony_payments\",\n \"label\": \"Alimony Payments\",\n \"_id\": \"55e8218912c65a1730c34859\",\n \"sub_categories\": []\n },\n {\n \"key\": \"automobile_expenses\",\n \"label\": \"Automobile Expenses\",\n \"_id\": \"55e8218912c65a1730c3485a\",\n \"sub_categories\": [\n {\n \"label\": \"Car Payment\",\n \"key\": \"car_payment\",\n \"_id\": \"55e8218912c65a1730c3485d\"\n }\n ]\n }\n ]\n }",
- "type": "json"
- }
- ]
- },
- "filename": "app/routes/accounts.js",
- "groupTitle": "Accounts"
- },
- {
- "type": "delete",
- "url": "/accounts/:account_id",
- "title": "Delete account",
- "version": "1.0.0",
- "name": "Delete_account",
- "group": "Accounts",
- "parameter": {
- "fields": {
- "Parameter": [
- {
- "group": "Parameter",
- "type": "<p>String</p> ",
- "optional": false,
- "field": "account_id",
- "description": "<p>The account to delete</p> "
- }
- ]
- }
- },
- "header": {
- "fields": {
- "Header": [
- {
- "group": "Header",
- "type": "String",
- "optional": false,
- "field": "Authentication",
- "description": "<p>The valid JWT token provided by the {post} /users/login resource</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Authentication header example:",
- "content": "{ \n \"Authentication\": \"JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiNTVlNmU0ZTAwNTIzMGY0OTI3MWM3MDc4IiwiaWF0IjoxNDQxMTk1MjMyfQ.eWh9nuXVVSVDKKCmTMDoc9FBU55-KgkiOJH1hrdQRTQ\" \n }",
- "type": "string"
- }
- ]
- },
- "error": {
- "fields": {
- "401": [
- {
- "group": "401",
- "type": "<p>json</p> ",
- "optional": false,
- "field": "AuthenticationFailed",
- "description": "<p>The user can't be found.</p> "
- }
- ],
- "404": [
- {
- "group": "404",
- "type": "<p>json</p> ",
- "optional": false,
- "field": "AccountNotFound",
- "description": "<p>The account can't be found.</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "AuthenticationFailed:",
- "content": "HTTP/1.1 401 Not Found\n{\n \"message\": \"Authentication failed\"\n}",
- "type": "json"
- },
- {
- "title": "AccountNotFound:",
- "content": "HTTP/1.1 404 Not Found\n {\n \"message\": \"Unknown account\"\n }",
- "type": "json"
- }
- ]
- },
- "success": {
- "fields": {
- "204": [
- {
- "group": "204",
- "optional": false,
- "field": "-",
- "description": ""
- }
- ]
- },
- "examples": [
- {
- "title": "Success-Response:",
- "content": "HTTP/1.1 204 No Content",
- "type": "json"
- }
- ]
- },
- "filename": "app/routes/accounts.js",
- "groupTitle": "Accounts"
- },
- {
- "type": "get",
- "url": "/accounts/:account_id",
- "title": "Get account",
- "version": "1.0.0",
- "name": "Get_account",
- "group": "Accounts",
- "parameter": {
- "fields": {
- "Parameter": [
- {
- "group": "Parameter",
- "type": "<p>String</p> ",
- "optional": false,
- "field": "account_id",
- "description": "<p>The given account</p> "
- }
- ]
- }
- },
- "header": {
- "fields": {
- "Header": [
- {
- "group": "Header",
- "type": "String",
- "optional": false,
- "field": "Content-Type",
- "description": "<p>application/json</p> "
- },
- {
- "group": "Header",
- "type": "String",
- "optional": false,
- "field": "Authentication",
- "description": "<p>The valid JWT token provided by the {post} /users/login resource</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Authentication header example:",
- "content": "{ \n \"Authentication\": \"JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiNTVlNmU0ZTAwNTIzMGY0OTI3MWM3MDc4IiwiaWF0IjoxNDQxMTk1MjMyfQ.eWh9nuXVVSVDKKCmTMDoc9FBU55-KgkiOJH1hrdQRTQ\" \n }",
- "type": "string"
- }
- ]
- },
- "error": {
- "fields": {
- "401": [
- {
- "group": "401",
- "type": "<p>json</p> ",
- "optional": false,
- "field": "AuthenticationFailed",
- "description": "<p>The user can't be found.</p> "
- }
- ],
- "404": [
- {
- "group": "404",
- "type": "<p>json</p> ",
- "optional": false,
- "field": "AccountNotFound",
- "description": "<p>The account can't be found.</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "AuthenticationFailed:",
- "content": "HTTP/1.1 401 Not Found\n{\n \"message\": \"Authentication failed\"\n}",
- "type": "json"
- },
- {
- "title": "AccountNotFound:",
- "content": "HTTP/1.1 404 Not Found\n {\n \"message\": \"Unknown account\"\n }",
- "type": "json"
- }
- ]
- },
- "success": {
- "fields": {
- "200": [
- {
- "group": "200",
- "type": "<p>Object</p> ",
- "optional": false,
- "field": "account",
- "description": "<p>The account with its (sub)categories.</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Success-Response:",
- "content": "HTTP/1.1 200 OK\n {\n \"name\": \"Home\",\n \"reference\": \"1234567890\",\n \"user_id\": \"55e6e4e005230f49271c7078\",\n \"_id\": \"55e8218912c65a1730c34858\",\n \"created_at\": \"2015-09-03T10:31:37.889Z\",\n \"categories\": [\n {\n \"key\": \"alimony_payments\",\n \"label\": \"Alimony Payments\",\n \"_id\": \"55e8218912c65a1730c34859\",\n \"sub_categories\": []\n },\n {\n \"key\": \"automobile_expenses\",\n \"label\": \"Automobile Expenses\",\n \"_id\": \"55e8218912c65a1730c3485a\",\n \"sub_categories\": [\n {\n \"label\": \"Car Payment\",\n \"key\": \"car_payment\",\n \"_id\": \"55e8218912c65a1730c3485d\"\n }\n ]\n }\n ]\n }",
- "type": "json"
- }
- ]
- },
- "filename": "app/routes/accounts.js",
- "groupTitle": "Accounts"
- },
- {
- "type": "put",
- "url": "/accounts/:account_id",
- "title": "Modify account",
- "version": "1.0.0",
- "name": "Modify_account",
- "group": "Accounts",
- "parameter": {
- "fields": {
- "Parameter": [
- {
- "group": "Parameter",
- "type": "<p>String</p> ",
- "optional": false,
- "field": "account_id",
- "description": "<p>The account id to modify</p> "
- },
- {
- "group": "Parameter",
- "type": "<p>String</p> ",
- "optional": false,
- "field": "name",
- "description": "<p>Name for the new account</p> "
- },
- {
- "group": "Parameter",
- "type": "<p>String</p> ",
- "optional": false,
- "field": "reference",
- "description": "<p>A reference (bank account number) for the new account</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Request-Example: ",
- "content": "{\n name: 'Home',\n reference: '1234567890'\n}",
- "type": "json"
- }
- ]
- },
- "header": {
- "fields": {
- "Header": [
- {
- "group": "Header",
- "type": "String",
- "optional": false,
- "field": "Content-Type",
- "description": "<p>application/json</p> "
- },
- {
- "group": "Header",
- "type": "String",
- "optional": false,
- "field": "Authentication",
- "description": "<p>The valid JWT token provided by the {post} /users/login resource</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Authentication header example:",
- "content": "{ \n \"Authentication\": \"JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiNTVlNmU0ZTAwNTIzMGY0OTI3MWM3MDc4IiwiaWF0IjoxNDQxMTk1MjMyfQ.eWh9nuXVVSVDKKCmTMDoc9FBU55-KgkiOJH1hrdQRTQ\" \n }",
- "type": "string"
- }
- ]
- },
- "error": {
- "fields": {
- "400": [
- {
- "group": "400",
- "type": "<p>json</p> ",
- "optional": false,
- "field": "BadRequest",
- "description": "<p>The user can't be found.</p> "
- }
- ],
- "401": [
- {
- "group": "401",
- "type": "<p>json</p> ",
- "optional": false,
- "field": "AuthenticationFailed",
- "description": "<p>The user can't be found.</p> "
- }
- ],
- "404": [
- {
- "group": "404",
- "type": "<p>json</p> ",
- "optional": false,
- "field": "AccountNotFound",
- "description": "<p>The account can't be found.</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "AuthenticationFailed:",
- "content": "HTTP/1.1 401 Not Found\n{\n \"message\": \"Authentication failed\"\n}",
- "type": "json"
- },
- {
- "title": "BadRequest:",
- "content": "HTTP/1.1 400 Bad Request\n [\n {\n \"field\": \"name\",\n \"rule\": \"required\",\n \"message\": \"Path `name` is required.\"\n }\n ]",
- "type": "json"
- },
- {
- "title": "AccountNotFound:",
- "content": "HTTP/1.1 404 Not Found\n {\n \"message\": \"Unknown account\"\n }",
- "type": "json"
- }
- ]
- },
- "success": {
- "fields": {
- "Success 200": [
- {
- "group": "Success 200",
- "type": "<p>String</p> ",
- "optional": false,
- "field": "username",
- "description": "<p>Username of the User.</p> "
- },
- {
- "group": "Success 200",
- "type": "<p>String</p> ",
- "optional": false,
- "field": "token",
- "description": "<p>The JWT valid token.</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Success-Response:",
- "content": "HTTP/1.1 200 OK\n {\n \"name\": \"Home\",\n \"reference\": \"1234567890\",\n \"user_id\": \"55e6e4e005230f49271c7078\",\n \"_id\": \"55e8218912c65a1730c34858\",\n \"created_at\": \"2015-09-03T10:31:37.889Z\",\n \"categories\": [\n {\n \"key\": \"alimony_payments\",\n \"label\": \"Alimony Payments\",\n \"_id\": \"55e8218912c65a1730c34859\",\n \"sub_categories\": []\n },\n {\n \"key\": \"automobile_expenses\",\n \"label\": \"Automobile Expenses\",\n \"_id\": \"55e8218912c65a1730c3485a\",\n \"sub_categories\": [\n {\n \"label\": \"Car Payment\",\n \"key\": \"car_payment\",\n \"_id\": \"55e8218912c65a1730c3485d\"\n }\n ]\n }\n ]\n }",
- "type": "json"
- }
- ]
- },
- "filename": "app/routes/accounts.js",
- "groupTitle": "Accounts"
- },
- {
- "type": "post",
- "url": "/accounts/:account_id/entries",
- "title": "Create entry",
- "version": "1.0.0",
- "name": "Create_entry",
- "group": "Entries",
- "parameter": {
- "fields": {
- "Parameter": [
- {
- "group": "Parameter",
- "type": "<p>String</p> ",
- "optional": false,
- "field": "account_id",
- "description": "<p>The account id to populate</p> "
- },
- {
- "group": "Parameter",
- "type": "<p>String</p> ",
- "optional": false,
- "field": "amount",
- "description": "<p>Amount of the entry</p> "
- },
- {
- "group": "Parameter",
- "type": "<p>String</p> ",
- "optional": false,
- "field": "date",
- "description": "<p>Date of the bill/deposit</p> "
- },
- {
- "group": "Parameter",
- "type": "<p>String</p> ",
- "optional": true,
- "field": "category",
- "description": "<p>Category id of the bill/deposit</p> "
- },
- {
- "group": "Parameter",
- "type": "<p>String</p> ",
- "optional": true,
- "field": "sub_category",
- "description": "<p>Sub category id of the bill/deposit</p> "
- },
- {
- "group": "Parameter",
- "type": "<p>String</p> ",
- "optional": true,
- "field": "label",
- "description": "<p>A label for the entry</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Request-Example: ",
- "content": "{\n amount: 1000,\n date: 2015-09-03T10:04:11.481Z\n}",
- "type": "json"
- }
- ]
- },
- "header": {
- "fields": {
- "Header": [
- {
- "group": "Header",
- "type": "String",
- "optional": false,
- "field": "Content-Type",
- "description": "<p>application/json</p> "
- },
- {
- "group": "Header",
- "type": "String",
- "optional": false,
- "field": "Authentication",
- "description": "<p>The valid JWT token provided by the {post} /users/login resource</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Authentication header example:",
- "content": "{ \n \"Authentication\": \"JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiNTVlNmU0ZTAwNTIzMGY0OTI3MWM3MDc4IiwiaWF0IjoxNDQxMTk1MjMyfQ.eWh9nuXVVSVDKKCmTMDoc9FBU55-KgkiOJH1hrdQRTQ\" \n }",
- "type": "string"
- }
- ]
- },
- "error": {
- "fields": {
- "400": [
- {
- "group": "400",
- "type": "<p>json</p> ",
- "optional": false,
- "field": "BadRequest",
- "description": "<p>The user can't be found.</p> "
- }
- ],
- "401": [
- {
- "group": "401",
- "type": "<p>json</p> ",
- "optional": false,
- "field": "AuthenticationFailed",
- "description": "<p>The user can't be found.</p> "
- }
- ],
- "404": [
- {
- "group": "404",
- "type": "<p>json</p> ",
- "optional": false,
- "field": "AccountNotFound",
- "description": "<p>The account can't be found.</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "AuthenticationFailed:",
- "content": "HTTP/1.1 401 Not Found\n{\n \"message\": \"Authentication failed\"\n}",
- "type": "json"
- },
- {
- "title": "BadRequest:",
- "content": "HTTP/1.1 400 Bad Request\n [\n {\n \"field\": \"amount\",\n \"rule\": \"required\",\n \"message\": \"Path `amount` is required.\"\n }\n ]",
- "type": "json"
- },
- {
- "title": "AccountNotFound:",
- "content": "HTTP/1.1 404 Not Found\n {\n \"message\": \"Unknown account\"\n }",
- "type": "json"
- }
- ]
- },
- "success": {
- "fields": {
- "201": [
- {
- "group": "201",
- "type": "<p>Object</p> ",
- "optional": false,
- "field": "entry",
- "description": "<p>The created entry.</p> "
- },
- {
- "group": "201",
- "type": "<p>Object[]</p> ",
- "optional": false,
- "field": "entries",
- "description": "<p>All account's entries</p> "
- },
- {
- "group": "201",
- "type": "<p>Number</p> ",
- "optional": false,
- "field": "balance",
- "description": "<p>The account's total balance</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Success-Response:",
- "content": " HTTP/1.1 201 Created\n{\n entry: {\n _id: '',\n account_id: '1000',\n type: 'DEPOSIT'\n amount: 1000,\n date: 2015-09-03T10:04:11.481Z\n },\n entries: [\n {\n _id: '',\n account_id: '1000',\n type: 'DEPOSIT'\n amount: 1000,\n date: 2015-09-03T10:04:11.481Z\n }\n ],\n balance: 1000\n}",
- "type": "json"
- }
- ]
- },
- "filename": "app/routes/accounts.js",
- "groupTitle": "Entries"
- },
- {
- "type": "delete",
- "url": "/accounts/:account_id/entries/:entry_id",
- "title": "Delete entry",
- "version": "1.0.0",
- "name": "Delete_entry",
- "group": "Entries",
- "parameter": {
- "fields": {
- "Parameter": [
- {
- "group": "Parameter",
- "type": "<p>String</p> ",
- "optional": false,
- "field": "account_id",
- "description": "<p>The owner account</p> "
- },
- {
- "group": "Parameter",
- "type": "<p>String</p> ",
- "optional": false,
- "field": "entry_id",
- "description": "<p>The entry to delete</p> "
- }
- ]
- }
- },
- "header": {
- "fields": {
- "Header": [
- {
- "group": "Header",
- "type": "String",
- "optional": false,
- "field": "Authentication",
- "description": "<p>The valid JWT token provided by the {post} /users/login resource</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Authentication header example:",
- "content": "{ \n \"Authentication\": \"JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiNTVlNmU0ZTAwNTIzMGY0OTI3MWM3MDc4IiwiaWF0IjoxNDQxMTk1MjMyfQ.eWh9nuXVVSVDKKCmTMDoc9FBU55-KgkiOJH1hrdQRTQ\" \n }",
- "type": "string"
- }
- ]
- },
- "error": {
- "fields": {
- "401": [
- {
- "group": "401",
- "type": "<p>json</p> ",
- "optional": false,
- "field": "AuthenticationFailed",
- "description": "<p>The user can't be found.</p> "
- }
- ],
- "404": [
- {
- "group": "404",
- "type": "<p>json</p> ",
- "optional": false,
- "field": "AccountNotFound",
- "description": "<p>The account can't be found.</p> "
- },
- {
- "group": "404",
- "type": "<p>json</p> ",
- "optional": false,
- "field": "EntryNotFound",
- "description": "<p>The entry can't be found.</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "AuthenticationFailed:",
- "content": "HTTP/1.1 401 Not Found\n{\n \"message\": \"Authentication failed\"\n}",
- "type": "json"
- },
- {
- "title": "AccountNotFound:",
- "content": "HTTP/1.1 404 Not Found\n {\n \"message\": \"Unknown account\"\n }",
- "type": "json"
- },
- {
- "title": "AccountNotFound:",
- "content": "HTTP/1.1 404 Not Found",
- "type": "json"
- }
- ]
- },
- "success": {
- "fields": {
- "204": [
- {
- "group": "204",
- "optional": false,
- "field": "-",
- "description": ""
- }
- ]
- },
- "examples": [
- {
- "title": "Success-Response:",
- "content": "HTTP/1.1 204 No Content",
- "type": "json"
- }
- ]
- },
- "filename": "app/routes/accounts.js",
- "groupTitle": "Entries"
- },
- {
- "type": "post",
- "url": "/accounts/:account_id/entries/:entry_id",
- "title": "Modify entry",
- "version": "1.0.0",
- "name": "Modify_entry",
- "group": "Entries",
- "parameter": {
- "fields": {
- "Parameter": [
- {
- "group": "Parameter",
- "type": "<p>String</p> ",
- "optional": false,
- "field": "account_id",
- "description": "<p>The owner account</p> "
- },
- {
- "group": "Parameter",
- "type": "<p>String</p> ",
- "optional": false,
- "field": "entry_id",
- "description": "<p>The entry to modify</p> "
- },
- {
- "group": "Parameter",
- "type": "<p>String</p> ",
- "optional": false,
- "field": "amount",
- "description": "<p>Amount of the entry</p> "
- },
- {
- "group": "Parameter",
- "type": "<p>String</p> ",
- "optional": false,
- "field": "date",
- "description": "<p>Date of the bill/deposit</p> "
- },
- {
- "group": "Parameter",
- "type": "<p>String</p> ",
- "optional": true,
- "field": "category",
- "description": "<p>Category id of the bill/deposit</p> "
- },
- {
- "group": "Parameter",
- "type": "<p>String</p> ",
- "optional": true,
- "field": "sub_category",
- "description": "<p>Sub category id of the bill/deposit</p> "
- },
- {
- "group": "Parameter",
- "type": "<p>String</p> ",
- "optional": true,
- "field": "label",
- "description": "<p>A label for the entry</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Request-Example: ",
- "content": "{\n amount: 1000,\n date: 2015-09-03T10:04:11.481Z\n}",
- "type": "json"
- }
- ]
- },
- "header": {
- "fields": {
- "Header": [
- {
- "group": "Header",
- "type": "String",
- "optional": false,
- "field": "Content-Type",
- "description": "<p>application/json</p> "
- },
- {
- "group": "Header",
- "type": "String",
- "optional": false,
- "field": "Authentication",
- "description": "<p>The valid JWT token provided by the {post} /users/login resource</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Authentication header example:",
- "content": "{ \n \"Authentication\": \"JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiNTVlNmU0ZTAwNTIzMGY0OTI3MWM3MDc4IiwiaWF0IjoxNDQxMTk1MjMyfQ.eWh9nuXVVSVDKKCmTMDoc9FBU55-KgkiOJH1hrdQRTQ\" \n }",
- "type": "string"
- }
- ]
- },
- "error": {
- "fields": {
- "400": [
- {
- "group": "400",
- "type": "<p>json</p> ",
- "optional": false,
- "field": "BadRequest",
- "description": "<p>The user can't be found.</p> "
- }
- ],
- "401": [
- {
- "group": "401",
- "type": "<p>json</p> ",
- "optional": false,
- "field": "AuthenticationFailed",
- "description": "<p>The user can't be found.</p> "
- }
- ],
- "404": [
- {
- "group": "404",
- "type": "<p>json</p> ",
- "optional": false,
- "field": "AccountNotFound",
- "description": "<p>The account can't be found.</p> "
- },
- {
- "group": "404",
- "type": "<p>json</p> ",
- "optional": false,
- "field": "EntryNotFound",
- "description": "<p>The entry can't be found.</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "AuthenticationFailed:",
- "content": "HTTP/1.1 401 Not Found\n{\n \"message\": \"Authentication failed\"\n}",
- "type": "json"
- },
- {
- "title": "BadRequest:",
- "content": "HTTP/1.1 400 Bad Request\n [\n {\n \"field\": \"amount\",\n \"rule\": \"required\",\n \"message\": \"Path `amount` is required.\"\n }\n ]",
- "type": "json"
- },
- {
- "title": "AccountNotFound:",
- "content": "HTTP/1.1 404 Not Found\n {\n \"message\": \"Unknown account\"\n }",
- "type": "json"
- },
- {
- "title": "AccountNotFound:",
- "content": "HTTP/1.1 404 Not Found",
- "type": "json"
- }
- ]
- },
- "success": {
- "fields": {
- "200": [
- {
- "group": "200",
- "type": "<p>Object</p> ",
- "optional": false,
- "field": "entry",
- "description": "<p>The created entry.</p> "
- },
- {
- "group": "200",
- "type": "<p>Object[]</p> ",
- "optional": false,
- "field": "entries",
- "description": "<p>All account's entries</p> "
- },
- {
- "group": "200",
- "type": "<p>Number</p> ",
- "optional": false,
- "field": "balance",
- "description": "<p>The account's total balance</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Success-Response:",
- "content": " HTTP/1.1 200 OK\n{\n entry: {\n _id: '',\n account_id: '1000',\n type: 'DEPOSIT'\n amount: 1000,\n date: 2015-09-03T10:04:11.481Z\n },\n entries: [\n {\n _id: '',\n account_id: '1000',\n type: 'DEPOSIT'\n amount: 1000,\n date: 2015-09-03T10:04:11.481Z\n }\n ],\n balance: 1000\n}",
- "type": "json"
- }
- ]
- },
- "filename": "app/routes/accounts.js",
- "groupTitle": "Entries"
- },
- {
- "type": "post",
- "url": "/users/login",
- "title": "Login",
- "version": "1.0.0",
- "name": "Login",
- "group": "Users",
- "header": {
- "fields": {
- "Header": [
- {
- "group": "Header",
- "type": "String",
- "optional": false,
- "field": "Content-Type",
- "description": "<p>application/json</p> "
- }
- ]
- }
- },
- "parameter": {
- "fields": {
- "Parameter": [
- {
- "group": "Parameter",
- "type": "<p>String</p> ",
- "optional": false,
- "field": "username",
- "description": "<p>User's username</p> "
- },
- {
- "group": "Parameter",
- "type": "<p>String</p> ",
- "optional": false,
- "field": "password",
- "description": "<p>User's password</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Request-Example: ",
- "content": "{ \n \"username\": \"John\", \n \"password\": \"s3cr3t\" \n}",
- "type": "json"
- }
- ]
- },
- "success": {
- "fields": {
- "Success 200": [
- {
- "group": "Success 200",
- "type": "<p>String</p> ",
- "optional": false,
- "field": "username",
- "description": "<p>Username of the User.</p> "
- },
- {
- "group": "Success 200",
- "type": "<p>String</p> ",
- "optional": false,
- "field": "token",
- "description": "<p>The JWT valid token.</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Success-Response:",
- "content": "HTTP/1.1 200 OK\n{\n \"username\": \"John\",\n \"token\": \"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiNTVlNmU0ZTAwNTIzMGY0OTI3MWM3MDc4IiwiaWF0IjoxNDQxMTk1MjMyfQ.eWh9nuXVVSVDKKCmTMDoc9FBU55-KgkiOJH1hrdQRTQ\"\n}",
- "type": "json"
- }
- ]
- },
- "error": {
- "fields": {
- "401": [
- {
- "group": "401",
- "type": "<p>json</p> ",
- "optional": false,
- "field": "AuthenticationFailed",
- "description": "<p>The user can't be found.</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "AuthenticationFailed:",
- "content": "HTTP/1.1 401 Not Found\n{\n \"message\": \"Authentication failed\"\n}",
- "type": "json"
- }
- ]
- },
- "filename": "app/routes/users.js",
- "groupTitle": "Users"
- },
- {
- "type": "delete",
- "url": "/users/login",
- "title": "Logout",
- "version": "1.0.0",
- "name": "Logout",
- "group": "Users",
- "header": {
- "fields": {
- "Header": [
- {
- "group": "Header",
- "type": "String",
- "optional": false,
- "field": "Authentication",
- "description": "<p>The valid JWT token provided by the {post} /users/login resource</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Authentication header example:",
- "content": "{ \n \"Authentication\": \"JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiNTVlNmU0ZTAwNTIzMGY0OTI3MWM3MDc4IiwiaWF0IjoxNDQxMTk1MjMyfQ.eWh9nuXVVSVDKKCmTMDoc9FBU55-KgkiOJH1hrdQRTQ\" \n }",
- "type": "string"
- }
- ]
- },
- "success": {
- "examples": [
- {
- "title": "Success-Response:",
- "content": "HTTP/1.1 200 OK",
- "type": "json"
- }
- ]
- },
- "filename": "app/routes/users.js",
- "groupTitle": "Users"
- },
- {
- "type": "post",
- "url": "/users",
- "title": "Registration",
- "version": "1.0.0",
- "name": "Registration",
- "group": "Users",
- "header": {
- "fields": {
- "Header": [
- {
- "group": "Header",
- "type": "String",
- "optional": false,
- "field": "Content-Type",
- "description": "<p>application/json</p> "
- }
- ]
- }
- },
- "parameter": {
- "fields": {
- "Parameter": [
- {
- "group": "Parameter",
- "type": "<p>String</p> ",
- "optional": false,
- "field": "username",
- "description": "<p>User's username</p> "
- },
- {
- "group": "Parameter",
- "type": "<p>String</p> ",
- "optional": false,
- "field": "password",
- "description": "<p>User's password</p> "
- },
- {
- "group": "Parameter",
- "type": "<p>String</p> ",
- "optional": true,
- "field": "language",
- "defaultValue": "en",
- "description": "<p>User's default language</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Request-Example: ",
- "content": "{ \n \"username\": \"John\", \n \"password\": \"s3cr3t\",\n \"language\": \"en\"\n}",
- "type": "json"
- }
- ]
- },
- "success": {
- "fields": {
- "201": [
- {
- "group": "201",
- "type": "<p>String</p> ",
- "optional": false,
- "field": "username",
- "description": "<p>Username of the User.</p> "
- },
- {
- "group": "201",
- "type": "<p>String</p> ",
- "optional": false,
- "field": "token",
- "description": "<p>The JWT valid token.</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Success-Response:",
- "content": "HTTP/1.1 201 OK\n{\n \"username\": \"John\",\n \"token\": \"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiNTVlNmU0ZTAwNTIzMGY0OTI3MWM3MDc4IiwiaWF0IjoxNDQxMTk1MjMyfQ.eWh9nuXVVSVDKKCmTMDoc9FBU55-KgkiOJH1hrdQRTQ\"\n}",
- "type": "json"
- }
- ]
- },
- "error": {
- "fields": {
- "400": [
- {
- "group": "400",
- "type": "<p>json</p> ",
- "optional": false,
- "field": "BadRequest",
- "description": "<p>Validation errors.</p> "
- }
- ],
- "409": [
- {
- "group": "409",
- "type": "<p>json</p> ",
- "optional": false,
- "field": "UserAlreadyExist",
- "description": "<p>The user can't be found.</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "UserAlreadyExist:",
- "content": "HTTP/1.1 409 Not Found\n{\n \"message\": \"Account already exists\"\n}",
- "type": "json"
- },
- {
- "title": "BadRequest:",
- "content": "HTTP/1.1 400 Bad Request\n[\n {\n \"field\": \"password\",\n \"rule\": \"required\",\n \"message\": \"Path `password` is required.\"\n },\n {\n \"field\": \"username\",\n \"rule\": \"required\",\n \"message\": \"Path `username` is required.\"\n }\n ]",
- "type": "json"
- }
- ]
- },
- "filename": "app/routes/users.js",
- "groupTitle": "Users"
- },
- {
- "type": "delete",
- "url": "/users",
- "title": "Unregistration",
- "version": "1.0.0",
- "name": "Unregistration",
- "group": "Users",
- "header": {
- "fields": {
- "Header": [
- {
- "group": "Header",
- "type": "String",
- "optional": false,
- "field": "Content-Type",
- "description": "<p>application/json</p> "
- },
- {
- "group": "Header",
- "type": "String",
- "optional": false,
- "field": "Authentication",
- "description": "<p>The valid JWT token provided by the {post} /users/login resource</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Authentication header example:",
- "content": "{ \n \"Authentication\": \"JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiNTVlNmU0ZTAwNTIzMGY0OTI3MWM3MDc4IiwiaWF0IjoxNDQxMTk1MjMyfQ.eWh9nuXVVSVDKKCmTMDoc9FBU55-KgkiOJH1hrdQRTQ\" \n }",
- "type": "string"
- }
- ]
- },
- "success": {
- "fields": {
- "204": [
- {
- "group": "204",
- "optional": false,
- "field": "-",
- "description": ""
- }
- ]
- },
- "examples": [
- {
- "title": "Success-Response:",
- "content": "HTTP/1.1 204 No Content",
- "type": "json"
- }
- ]
- },
- "error": {
- "fields": {
- "401": [
- {
- "group": "401",
- "type": "<p>json</p> ",
- "optional": false,
- "field": "AuthenticationFailed",
- "description": "<p>The user can't be found.</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "AuthenticationFailed:",
- "content": "HTTP/1.1 401 Not Found\n{\n \"message\": \"Authentication failed\"\n}",
- "type": "json"
- }
- ]
- },
- "filename": "app/routes/users.js",
- "groupTitle": "Users"
- }
- ]
|