📚🚧 working on endpoints

This commit is contained in:
EntireTwix 2021-07-05 00:49:14 -07:00
parent 9a62f9e7ed
commit f0772ed6f0

View file

@ -1,19 +1,19 @@
# API endpoints # API endpoints
## KEY ## KEY
`Jresp` - Json Response, json must be accepted in the `Accept` header, be that via `application/json` or `*/*`, failing to do so results in `406` `Jresp` - Json Response, json must be accepted in the `Accept` header, be that via `application/json` or `*/*`, failing to do so results in error `406`
`Jreq` - Json Request, requires `application/json` as `content-type`, failing to do so results in `406` `Jreq` - Json Request, requires `application/json` as `content-type`, failing to do so results in error `406`
`A` - Admin, requires [basic auth](https://en.wikipedia.org/wiki/Basic_access_authentication) in the header `Authorization`. This credential must be both a valid user and have a username of that of the admin account, failing to do so results in `401` `A` - Admin, requires [basic auth](https://en.wikipedia.org/wiki/Basic_access_authentication) in the header `Authorization`. This credential must be both a valid user and have a username of that of the admin account, failing to do so results in error `401`
`U` - User, requires [basic auth](https://en.wikipedia.org/wiki/Basic_access_authentication) in the header `Authorization`. This credential must be a valid user, failing to do so results in `401` `U` - User, requires [basic auth](https://en.wikipedia.org/wiki/Basic_access_authentication) in the header `Authorization`. This credential must be a valid user, failing to do so results in error `401`
:heavy_check_mark: :heavy_check_mark:
:heavy_multiplication_x: :heavy_multiplication_x:
### Usage endpoints ### Usage endpoints
| name | purpose | json input | path | HTTP Method | Jresp | Jreq | A | U | return type | return value | v1 | | name | purpose | json input | path | HTTP Method | return type | return value | Jresp | Jreq | A | U | v1 |
| :----- | -------------------------------------- | ---------- | --------------------------------- | :---------: | :----------------: | :----------------------: | :----------------------: | :----------------------: | :---------: | ------------------ | :----------------: | | :----- | -------------------------------------- | ---------- | --------------------------------- | :---------: | :---------: | :----------------: | :----------------: | :----------------------: | :----------------------: | :----------------------: | :----------------: |
| GetBal | retrieving the balance of a given user | `N/A` | `api/v1/user/balance?name={name}` | `GET` | :heavy_check_mark: | :heavy_multiplication_x: | :heavy_multiplication_x: | :heavy_multiplication_x: | JSON uint32 | the user's balance | :heavy_check_mark: | | GetBal | retrieving the balance of a given user | `N/A` | `api/v1/user/balance?name={name}` | `GET` | JSON uint32 | the user's balance | :heavy_check_mark: | :heavy_multiplication_x: | :heavy_multiplication_x: | :heavy_multiplication_x: | :heavy_check_mark: |