Fix and improve APIB docs and API tests (CC-82)

pull/51/head
HardiReady 2019-02-10 09:36:45 +01:00
parent 9de759805a
commit 1f176e0256
5 changed files with 44 additions and 1482 deletions

View File

@ -5,10 +5,13 @@ Update an army members signature image
**Permission: 4**
+ Parameters
+ userId: `5ab68d42f547ed304064e5f7` (string, required) - army members unique user id
+ Request (application/json)
{}
+ Attributes (object)
+ Response 200 (application/json; charset=utf-8)

View File

@ -1,8 +1,9 @@
### List Users [GET /users{?q,fractFilter,limit,offset}]
### List Users [GET /users{?q,fractFilter,squadId,decorationId,limit,offset}]
Get single army member information
+ Parameters
+ q: `hardi` (string, optional) - filter string which filters for partial username
+ fractFilter: `BLUFOR` (enum[string], optional) - Field to filter by fraction
@ -12,17 +13,15 @@ Get single army member information
+ `OPFOR`
+ `GLOBAL`
+ squadId: `591470249e9fae286e008e31` (string, optional) - Field to filter by membership of certain squad
+ squadId: `5aba54eaeadcce6332c6a774` (string, optional) - Field to filter by membership of certain squad
+ decorationId: `5abd3dff6e6a0334d95b8ba0` (string, optional) - Field to filter by ownership of certain decoration
+ limit: 20 (number, optional)
Maximum number of users to return
+ limit: 20 (number, optional) - Maximum number of users to return
+ Default: Infinity
+ offset: 0 (number, optional)
Offset into result-set (useful for pagination)
+ offset: 0 (number, optional) - Offset into result-set (useful for pagination)
+ Default: 0
@ -40,6 +39,7 @@ Get single army member information
Get single army member information
+ Parameters
+ id: `5ab68d42f547ed304064e5f7` (string, required) - unique id of army-member
+ Response 200 (application/json; charset=utf-8)

View File

@ -1,4 +1,5 @@
# Campaign (object)
Campaign entity
## Properties
@ -9,8 +10,10 @@ Campaign entity
+ __v: 0 (number, required) - version number
#WarCampaign (object)
Cmpaign entity with attached War collection
## Properties
+ _id: `5abd55ea9e30a76bfef747d6` (string, required) - unique id of the campaign
+ title: `Ein Kessel Buntes` (string, required) - display title of the campaign
+ wars (array[WarWithPlayers], requied)
+ wars: WarWithPlayers (array[WarWithPlayers], required)

View File

@ -16,56 +16,66 @@ FORMAT: 1A
# Group Access
## Endpoints [/auth]
:[Gists](auth/signup.apib)
:[Gists](auth/login.apib)
# Group Admin
## Account [/account]
:[Gists](admin/account.apib)
## Commands [/cmd]
:[Gists](admin/signature.apib)
# Group Army Overview
# Group Army Management
## Army [/overview]
:[Gists](army-management/army.apib)
# Group Awardings
## Awardings [/awarding]
:[Gists](army-management/awardings.apib)
# Group Campaigns
:[Gists](statistics/campaigns.apib)
# Group Decorations
## Decorations [/decorations]
:[Gists](army-management/decorations.apib)
# Group Logs
:[Gists](statistics/logs.apib)
# Group Players
:[Gists](statistics/players.apib)
# Group Promotion
## Promotion [/promotions]
:[Gists](army-management/promotions.apib)
# Group Ranks
## Ranks [/ranks]
:[Gists](army-management/ranks.apib)
# Group Squads
## Squads [/squads]
:[Gists](army-management/squads.apib)
# Group Users
## Users [/user]
:[Gists](army-management/users.apib)
# Group Wars
# Group Statistics
## Campaigns [/campaigns]
:[Gists](statistics/campaigns.apib)
## Logs [/logs]
:[Gists](statistics/logs.apib)
## Players [/players]
:[Gists](statistics/players.apib)
## Wars [/wars]
:[Gists](statistics/wars.apib)

File diff suppressed because it is too large Load Diff