| 12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460 |
- [
- {
- "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": "Authorization",
- "description": "<p>The valid JWT token provided by the {post} /users/login resource</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Authorization header example:",
- "content": "\"Authorization\": \"JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiNTVlNmU0ZTAwNTIzMGY0OTI3MWM3MDc4IiwiaWF0IjoxNDQxMTk1MjMyfQ.eWh9nuXVVSVDKKCmTMDoc9FBU55-KgkiOJH1hrdQRTQ\"",
- "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": "Authorization",
- "description": "<p>The valid JWT token provided by the {post} /users/login resource</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Authorization header example:",
- "content": "\"Authorization\": \"JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiNTVlNmU0ZTAwNTIzMGY0OTI3MWM3MDc4IiwiaWF0IjoxNDQxMTk1MjMyfQ.eWh9nuXVVSVDKKCmTMDoc9FBU55-KgkiOJH1hrdQRTQ\"",
- "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": "Authorization",
- "description": "<p>The valid JWT token provided by the {post} /users/login resource</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Authorization header example:",
- "content": "\"Authorization\": \"JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiNTVlNmU0ZTAwNTIzMGY0OTI3MWM3MDc4IiwiaWF0IjoxNDQxMTk1MjMyfQ.eWh9nuXVVSVDKKCmTMDoc9FBU55-KgkiOJH1hrdQRTQ\"",
- "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": "Authorization",
- "description": "<p>The valid JWT token provided by the {post} /users/login resource</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Authorization header example:",
- "content": "\"Authorization\": \"JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiNTVlNmU0ZTAwNTIzMGY0OTI3MWM3MDc4IiwiaWF0IjoxNDQxMTk1MjMyfQ.eWh9nuXVVSVDKKCmTMDoc9FBU55-KgkiOJH1hrdQRTQ\"",
- "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": "get",
- "url": "/accounts",
- "title": "List accounts",
- "version": "1.0.0",
- "name": "Retrieve_accounts",
- "group": "Accounts",
- "header": {
- "fields": {
- "Header": [
- {
- "group": "Header",
- "type": "String",
- "optional": false,
- "field": "Content-Type",
- "description": "<p>application/json</p> "
- },
- {
- "group": "Header",
- "type": "String",
- "optional": false,
- "field": "Authorization",
- "description": "<p>The valid JWT token provided by the {post} /users/login resource</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Authorization header example:",
- "content": "\"Authorization\": \"JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiNTVlNmU0ZTAwNTIzMGY0OTI3MWM3MDc4IiwiaWF0IjoxNDQxMTk1MjMyfQ.eWh9nuXVVSVDKKCmTMDoc9FBU55-KgkiOJH1hrdQRTQ\"",
- "type": "string"
- }
- ]
- },
- "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"
- }
- ]
- },
- "success": {
- "fields": {
- "200": [
- {
- "group": "200",
- "type": "<p>json</p> ",
- "optional": false,
- "field": "accounts",
- "description": "<p>List of all accounts and their (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": "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": "Authorization",
- "description": "<p>The valid JWT token provided by the {post} /users/login resource</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Authorization header example:",
- "content": "\"Authorization\": \"JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiNTVlNmU0ZTAwNTIzMGY0OTI3MWM3MDc4IiwiaWF0IjoxNDQxMTk1MjMyfQ.eWh9nuXVVSVDKKCmTMDoc9FBU55-KgkiOJH1hrdQRTQ\"",
- "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": "Authorization",
- "description": "<p>The valid JWT token provided by the {post} /users/login resource</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Authorization header example:",
- "content": "\"Authorization\": \"JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiNTVlNmU0ZTAwNTIzMGY0OTI3MWM3MDc4IiwiaWF0IjoxNDQxMTk1MjMyfQ.eWh9nuXVVSVDKKCmTMDoc9FBU55-KgkiOJH1hrdQRTQ\"",
- "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": "get",
- "url": "/accounts/:account_id/entries",
- "title": "List account entries",
- "version": "1.0.0",
- "name": "List_entries",
- "group": "Entries",
- "parameter": {
- "fields": {
- "Parameter": [
- {
- "group": "Parameter",
- "type": "<p>String</p> ",
- "optional": false,
- "field": "account_id",
- "description": "<p>The account id to retrieve</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": "Authorization",
- "description": "<p>The valid JWT token provided by the {post} /users/login resource</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Authorization header example:",
- "content": "\"Authorization\": \"JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiNTVlNmU0ZTAwNTIzMGY0OTI3MWM3MDc4IiwiaWF0IjoxNDQxMTk1MjMyfQ.eWh9nuXVVSVDKKCmTMDoc9FBU55-KgkiOJH1hrdQRTQ\"",
- "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>json</p> ",
- "optional": false,
- "field": "entries",
- "description": "<p>List of all account entries.</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Success-Response:",
- "content": "HTTP/1.1 200 OK\n [\n {\n _id: '',\n account_id: '1000',\n type: 'DEPOSIT'\n amount: 1000,\n date: 2015-09-03T10:04:11.481Z\n }\n ]",
- "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": "Authorization",
- "description": "<p>The valid JWT token provided by the {post} /users/login resource</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Authorization header example:",
- "content": "\"Authorization\": \"JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiNTVlNmU0ZTAwNTIzMGY0OTI3MWM3MDc4IiwiaWF0IjoxNDQxMTk1MjMyfQ.eWh9nuXVVSVDKKCmTMDoc9FBU55-KgkiOJH1hrdQRTQ\"",
- "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": "Authorization",
- "description": "<p>The valid JWT token provided by the {post} /users/login resource</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Authorization header example:",
- "content": "\"Authorization\": \"JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiNTVlNmU0ZTAwNTIzMGY0OTI3MWM3MDc4IiwiaWF0IjoxNDQxMTk1MjMyfQ.eWh9nuXVVSVDKKCmTMDoc9FBU55-KgkiOJH1hrdQRTQ\"",
- "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": "Authorization",
- "description": "<p>The valid JWT token provided by the {post} /users/login resource</p> "
- }
- ]
- },
- "examples": [
- {
- "title": "Authorization header example:",
- "content": "\"Authorization\": \"JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiNTVlNmU0ZTAwNTIzMGY0OTI3MWM3MDc4IiwiaWF0IjoxNDQxMTk1MjMyfQ.eWh9nuXVVSVDKKCmTMDoc9FBU55-KgkiOJH1hrdQRTQ\"",
- "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"
- }
- ]
|