mirror of
https://github.com/Expand-sys/CCash
synced 2025-12-17 08:32:13 +11:00
25 lines
No EOL
1.7 KiB
Markdown
25 lines
No EOL
1.7 KiB
Markdown
# API endpoints
|
|
|
|
## KEY
|
|
`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 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 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 error `401`
|
|
|
|
|
|
:heavy_check_mark:
|
|
:heavy_multiplication_x:
|
|
|
|
### Usage endpoints
|
|
| name | purpose | json input | path | HTTP Method | return type | return value | Jresp | Jreq | A | U |
|
|
| :----- | ------------------------------------------------ | ---------- | --------------------------------- | :---------: | :---------: | :----------------: | :----------------: | :----------------------: | :----------------------: | :----------------------: |
|
|
| GetBal | retrieving the balance of a given user, `{name}` | `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: |
|
|
|
|
### Usage endpoints support
|
|
`v` denoting the API version
|
|
| name | v1 |
|
|
| :----- | :----------------: |
|
|
| GetBal | :heavy_check_mark: | |