API routes (Click a route to expand it, click here to expand/collapse all)
Provides the API-specification. Only enabled if API exposure is enabled.
| Parameter |
Location |
Type |
Requirements |
Optional |
Default value |
Description |
| format |
URI-Query |
string |
enum: [
"KateAPI",
"InternalAPIMap",
"OpenAPI",
"Swagger"
] |
Yes |
"KateAPI" |
Documentation format. We support KateAPI documentation, Swagger/OpenAPI documentation and raw output of the internal API-map cache. |
| openApiVersion |
URI-Query |
int |
enum: [
2,
3
] |
Yes |
2 |
Version 3 is crappy with request bodies, so we prefer version 2 (which only sucks regarding Response definitions; hence we prefer KateAPI documentation). |
| Response |
HTTP |
Type |
Description |
| Success |
200 |
object |
The API-documentation. |
| MissingRequiredParameterException |
400 |
|
The request is missing a required input parameter. See details for involved parameter. |
| InvalidParameterException |
400 |
|
The request has an invalid argument. See details for involved parameter and invalidation. |
| AuthenticationFailedException |
401 |
|
Authentication failed. Re-authenticate and retry. See error details for details. |
| UnauthorizedException |
403 |
|
Authorization for requested method rejected. See error details for details. |
Authentication required:
No
POST/sync ⎘Authentication required
Sync valuations from Flux to Kate. Recommended to call this once per 5 minutes to avoid rate limit errors from Flux.
| Parameter |
Location |
Type |
Requirements |
Optional |
Default value |
Description |
| customerId |
POST-body |
string |
|
No |
|
The customerId |
| departmentId |
POST-body |
string |
|
No |
|
The departmentId |
| valuationId |
POST-body |
int |
|
Yes |
null |
The flux valuationId |
| Response |
HTTP |
Type |
Description |
| Success |
200 |
boolean |
Success result |
| MissingRequiredParameterException |
400 |
|
The request is missing a required input parameter. See details for involved parameter. |
| InvalidParameterException |
400 |
|
The request has an invalid argument. See details for involved parameter and invalidation. |
| AuthenticationFailedException |
401 |
|
Authentication failed. Re-authenticate and retry. See error details for details. |
| UnauthorizedException |
403 |
|
Authorization for requested method rejected. See error details for details. |
Authentication required:
Yes
Authentication scheme:
JWTAuth
Required flags:
flux:* ⎘
Authentication schemes (Click an authentication scheme to expand it)
JWTAuth
| description |
Bearer JWT token in Authorization header. |
| realm |
kate.v2 |
| supportedIssuers |
[
"auth.api.katedev.com",
"legacy-adapter.api.katedev.com",
"auth.api.spring-nl.katetest.com",
"legacy-adapter.api.spring-nl.katetest.com"
] |
| verificationKeyIdentifier |
[
"iss"
] |
| flagsIdentifier |
perm |
| detailsIdentifiers |
{
"idUser": "sub",
"username": "name",
"idCustomer": "idc",
"idDepartment": "idd",
"businessNumber": "bn",
"customerPartition": "cp"
} |
Result wrappers (Click a result-wrapper to expand it)
Success
{
result: < mixed, success result, type specified in API route documentation >,
error: null,
messages: {
"type": "error|warning|success|info|debug",
"namespace": string,
"namedArguments": < optional object that has information referenced in the translation linked to the namespace>
}[],
apiVersion: < string, current serving API version in format ^[0-9]+\.[0-9]+\.[0-9]+(\-[A-Za-z0-9]+)?$ >
}
Error
{
result: null,
error: {
code: < string, response error code as described in API route documentation. Use this code in language translation files. >,
description: < string, optional, technical description of error. Only intended for developers for debug, not suitable for end-users >,
details: < object|array|string, contains detailed data about error, if applicable >
},
messages: {
"type": "error|warning|success|info|debug",
"namespace": string,
"namedArguments": < optional object that has information referenced in the translation linked to the namespace>
}[],
apiVersion: < string, current serving API version in format ^[0-9]+\.[0-9]+\.[0-9]+(\-[A-Za-z0-9]+)?$ >
}