From 04239d5b82de39e0ff56613612d25151aa52ddcd Mon Sep 17 00:00:00 2001 From: Ulf Bjorkengren Date: Wed, 24 Jan 2024 11:42:23 +0100 Subject: [PATCH] Error message update. Signed-off-by: Ulf Bjorkengren --- spec/VISSv2_Transport.html | 101 ++++--------------------------------- 1 file changed, 11 insertions(+), 90 deletions(-) diff --git a/spec/VISSv2_Transport.html b/spec/VISSv2_Transport.html index cabc1bb..1203a7c 100644 --- a/spec/VISSv2_Transport.html +++ b/spec/VISSv2_Transport.html @@ -162,125 +162,45 @@

Status Codes

Error Reason Error Message - - 304 (Not Modified) - not_modified - No changes have been made by the server. - 400 (Bad Request) bad_request - The server is unable to fulfil the client request because the request is malformed. + The request is malformed. 400 (Bad Request) - filter_invalid - Filter requested on non-primitive type. - - - 400 (Bad Request) - invalid_duration - Time duration is invalid. - - - 400 (Bad Request) - invalid_value - The requested set value is invalid. + invalid_data + Data present in the request is invalid. 401 (Unauthorized) - token_expired + expired_token Access token has expired. 401 (Unauthorized) - token_invalid + invalid_token Access token is invalid. 401 (Unauthorized) - token_missing + missing_token Access token is missing. - - 401 (Unauthorized) - too_many_attempts - The client has failed to authenticate too many times. - - - 401 (Unauthorized) - read_only - The desired signal cannot be set since it is a read only signal. - - - 403 (Forbidden) - user_forbidden - The user is not permitted to access the requested resource. Retrying does not help. - - - 403 (Forbidden) - user_unknown - The user is unknown. Retrying does not help. - - - 403 (Forbidden) - device_forbidden - The device is not permitted to access the requested resource. Retrying does not help. - 403 (Forbidden) - device_unknown - The device is unknown. Retrying does not help. + forbidden_request + The server refuses to carry out the request. - 404 (Not Found) - invalid_path - The specified data path does not exist. - - - 404 (Not Found) - private_path - The specified data path is private and the request is not authorized to access signals on this path. - - 404 (Not Found) unavailable_data The requested data was not found. - - 404 (Not Found) - invalid_subscriptionId - The specified subscription was not found. - - - 406 (Not Acceptable) - insufficient_priviledges - The priviledges represented by the access token are not sufficient. - - - 406 (Not Acceptable) - not_acceptable - The server is unable to generate content that is acceptable to the client - - - 429 (Too Many Requests) - too_many_requests - The client has sent the server too many requests in a given amount of time. - - - 502 (Bad Gateway) - bad_gateway - The server was acting as a gateway or proxy and received an invalid response from an upstream server. - 503 (Service Unavailable) service_unavailable - The server is currently unable to handle the request due to a temporary overload or scheduled maintenance (which may be alleviated after some delay). - - - 504 (Gateway Timeout) - gateway_timeout - The server did not receive a timely response from an upstream server it needed to access in order to complete the request. + The server is temporarily unable to handle the request. @@ -1677,7 +1597,8 @@

Action Definitions

Error Definitions

The error number SHOULD be a status code defined in [[RFC2616]], c. f. chapter "Status codes". - The error reason SHOULD be the corresponding reason-phrase from [[RFC2616]]. + The error reason SHOULD be short. two or three words connected by underscor. + It SHOULD relate to the reason-phrase from [[RFC2616]] for the corresponding status code. The error message is meant to give a more precise description of the error.