diff --git a/components/schemas/requestErrors/400/Error400RequestBodyEmpty.yaml b/components/schemas/requestErrors/400/Error400RequestBodyEmpty.yaml index cd96c86..b27263e 100644 --- a/components/schemas/requestErrors/400/Error400RequestBodyEmpty.yaml +++ b/components/schemas/requestErrors/400/Error400RequestBodyEmpty.yaml @@ -31,10 +31,9 @@ properties: type: string description: Error related to. description: - enum: - - >- - Cannot process the request because of the empty body. Please check - Foxentry.dev for more information. + type: + - string + - "null" description: Description of error. example: >- Cannot process the request because of the empty body. Please check diff --git a/components/schemas/requestErrors/400/Error400RequestBodyNoRequest.yaml b/components/schemas/requestErrors/400/Error400RequestBodyNoRequest.yaml index 8e794b0..b8d41f5 100644 --- a/components/schemas/requestErrors/400/Error400RequestBodyNoRequest.yaml +++ b/components/schemas/requestErrors/400/Error400RequestBodyNoRequest.yaml @@ -31,7 +31,8 @@ properties: type: string description: Error related to. description: - enum: - - Your API call body does not contain any requests. + type: + - string + - "null" description: Description of error. example: Your API call body does not contain any requests. diff --git a/components/schemas/requestErrors/400/Error400RequestBodyNotJson.yaml b/components/schemas/requestErrors/400/Error400RequestBodyNotJson.yaml index 64da0e6..f3d28be 100644 --- a/components/schemas/requestErrors/400/Error400RequestBodyNotJson.yaml +++ b/components/schemas/requestErrors/400/Error400RequestBodyNotJson.yaml @@ -31,10 +31,9 @@ properties: type: string description: Error related to. description: - enum: - - >- - Cannot process the request because the JSON is not valid. Please check - Foxentry.dev for more information. + type: + - string + - "null" description: Description of error. example: >- Cannot process the request because the JSON is not valid. Please check diff --git a/components/schemas/requestErrors/400/Error400RequestBodyTooBig.yaml b/components/schemas/requestErrors/400/Error400RequestBodyTooBig.yaml index b3e99b2..a9e82c1 100644 --- a/components/schemas/requestErrors/400/Error400RequestBodyTooBig.yaml +++ b/components/schemas/requestErrors/400/Error400RequestBodyTooBig.yaml @@ -31,10 +31,9 @@ properties: type: string description: Error related to. description: - enum: - - >- - Your request length is bigger than allowed. Please contact us if you - think this is a mistake. + type: + - string + - "null" description: Description of error. example: >- Your request length is bigger than allowed. Please contact us if you think diff --git a/components/schemas/requestErrors/400/Error400RequestClientParameterNotSupported.yaml b/components/schemas/requestErrors/400/Error400RequestClientParameterNotSupported.yaml index c408edf..44fe893 100644 --- a/components/schemas/requestErrors/400/Error400RequestClientParameterNotSupported.yaml +++ b/components/schemas/requestErrors/400/Error400RequestClientParameterNotSupported.yaml @@ -31,7 +31,8 @@ properties: type: string description: Error related to. description: - enum: - - Options parameter is not supported for this endpoint. + type: + - string + - "null" description: Description of error. example: Options parameter is not supported for this endpoint. diff --git a/components/schemas/requestErrors/400/Error400RequestClientParameterValueNotSupported.yaml b/components/schemas/requestErrors/400/Error400RequestClientParameterValueNotSupported.yaml index 7cab478..17ef857 100644 --- a/components/schemas/requestErrors/400/Error400RequestClientParameterValueNotSupported.yaml +++ b/components/schemas/requestErrors/400/Error400RequestClientParameterValueNotSupported.yaml @@ -31,7 +31,8 @@ properties: type: string description: Error related to. description: - enum: - - Options parameter is not supported for this endpoint. + type: + - string + - "null" description: Description of error. example: Options parameter is not supported for this endpoint. diff --git a/components/schemas/requestErrors/400/Error400RequestOptionsParameterCombination.yaml b/components/schemas/requestErrors/400/Error400RequestOptionsParameterCombination.yaml index e0c50c1..ef16671 100644 --- a/components/schemas/requestErrors/400/Error400RequestOptionsParameterCombination.yaml +++ b/components/schemas/requestErrors/400/Error400RequestOptionsParameterCombination.yaml @@ -31,7 +31,8 @@ properties: type: string description: Error related to. description: - enum: - - Combination of options or their values is not valid. + type: + - string + - "null" description: Description of error. example: Combination of options or their values is not valid. diff --git a/components/schemas/requestErrors/400/Error400RequestOptionsParameterNotSupported.yaml b/components/schemas/requestErrors/400/Error400RequestOptionsParameterNotSupported.yaml index 3c66da3..3041d2f 100644 --- a/components/schemas/requestErrors/400/Error400RequestOptionsParameterNotSupported.yaml +++ b/components/schemas/requestErrors/400/Error400RequestOptionsParameterNotSupported.yaml @@ -31,7 +31,8 @@ properties: type: string description: Error related to. description: - enum: - - Options parameter is not supported for this endpoint. + type: + - string + - "null" description: Description of error. example: Options parameter is not supported for this endpoint. diff --git a/components/schemas/requestErrors/400/Error400RequestOptionsParameterValueNotSupported.yaml b/components/schemas/requestErrors/400/Error400RequestOptionsParameterValueNotSupported.yaml index 61b2323..8288448 100644 --- a/components/schemas/requestErrors/400/Error400RequestOptionsParameterValueNotSupported.yaml +++ b/components/schemas/requestErrors/400/Error400RequestOptionsParameterValueNotSupported.yaml @@ -31,10 +31,9 @@ properties: type: string description: Error related to. description: - enum: - - >- - Value in paramater is not valid. Please check Foxentry.dev for more - information. + type: + - string + - "null" description: Description of error. example: >- Value in paramater is not valid. Please check Foxentry.dev for more diff --git a/components/schemas/requestErrors/400/Error400RequestQueryNotSent.yaml b/components/schemas/requestErrors/400/Error400RequestQueryNotSent.yaml index 949cb52..5375670 100644 --- a/components/schemas/requestErrors/400/Error400RequestQueryNotSent.yaml +++ b/components/schemas/requestErrors/400/Error400RequestQueryNotSent.yaml @@ -31,10 +31,9 @@ properties: type: string description: Error related to. description: - enum: - - >- - Your request query is empty. Please check Foxentry.dev for more - information about how to set up the query properly. + type: + - string + - "null" description: Description of error. example: >- Your request query is empty. Please check Foxentry.dev for more diff --git a/components/schemas/requestErrors/400/Error400RequestQueryParameterCombination.yaml b/components/schemas/requestErrors/400/Error400RequestQueryParameterCombination.yaml index 4a11699..00a9065 100644 --- a/components/schemas/requestErrors/400/Error400RequestQueryParameterCombination.yaml +++ b/components/schemas/requestErrors/400/Error400RequestQueryParameterCombination.yaml @@ -35,10 +35,9 @@ properties: - streetWithNumber - street description: - enum: - - >- - It is not possible to use these parameters at the same time in one - request. + type: + - string + - "null" description: Description of error. example: >- It is not possible to use these parameters at the same time in one diff --git a/components/schemas/requestErrors/400/Error400RequestQueryParameterMissing.yaml b/components/schemas/requestErrors/400/Error400RequestQueryParameterMissing.yaml index 7749aa7..8a637db 100644 --- a/components/schemas/requestErrors/400/Error400RequestQueryParameterMissing.yaml +++ b/components/schemas/requestErrors/400/Error400RequestQueryParameterMissing.yaml @@ -32,10 +32,9 @@ properties: description: Error related to. example: prefix description: - enum: - - >- - Query parameter is missing. Please check Foxentry.dev for more - information about how to set up the query properly. + type: + - string + - "null" description: Description of error. example: >- Query parameter is missing. Please check Foxentry.dev for more information diff --git a/components/schemas/requestErrors/400/Error400RequestQueryParameterNotSupported.yaml b/components/schemas/requestErrors/400/Error400RequestQueryParameterNotSupported.yaml index 4ade4fc..e399d0a 100644 --- a/components/schemas/requestErrors/400/Error400RequestQueryParameterNotSupported.yaml +++ b/components/schemas/requestErrors/400/Error400RequestQueryParameterNotSupported.yaml @@ -33,7 +33,8 @@ properties: example: - unsupportedParameter description: - enum: - - Query parameter is not supported for this endpoint. + type: + - string + - "null" description: Description of error. example: Query parameter is not supported for this endpoint. diff --git a/components/schemas/requestErrors/400/Error400RequestQueryParameterNotSupportedForQuery.yaml b/components/schemas/requestErrors/400/Error400RequestQueryParameterNotSupportedForQuery.yaml index b02358b..3637260 100644 --- a/components/schemas/requestErrors/400/Error400RequestQueryParameterNotSupportedForQuery.yaml +++ b/components/schemas/requestErrors/400/Error400RequestQueryParameterNotSupportedForQuery.yaml @@ -34,7 +34,8 @@ properties: example: - allowPartialResults description: - enum: - - Parameter can not be used in combination with this query parameters. + type: + - string + - "null" description: Description of error. example: Parameter can not be used in combination with this query parameters. diff --git a/components/schemas/requestErrors/400/Error400RequestQueryParameterRequired.yaml b/components/schemas/requestErrors/400/Error400RequestQueryParameterRequired.yaml index 14f6cd0..e42745e 100644 --- a/components/schemas/requestErrors/400/Error400RequestQueryParameterRequired.yaml +++ b/components/schemas/requestErrors/400/Error400RequestQueryParameterRequired.yaml @@ -32,7 +32,8 @@ properties: description: Error related to. example: email description: - enum: - - At least one of listed parameters is required. + type: + - string + - "null" description: Description of error. example: At least one of listed parameters is required. diff --git a/components/schemas/requestErrors/401/Error401RequestAuth.yaml b/components/schemas/requestErrors/401/Error401RequestAuth.yaml index f1e30ac..f52e566 100644 --- a/components/schemas/requestErrors/401/Error401RequestAuth.yaml +++ b/components/schemas/requestErrors/401/Error401RequestAuth.yaml @@ -31,10 +31,9 @@ properties: type: string description: Error related to. description: - enum: - - >- - Invalid authorization credentials sent. Check Foxentry.dev for more - information how to set up the AUTH properly. + type: + - string + - "null" description: Description of error. example: >- Invalid authorization credentials sent. Check Foxentry.dev for more diff --git a/components/schemas/requestErrors/402/Error402RequestBillingNoCredit.yaml b/components/schemas/requestErrors/402/Error402RequestBillingNoCredit.yaml index 8415c44..b6b43e9 100644 --- a/components/schemas/requestErrors/402/Error402RequestBillingNoCredit.yaml +++ b/components/schemas/requestErrors/402/Error402RequestBillingNoCredit.yaml @@ -31,11 +31,10 @@ properties: type: string description: Error related to. description: - enum: - - >- - No credit available. You need to purchase a sufficient ammount of - credits in the project administration at app.foxentry.com. + type: + - string + - "null" description: Description of error. example: >- - No credit available. You need to purchase a sufficient ammount of credits + No credit available. You need to purchase a sufficient amount of credits in the project administration at app.foxentry.com. diff --git a/components/schemas/requestErrors/403/Error403RequestAuthKey.yaml b/components/schemas/requestErrors/403/Error403RequestAuthKey.yaml index bfd4bd0..125552f 100644 --- a/components/schemas/requestErrors/403/Error403RequestAuthKey.yaml +++ b/components/schemas/requestErrors/403/Error403RequestAuthKey.yaml @@ -31,10 +31,9 @@ properties: type: string description: Error related to. description: - enum: - - >- - Provided API key is not valid. Please check the project settings at - app.foxentry.com. + type: + - string + - "null" description: Description of error. example: >- Provided API key is not valid. Please check the project settings at diff --git a/components/schemas/requestErrors/403/Error403RequestAuthToken.yaml b/components/schemas/requestErrors/403/Error403RequestAuthToken.yaml index 4d3faa0..51ad453 100644 --- a/components/schemas/requestErrors/403/Error403RequestAuthToken.yaml +++ b/components/schemas/requestErrors/403/Error403RequestAuthToken.yaml @@ -31,10 +31,9 @@ properties: type: string description: Error related to. description: - enum: - - >- - Provided access token is not valid. Please check the project settings at - app.foxentry.com. + type: + - string + - "null" description: Description of error. example: >- Provided access token is not valid. Please check the project settings at diff --git a/components/schemas/requestErrors/403/Error403RequestNotAllowedDomain.yaml b/components/schemas/requestErrors/403/Error403RequestNotAllowedDomain.yaml index a40cc16..8722bff 100644 --- a/components/schemas/requestErrors/403/Error403RequestNotAllowedDomain.yaml +++ b/components/schemas/requestErrors/403/Error403RequestNotAllowedDomain.yaml @@ -31,7 +31,8 @@ properties: type: string description: Error related to. description: - enum: - - Website domain is not allowed in the project settings. + type: + - string + - "null" description: Description of error. example: Website domain is not allowed in the project settings. diff --git a/components/schemas/requestErrors/403/Error403RequestNotAllowedIp.yaml b/components/schemas/requestErrors/403/Error403RequestNotAllowedIp.yaml index 21c929f..ecf9f8e 100644 --- a/components/schemas/requestErrors/403/Error403RequestNotAllowedIp.yaml +++ b/components/schemas/requestErrors/403/Error403RequestNotAllowedIp.yaml @@ -31,10 +31,9 @@ properties: type: string description: Error related to. description: - enum: - - >- - The API key has IP limits set and your IP address is not allowed. Change - the project settings at app.foxentry.com. + type: + - string + - "null" description: Description of error. example: >- The API key has IP limits set and your IP address is not allowed. Change diff --git a/components/schemas/requestErrors/404/Error404RequestApiVersion.yaml b/components/schemas/requestErrors/404/Error404RequestApiVersion.yaml index 96a136f..c7e9f0e 100644 --- a/components/schemas/requestErrors/404/Error404RequestApiVersion.yaml +++ b/components/schemas/requestErrors/404/Error404RequestApiVersion.yaml @@ -31,10 +31,9 @@ properties: type: string description: Error related to. description: - enum: - - >- - Requested API version is not available. Please check Foxentry.dev for - the supported versions. + type: + - string + - "null" description: Description of error. example: >- Requested API version is not available. Please check Foxentry.dev for the diff --git a/components/schemas/requestErrors/404/Error404RequestEndpointNotFound.yaml b/components/schemas/requestErrors/404/Error404RequestEndpointNotFound.yaml index 8b3ae71..5aaf821 100644 --- a/components/schemas/requestErrors/404/Error404RequestEndpointNotFound.yaml +++ b/components/schemas/requestErrors/404/Error404RequestEndpointNotFound.yaml @@ -31,9 +31,8 @@ properties: type: string description: Error related to. description: - enum: - - >- - Endpoint not found. Please check Foxentry.dev for the supported - endpoints. + type: + - string + - "null" description: Description of error. example: Endpoint not found. Please check Foxentry.dev for the supported endpoints. diff --git a/components/schemas/requestErrors/404/Error404RequestProjectNotFound.yaml b/components/schemas/requestErrors/404/Error404RequestProjectNotFound.yaml index dc80a12..820143d 100644 --- a/components/schemas/requestErrors/404/Error404RequestProjectNotFound.yaml +++ b/components/schemas/requestErrors/404/Error404RequestProjectNotFound.yaml @@ -31,10 +31,9 @@ properties: type: string description: Error related to. description: - enum: - - >- - The project does not exist. Please check the available projects at - app.foxentry.com or contact the support. + type: + - string + - "null" description: Description of error. example: >- The project does not exist. Please check the available projects at diff --git a/components/schemas/requestErrors/405/Error405RequestNotAllowedMethod.yaml b/components/schemas/requestErrors/405/Error405RequestNotAllowedMethod.yaml index 91183ce..68d807c 100644 --- a/components/schemas/requestErrors/405/Error405RequestNotAllowedMethod.yaml +++ b/components/schemas/requestErrors/405/Error405RequestNotAllowedMethod.yaml @@ -31,10 +31,9 @@ properties: type: string description: Error related to. description: - enum: - - >- - HTTP method is not allowed for this endpoint. Please check Foxentry.dev - for more information. + type: + - string + - "null" description: Description of error. example: >- HTTP method is not allowed for this endpoint. Please check Foxentry.dev diff --git a/components/schemas/requestErrors/429/Error429RequestBillingServiceLimit.yaml b/components/schemas/requestErrors/429/Error429RequestBillingServiceLimit.yaml index caabe3f..151cf15 100644 --- a/components/schemas/requestErrors/429/Error429RequestBillingServiceLimit.yaml +++ b/components/schemas/requestErrors/429/Error429RequestBillingServiceLimit.yaml @@ -31,10 +31,9 @@ properties: type: string description: Error related to. description: - enum: - - >- - The maximum service limit has been reached. Move to the higher paying plan or allow requests - over the subscription. + type: + - string + - "null" description: Description of error. example: >- The maximum service limit has been reached. Move to the higher paying plan or allow requests diff --git a/components/schemas/requestErrors/429/Error429RequestRateLimitCreditPerDay.yaml b/components/schemas/requestErrors/429/Error429RequestRateLimitCreditPerDay.yaml index 2227dd4..c7d37d1 100644 --- a/components/schemas/requestErrors/429/Error429RequestRateLimitCreditPerDay.yaml +++ b/components/schemas/requestErrors/429/Error429RequestRateLimitCreditPerDay.yaml @@ -31,10 +31,9 @@ properties: type: string description: Error related to. description: - enum: - - >- - The maximum daily limit has been reached. Adjust the settings in the - project or wait until the limit is reset. + type: + - string + - "null" description: Description of error. example: >- The maximum daily limit has been reached. Adjust the settings in the diff --git a/components/schemas/requestErrors/429/Error429RequestRateLimitCreditPerIp.yaml b/components/schemas/requestErrors/429/Error429RequestRateLimitCreditPerIp.yaml index 829474c..854da3d 100644 --- a/components/schemas/requestErrors/429/Error429RequestRateLimitCreditPerIp.yaml +++ b/components/schemas/requestErrors/429/Error429RequestRateLimitCreditPerIp.yaml @@ -31,10 +31,9 @@ properties: type: string description: Error related to. description: - enum: - - >- - The maximum daily limit per IP address has been reached. Adjust the - settings in the project or wait until the limit is reset. + type: + - string + - "null" description: Description of error. example: >- The maximum daily limit per IP address has been reached. Adjust the diff --git a/components/schemas/requestErrors/429/Error429RequestRateLimitTooManyRequests.yaml b/components/schemas/requestErrors/429/Error429RequestRateLimitTooManyRequests.yaml index aad7f71..756cdf3 100644 --- a/components/schemas/requestErrors/429/Error429RequestRateLimitTooManyRequests.yaml +++ b/components/schemas/requestErrors/429/Error429RequestRateLimitTooManyRequests.yaml @@ -31,10 +31,9 @@ properties: type: string description: Error related to. description: - enum: - - >- - The maximum allowed request rate limit has been reached. Check - Foxentry.dev for more information or contact the support. + type: + - string + - "null" description: Description of error. example: >- The maximum allowed request rate limit has been reached. Check diff --git a/components/schemas/requestErrors/500/Error500InternalBilling.yaml b/components/schemas/requestErrors/500/Error500InternalBilling.yaml index ce6a990..4b22296 100644 --- a/components/schemas/requestErrors/500/Error500InternalBilling.yaml +++ b/components/schemas/requestErrors/500/Error500InternalBilling.yaml @@ -30,10 +30,9 @@ properties: type: string description: Error related to. description: - enum: - - >- - Failed to process your request due to a billing internal error. Please - contact us if the error persists. + type: + - string + - "null" description: Description of error. example: >- Failed to process your request due to a billing internal error. Please diff --git a/components/schemas/requestErrors/500/Error500InternalDatabaseConnection.yaml b/components/schemas/requestErrors/500/Error500InternalDatabaseConnection.yaml index 7e00920..8de57d1 100644 --- a/components/schemas/requestErrors/500/Error500InternalDatabaseConnection.yaml +++ b/components/schemas/requestErrors/500/Error500InternalDatabaseConnection.yaml @@ -30,10 +30,9 @@ properties: type: string description: Error related to. description: - enum: - - >- - Failed to establish connection with the database server. Please contact - us if the error persists. + type: + - string + - "null" description: Description of error. example: >- Failed to establish connection with the database server. Please contact us diff --git a/components/schemas/requestErrors/500/Error500InternalDatabaseError.yaml b/components/schemas/requestErrors/500/Error500InternalDatabaseError.yaml index 8991595..4c70e74 100644 --- a/components/schemas/requestErrors/500/Error500InternalDatabaseError.yaml +++ b/components/schemas/requestErrors/500/Error500InternalDatabaseError.yaml @@ -30,11 +30,10 @@ properties: type: string description: Error related to. description: - enum: - - >- - An error has occured during the communication with our database. Please - contact us if the error persists. + type: + - string + - "null" description: Description of error. example: >- - An error has occured during the communication with our database. Please + An error has occurred during the communication with our database. Please contact us if the error persists. diff --git a/components/schemas/requestErrors/500/Error500InternalDatabaseNotAvailable.yaml b/components/schemas/requestErrors/500/Error500InternalDatabaseNotAvailable.yaml index 73f16ee..345c959 100644 --- a/components/schemas/requestErrors/500/Error500InternalDatabaseNotAvailable.yaml +++ b/components/schemas/requestErrors/500/Error500InternalDatabaseNotAvailable.yaml @@ -30,10 +30,9 @@ properties: type: string description: Error related to. description: - enum: - - >- - Internal datastore is not available at the moment. No operation on this - datastore is possible. + type: + - string + - "null" description: Description of error. example: >- Internal datastore is not available at the moment. No operation on this diff --git a/components/schemas/requestErrors/500/Error500InternalError.yaml b/components/schemas/requestErrors/500/Error500InternalError.yaml index 74157e4..011ad5a 100644 --- a/components/schemas/requestErrors/500/Error500InternalError.yaml +++ b/components/schemas/requestErrors/500/Error500InternalError.yaml @@ -31,7 +31,8 @@ properties: type: string description: Error related to. description: - enum: - - Failed to process your request. Please try again later or contact us. + type: + - string + - "null" description: Description of error. example: Failed to process your request. Please try again later or contact us. diff --git a/components/schemas/requestErrors/500/Error500RequestProjectNoData.yaml b/components/schemas/requestErrors/500/Error500RequestProjectNoData.yaml index 7e0f993..8806930 100644 --- a/components/schemas/requestErrors/500/Error500RequestProjectNoData.yaml +++ b/components/schemas/requestErrors/500/Error500RequestProjectNoData.yaml @@ -31,10 +31,9 @@ properties: type: string description: Error related to. description: - enum: - - >- - Failed to fetch project data needed for processing your request. Please - contact us if the error persists. + type: + - string + - "null" description: Description of error. example: >- Failed to fetch project data needed for processing your request. Please diff --git a/components/schemas/requestErrors/500/Error500Timeout.yaml b/components/schemas/requestErrors/500/Error500Timeout.yaml index 998606d..2b0151d 100644 --- a/components/schemas/requestErrors/500/Error500Timeout.yaml +++ b/components/schemas/requestErrors/500/Error500Timeout.yaml @@ -31,7 +31,8 @@ properties: type: string description: Error related to. description: - enum: - - API timeout in effect. Your request took too much time to process. + type: + - string + - "null" description: Description of error. example: API timeout in effect. Your request took too much time to process. diff --git a/components/schemas/requestErrors/503/Error503RequestEndpointNotAvailable.yaml b/components/schemas/requestErrors/503/Error503RequestEndpointNotAvailable.yaml index e1a4334..0cecc53 100644 --- a/components/schemas/requestErrors/503/Error503RequestEndpointNotAvailable.yaml +++ b/components/schemas/requestErrors/503/Error503RequestEndpointNotAvailable.yaml @@ -31,10 +31,9 @@ properties: type: string description: Error related to. description: - enum: - - >- - API endpoint is temporary unavailable. Please contact us at - info@foxentry.com if the error persists. + type: + - string + - "null" description: Description of error. example: >- API endpoint is temporary unavailable. Please contact us at diff --git a/components/schemas/requests/ClientRequest.yaml b/components/schemas/requests/ClientRequest.yaml index c3b87fb..eb392d0 100644 --- a/components/schemas/requests/ClientRequest.yaml +++ b/components/schemas/requests/ClientRequest.yaml @@ -6,8 +6,14 @@ description: >- properties: ip: type: string - example: 127.0.1.1 - format: ipv4 + description: >- + IP address of your end user (IPv4 or IPv6). Used for geolocation to make + results — for example for the search endpoints — more relevant to the + user's location. If you have the user's GPS coordinates, prefer sending + those via `location`, as an IP address may be less precise. + examples: + - 127.0.1.1 + - 2001:db8::8a2e:370:7334 country: type: string description: >- diff --git a/components/schemas/requests/company/CompanyOptions.yaml b/components/schemas/requests/company/CompanyOptions.yaml index d33a99e..a97ad30 100644 --- a/components/schemas/requests/company/CompanyOptions.yaml +++ b/components/schemas/requests/company/CompanyOptions.yaml @@ -57,7 +57,7 @@ properties: description: >- This option determines the format in which the country is returned. Supported formats: alpha2 = CZ, alpha3 = CZE, local = Česká republika, international - = Czech republic, localShortened = Česko, internationalShortened + = Czech Republic, localShortened = Česko, internationalShortened = Czechia. type: string enum: diff --git a/components/schemas/requests/company/CompanySearchBody.yaml b/components/schemas/requests/company/CompanySearchBody.yaml index 3884462..b0b5ab7 100644 --- a/components/schemas/requests/company/CompanySearchBody.yaml +++ b/components/schemas/requests/company/CompanySearchBody.yaml @@ -27,7 +27,7 @@ properties: description: >- Additional filter in order to specify the search results. You can for example set as a filter country CZ, so the the search engine would - look for the companies only in the Czech republic. Pay attention to + look for the companies only in the Czech Republic. Pay attention to the options, which determines how the filter should behave. properties: name: diff --git a/components/schemas/requests/location/LocationOptions.yaml b/components/schemas/requests/location/LocationOptions.yaml index 1f150b3..81e84f3 100644 --- a/components/schemas/requests/location/LocationOptions.yaml +++ b/components/schemas/requests/location/LocationOptions.yaml @@ -66,7 +66,7 @@ properties: countryFormat: description: >- This option determines the format in which the country is returned. Choices - include local (Česká republika) and international (Czech republic) + include local (Česká republika) and international (Czech Republic) variants with their shortened counterparts (Česko, Czechia). You can use ISO 3166 alpha codes (CZ, CZE) as well. type: string diff --git a/components/schemas/requests/location/LocationValidationBody.yaml b/components/schemas/requests/location/LocationValidationBody.yaml index e271066..129895e 100644 --- a/components/schemas/requests/location/LocationValidationBody.yaml +++ b/components/schemas/requests/location/LocationValidationBody.yaml @@ -87,7 +87,7 @@ properties: - "null" description: >- Country code. Supported formats: alpha2 = CZ, alpha3 = CZE, local = Česká republika, - international = Czech republic, localShortened = Česko, internationalShortened = Czechia. + international = Czech Republic, localShortened = Česko, internationalShortened = Czechia. example: CZ options: allOf: diff --git a/components/schemas/results/company/CompanyData.yaml b/components/schemas/results/company/CompanyData.yaml index 62db6ec..31bf49b 100644 --- a/components/schemas/results/company/CompanyData.yaml +++ b/components/schemas/results/company/CompanyData.yaml @@ -450,7 +450,7 @@ properties: zvláštní práva a povinnosti stocks: type: array - description: Textual description of the stock ammount and value. + description: Textual description of the stock amount and value. items: type: string description: List of stocks. diff --git a/components/schemas/results/company/CompanyValidationResult.yaml b/components/schemas/results/company/CompanyValidationResult.yaml index e2faa80..bab52f2 100644 --- a/components/schemas/results/company/CompanyValidationResult.yaml +++ b/components/schemas/results/company/CompanyValidationResult.yaml @@ -12,18 +12,35 @@ properties: which indicates a non-specific error. example: false proposal: - enum: + type: string + examples: - valid - validWithSuggestion - invalid - - invalidWithCorrection - - invalidWithPartialCorrection - invalidWithSuggestion + - invalidWithCorrection - invalidWithCorrectionWithSuggestion - description: >- + - invalidWithPartialCorrection + - invalidWithPartialCorrectionWithSuggestion + description: |- Proposed solution by Foxentry how you should process the response in your form or application. - example: valid + + The value is composed of three parts: the validity of `result`, the + validity of `resultCorrected` (appending `WithCorrection` or + `WithPartialCorrection`), and the presence of `suggestions` + (appending `WithSuggestion`). It is always a string and is never null. + + Complete list of possible values: + + - `valid` + - `validWithSuggestion` + - `invalid` + - `invalidWithSuggestion` + - `invalidWithCorrection` + - `invalidWithCorrectionWithSuggestion` + - `invalidWithPartialCorrection` + - `invalidWithPartialCorrectionWithSuggestion` allOf: - $ref: ./CompanyDataValidity.yaml resultCorrected: diff --git a/components/schemas/results/email/EmailValidationResult.yaml b/components/schemas/results/email/EmailValidationResult.yaml index 10ba590..0d2a3af 100644 --- a/components/schemas/results/email/EmailValidationResult.yaml +++ b/components/schemas/results/email/EmailValidationResult.yaml @@ -12,19 +12,50 @@ properties: which indicates a non-specific error. example: false proposal: - enum: + type: string + examples: - valid - validWithSuggestion - invalid - - invalidWithCorrection - - invalidWithPartialCorrection - invalidWithSuggestion + - invalidWithCorrection - invalidWithCorrectionWithSuggestion + - invalidWithPartialCorrection + - invalidWithPartialCorrectionWithSuggestion + - unknown + - unknownWithSuggestion - unknownWithCorrection + - unknownWithCorrectionWithSuggestion - unknownWithPartialCorrection - description: >- + - unknownWithPartialCorrectionWithSuggestion + description: |- Proposed solution by Foxentry how you should process the response in your form or application. + + The value is composed of three parts: the validity of `result`, the + validity of `resultCorrected` (appending `WithCorrection` or + `WithPartialCorrection`), and the presence of `suggestions` + (appending `WithSuggestion`). It is always a string and is never null. + + Complete list of possible values: + + - `valid` + - `validWithSuggestion` + - `invalid` + - `invalidWithSuggestion` + - `invalidWithCorrection` + - `invalidWithCorrectionWithSuggestion` + - `invalidWithPartialCorrection` + - `invalidWithPartialCorrectionWithSuggestion` + - `unknown` + - `unknownWithSuggestion` + - `unknownWithCorrection` + - `unknownWithCorrectionWithSuggestion` + - `unknownWithPartialCorrection` + - `unknownWithPartialCorrectionWithSuggestion` + + In practice the `unknown*` variants occur mainly as `unknown`, + `unknownWithCorrection` and `unknownWithSuggestion`. allOf: - $ref: ./EmailDataValidity.yaml resultCorrected: diff --git a/components/schemas/results/location/LocationValidationResult.yaml b/components/schemas/results/location/LocationValidationResult.yaml index 34a0b64..1b3f2e7 100644 --- a/components/schemas/results/location/LocationValidationResult.yaml +++ b/components/schemas/results/location/LocationValidationResult.yaml @@ -12,20 +12,35 @@ properties: which indicates a non-specific error. example: false proposal: - enum: + type: string + examples: - valid - validWithSuggestion - invalid - - invalidWithCorrection - - invalidWithPartialCorrection - invalidWithSuggestion + - invalidWithCorrection - invalidWithCorrectionWithSuggestion + - invalidWithPartialCorrection - invalidWithPartialCorrectionWithSuggestion - - null - description: >- + description: |- Proposed solution by Foxentry how you should process the response in your form or application. - example: invalidWithCorrection + + The value is composed of three parts: the validity of `result`, the + validity of `resultCorrected` (appending `WithCorrection` or + `WithPartialCorrection`), and the presence of `suggestions` + (appending `WithSuggestion`). It is always a string and is never null. + + Complete list of possible values: + + - `valid` + - `validWithSuggestion` + - `invalid` + - `invalidWithSuggestion` + - `invalidWithCorrection` + - `invalidWithCorrectionWithSuggestion` + - `invalidWithPartialCorrection` + - `invalidWithPartialCorrectionWithSuggestion` allOf: - $ref: ./LocationDataValidity.yaml required: diff --git a/components/schemas/results/name/NameValidationResult.yaml b/components/schemas/results/name/NameValidationResult.yaml index 7ab80c1..8a71a58 100644 --- a/components/schemas/results/name/NameValidationResult.yaml +++ b/components/schemas/results/name/NameValidationResult.yaml @@ -12,18 +12,35 @@ properties: which indicates a non-specific error. example: false proposal: - enum: + type: string + examples: - valid - validWithSuggestion - invalid - - invalidWithCorrection - - invalidWithPartialCorrection - invalidWithSuggestion + - invalidWithCorrection - invalidWithCorrectionWithSuggestion - description: >- + - invalidWithPartialCorrection + - invalidWithPartialCorrectionWithSuggestion + description: |- Proposed solution by Foxentry how you should process the response in your form or application. - example: validWithSuggestion + + The value is composed of three parts: the validity of `result`, the + validity of `resultCorrected` (appending `WithCorrection` or + `WithPartialCorrection`), and the presence of `suggestions` + (appending `WithSuggestion`). It is always a string and is never null. + + Complete list of possible values: + + - `valid` + - `validWithSuggestion` + - `invalid` + - `invalidWithSuggestion` + - `invalidWithCorrection` + - `invalidWithCorrectionWithSuggestion` + - `invalidWithPartialCorrection` + - `invalidWithPartialCorrectionWithSuggestion` allOf: - $ref: ./NameDataValidity.yaml diff --git a/components/schemas/results/phone/PhoneValidationResult.yaml b/components/schemas/results/phone/PhoneValidationResult.yaml index 3921c30..0d18a51 100644 --- a/components/schemas/results/phone/PhoneValidationResult.yaml +++ b/components/schemas/results/phone/PhoneValidationResult.yaml @@ -12,19 +12,35 @@ properties: which indicates a non-specific error. example: false proposal: - enum: + type: string + examples: - valid - validWithSuggestion - invalid - - invalidWithCorrection - - invalidWithPartialCorrection - invalidWithSuggestion + - invalidWithCorrection - invalidWithCorrectionWithSuggestion - - null - description: >- + - invalidWithPartialCorrection + - invalidWithPartialCorrectionWithSuggestion + description: |- Proposed solution by Foxentry how you should process the response in your form or application. - example: invalidWithCorrection + + The value is composed of three parts: the validity of `result`, the + validity of `resultCorrected` (appending `WithCorrection` or + `WithPartialCorrection`), and the presence of `suggestions` + (appending `WithSuggestion`). It is always a string and is never null. + + Complete list of possible values: + + - `valid` + - `validWithSuggestion` + - `invalid` + - `invalidWithSuggestion` + - `invalidWithCorrection` + - `invalidWithCorrectionWithSuggestion` + - `invalidWithPartialCorrection` + - `invalidWithPartialCorrectionWithSuggestion` allOf: - $ref: ./PhoneDataValidity.yaml required: diff --git a/components/schemas/validationErrors/ErrorFormatGlobal.yaml b/components/schemas/validationErrors/ErrorFormatGlobal.yaml index 7af9b00..2c7840f 100644 --- a/components/schemas/validationErrors/ErrorFormatGlobal.yaml +++ b/components/schemas/validationErrors/ErrorFormatGlobal.yaml @@ -39,13 +39,9 @@ properties: description: Error related to. example: numberWithPrefix description: - enum: - - >- - Invalid case sensitivity. Specific rules are applied to the use of upper - and lower case letters. - - Invalid diacritics. Specific rules are applied to the use of diacritics. - - Invalid use of spaces. Specific rules are applied to the use of spaces. - - null + type: + - string + - "null" description: Description of error. example: >- Invalid case sensitivity. Specific rules are applied to the use of upper diff --git a/components/schemas/validationErrors/ErrorSyntaxCompany.yaml b/components/schemas/validationErrors/ErrorSyntaxCompany.yaml index f525a74..12a58db 100644 --- a/components/schemas/validationErrors/ErrorSyntaxCompany.yaml +++ b/components/schemas/validationErrors/ErrorSyntaxCompany.yaml @@ -35,8 +35,8 @@ properties: description: Error related to. example: name description: - enum: - - Value contains duplicated legal form. - - Company name is missing the legal form. + type: + - string + - "null" description: Description of error. example: Value contains duplicated legal form. diff --git a/components/schemas/validationErrors/ErrorSyntaxEmail.yaml b/components/schemas/validationErrors/ErrorSyntaxEmail.yaml index 39a9241..d10ecd5 100644 --- a/components/schemas/validationErrors/ErrorSyntaxEmail.yaml +++ b/components/schemas/validationErrors/ErrorSyntaxEmail.yaml @@ -42,12 +42,8 @@ properties: description: Error related to. example: email description: - enum: - - The domain contains invalid syntax. - - Value contains duplicated '@' sign. - - Value does not contain '@' sign. - - Value is missing the top level domain. - - The TLD part of the value is placed in the wrong position. - - Value has invalid syntax. + type: + - string + - "null" description: Description of error. example: The domain contains invalid syntax. diff --git a/components/schemas/validationErrors/ErrorSyntaxGlobal.yaml b/components/schemas/validationErrors/ErrorSyntaxGlobal.yaml index 97af5c0..6871b18 100644 --- a/components/schemas/validationErrors/ErrorSyntaxGlobal.yaml +++ b/components/schemas/validationErrors/ErrorSyntaxGlobal.yaml @@ -43,13 +43,8 @@ properties: description: Error related to. example: numberWithPrefix description: - enum: - - Disallowed characters were used in the value. - - Value contains invalid use of spaces. - - Value has invalid syntax. - - Cannot be processed due to the invalid syntax. - - Value is too long. - - Value is too short. - - Value contains unneccessary context. + type: + - string + - "null" description: Description of error. example: Disallowed characters were used in the value. diff --git a/components/schemas/validationErrors/ErrorSyntaxLocation.yaml b/components/schemas/validationErrors/ErrorSyntaxLocation.yaml index 9e79ea6..f275e32 100644 --- a/components/schemas/validationErrors/ErrorSyntaxLocation.yaml +++ b/components/schemas/validationErrors/ErrorSyntaxLocation.yaml @@ -38,12 +38,8 @@ properties: description: Error related to. example: streetWithNumber description: - enum: - - Value is missing the city. - - Value is missing the number. - - Value is missing the number part. - - Value is missing the street. - - Value is missing the zip. - - Value is missing some part of the number. + type: + - string + - "null" description: Description of error. example: Value is missing the city. diff --git a/components/schemas/validationErrors/ErrorSyntaxName.yaml b/components/schemas/validationErrors/ErrorSyntaxName.yaml index f270fb9..5c03f98 100644 --- a/components/schemas/validationErrors/ErrorSyntaxName.yaml +++ b/components/schemas/validationErrors/ErrorSyntaxName.yaml @@ -37,9 +37,8 @@ properties: description: Error related to. example: name description: - enum: - - Value is missing the name part. - - Value is missing the surname part. - - The DEGREE part of the value is placed in the wrong position. + type: + - string + - "null" description: Description of error. example: Value is missing the name part. diff --git a/components/schemas/validationErrors/ErrorSyntaxPhone.yaml b/components/schemas/validationErrors/ErrorSyntaxPhone.yaml index 1c10f99..a8487f0 100644 --- a/components/schemas/validationErrors/ErrorSyntaxPhone.yaml +++ b/components/schemas/validationErrors/ErrorSyntaxPhone.yaml @@ -37,10 +37,8 @@ properties: description: Error related to. example: numberWithPrefix description: - enum: - - Value contains duplicated '+' sign. - - Value is missing the number. - - Value is missing the '+' sign. - - Value is missing the prefix. + type: + - string + - "null" description: Description of error. example: Value contains duplicated '+' sign. diff --git a/components/schemas/validationErrors/ErrorTemporaryInvalidEmail.yaml b/components/schemas/validationErrors/ErrorTemporaryInvalidEmail.yaml index 2431f26..1570663 100644 --- a/components/schemas/validationErrors/ErrorTemporaryInvalidEmail.yaml +++ b/components/schemas/validationErrors/ErrorTemporaryInvalidEmail.yaml @@ -35,7 +35,8 @@ properties: description: Error related to. example: email description: - enum: - - Mailbox is full and cannot receive any e-mails at the moment. + type: + - string + - "null" description: Description of error. example: Mailbox is full and cannot receive any e-mails at the moment. diff --git a/components/schemas/validationErrors/ErrorValueEmail.yaml b/components/schemas/validationErrors/ErrorValueEmail.yaml index 28bdf7b..aeeb00d 100644 --- a/components/schemas/validationErrors/ErrorValueEmail.yaml +++ b/components/schemas/validationErrors/ErrorValueEmail.yaml @@ -39,10 +39,8 @@ properties: description: Error related to. example: email description: - enum: - - Domain name is invalid. - - Domain does not have DNS records set properly for receiving emails. - - Disposable emails are not allowed. - - Freemails are not allowed. + type: + - string + - "null" description: Description of error. example: Domain name is invalid. diff --git a/components/schemas/validationErrors/ErrorValueGlobal.yaml b/components/schemas/validationErrors/ErrorValueGlobal.yaml index a91f91d..d674a78 100644 --- a/components/schemas/validationErrors/ErrorValueGlobal.yaml +++ b/components/schemas/validationErrors/ErrorValueGlobal.yaml @@ -37,12 +37,8 @@ properties: description: Error related to. example: numberWithPrefix description: - type: string - enum: - - Value is empty. - - Value contains parts in incorrect order. - - Value is not valid. - - The Combination of values listed in relatedTo section is not valid. - - Context words are not allowed. + type: + - string + - "null" description: Description of error. example: Value is empty. diff --git a/components/schemas/validationErrors/ErrorValueName.yaml b/components/schemas/validationErrors/ErrorValueName.yaml index 347b2ac..d08b1d0 100644 --- a/components/schemas/validationErrors/ErrorValueName.yaml +++ b/components/schemas/validationErrors/ErrorValueName.yaml @@ -39,11 +39,8 @@ properties: description: Error related to. example: name description: - enum: - - Degree value is invalid. - - Name has not been found in our database. - - NameSurname has not been found in our database. - - Surname has not been found in our database. - - Degrees are not allowed. + type: + - string + - "null" description: Description of error. example: Degree value is invalid. diff --git a/components/schemas/validationErrors/ErrorValuePhone.yaml b/components/schemas/validationErrors/ErrorValuePhone.yaml index 5954638..2ad2995 100644 --- a/components/schemas/validationErrors/ErrorValuePhone.yaml +++ b/components/schemas/validationErrors/ErrorValuePhone.yaml @@ -35,10 +35,8 @@ properties: description: Error related to. example: numberWithPrefix description: - enum: - - Prefix is invalid. - - >- - This prefix is not allowed. Check the 'allowedPrefixes' option in the - request. + type: + - string + - "null" description: Description of error. example: Prefix is invalid. diff --git a/openapi.yaml b/openapi.yaml index 1f2405d..4fc7edb 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -64,48 +64,48 @@ info: