From 4421a0876125682bbbe4c311f1f7e4c63d04944b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Pavel=20Hrdli=C4=8Dka?= Date: Fri, 3 Jul 2026 14:19:02 +0200 Subject: [PATCH 1/2] OAS 2.1 cleanup MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit OAS 2.1 cleanup per programmer answers (Q1–Q5, A1–A5) --- bundle.sh | 5 --- .../400/Error400RequestBodyEmpty.yaml | 7 ++-- .../400/Error400RequestBodyNoRequest.yaml | 5 ++- .../400/Error400RequestBodyNotJson.yaml | 7 ++-- .../400/Error400RequestBodyTooBig.yaml | 7 ++-- ...400RequestClientParameterNotSupported.yaml | 5 ++- ...questClientParameterValueNotSupported.yaml | 5 ++- ...400RequestOptionsParameterCombination.yaml | 5 ++- ...00RequestOptionsParameterNotSupported.yaml | 5 ++- ...uestOptionsParameterValueNotSupported.yaml | 7 ++-- .../400/Error400RequestQueryNotSent.yaml | 7 ++-- ...or400RequestQueryParameterCombination.yaml | 7 ++-- .../Error400RequestQueryParameterMissing.yaml | 7 ++-- ...r400RequestQueryParameterNotSupported.yaml | 5 ++- ...estQueryParameterNotSupportedForQuery.yaml | 5 ++- ...Error400RequestQueryParameterRequired.yaml | 5 ++- .../401/Error401RequestAuth.yaml | 7 ++-- .../402/Error402RequestBillingNoCredit.yaml | 9 ++--- .../403/Error403RequestAuthKey.yaml | 7 ++-- .../403/Error403RequestAuthToken.yaml | 7 ++-- .../403/Error403RequestNotAllowedDomain.yaml | 5 ++- .../403/Error403RequestNotAllowedIp.yaml | 7 ++-- .../404/Error404RequestApiVersion.yaml | 7 ++-- .../404/Error404RequestEndpointNotFound.yaml | 7 ++-- .../404/Error404RequestProjectNotFound.yaml | 7 ++-- .../405/Error405RequestNotAllowedMethod.yaml | 7 ++-- .../Error429RequestBillingServiceLimit.yaml | 7 ++-- .../Error429RequestRateLimitCreditPerDay.yaml | 7 ++-- .../Error429RequestRateLimitCreditPerIp.yaml | 7 ++-- ...ror429RequestRateLimitTooManyRequests.yaml | 7 ++-- .../500/Error500InternalBilling.yaml | 7 ++-- .../Error500InternalDatabaseConnection.yaml | 7 ++-- .../500/Error500InternalDatabaseError.yaml | 9 ++--- .../Error500InternalDatabaseNotAvailable.yaml | 7 ++-- .../500/Error500InternalError.yaml | 5 ++- .../500/Error500RequestProjectNoData.yaml | 7 ++-- .../requestErrors/500/Error500Timeout.yaml | 5 ++- .../Error503RequestEndpointNotAvailable.yaml | 7 ++-- .../schemas/requests/ClientRequest.yaml | 10 ++++- .../requests/company/CompanyOptions.yaml | 2 +- .../requests/company/CompanySearchBody.yaml | 2 +- .../requests/location/LocationOptions.yaml | 2 +- .../location/LocationValidationBody.yaml | 2 +- .../schemas/results/company/CompanyData.yaml | 2 +- .../company/CompanyValidationResult.yaml | 3 +- .../results/email/EmailValidationResult.yaml | 3 +- .../location/LocationValidationResult.yaml | 4 +- .../results/name/NameValidationResult.yaml | 3 +- .../results/phone/PhoneValidationResult.yaml | 4 +- .../validationErrors/ErrorFormatGlobal.yaml | 10 ++--- .../validationErrors/ErrorSyntaxCompany.yaml | 6 +-- .../validationErrors/ErrorSyntaxEmail.yaml | 10 ++--- .../validationErrors/ErrorSyntaxGlobal.yaml | 11 ++---- .../validationErrors/ErrorSyntaxLocation.yaml | 10 ++--- .../validationErrors/ErrorSyntaxName.yaml | 7 ++-- .../validationErrors/ErrorSyntaxPhone.yaml | 8 ++-- .../ErrorTemporaryInvalidEmail.yaml | 5 ++- .../validationErrors/ErrorValueEmail.yaml | 8 ++-- .../validationErrors/ErrorValueGlobal.yaml | 4 +- .../validationErrors/ErrorValueName.yaml | 9 ++--- .../validationErrors/ErrorValuePhone.yaml | 8 ++-- openapi.yaml | 37 +++++++++---------- paths/company/CompanyGet.yaml | 3 -- paths/company/CompanySearch.yaml | 3 -- paths/company/CompanyValidate.yaml | 5 +-- paths/email/EmailSearch.yaml | 3 -- paths/email/EmailValidate.yaml | 5 +-- paths/location/LocationGet.yaml | 3 -- paths/location/LocationLocalize.yaml | 3 -- paths/location/LocationSearch.yaml | 3 -- paths/location/LocationValidate.yaml | 5 +-- paths/name/NameValidate.yaml | 5 +-- paths/phone/PhoneSearch.yaml | 3 -- paths/phone/PhoneValidate.yaml | 5 +-- 74 files changed, 195 insertions(+), 267 deletions(-) diff --git a/bundle.sh b/bundle.sh index f36b96f..848bf24 100755 --- a/bundle.sh +++ b/bundle.sh @@ -7,11 +7,6 @@ if [ -z "$GENERATE_EXAMPLES" ]; then else echo "Generating examples" (cd ./requests && ./generate-examples.sh) - # Fail if previous command failed - if [ $? -ne 0 ]; then - echo "Failed to generate examples" - exit 1 - fi fi redocly bundle openapi.yaml -o openapi-bundled.yaml 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..8dce4fb 100644 --- a/components/schemas/results/company/CompanyValidationResult.yaml +++ b/components/schemas/results/company/CompanyValidationResult.yaml @@ -12,7 +12,8 @@ properties: which indicates a non-specific error. example: false proposal: - enum: + type: string + examples: - valid - validWithSuggestion - invalid diff --git a/components/schemas/results/email/EmailValidationResult.yaml b/components/schemas/results/email/EmailValidationResult.yaml index 10ba590..8e31ecd 100644 --- a/components/schemas/results/email/EmailValidationResult.yaml +++ b/components/schemas/results/email/EmailValidationResult.yaml @@ -12,7 +12,8 @@ properties: which indicates a non-specific error. example: false proposal: - enum: + type: string + examples: - valid - validWithSuggestion - invalid diff --git a/components/schemas/results/location/LocationValidationResult.yaml b/components/schemas/results/location/LocationValidationResult.yaml index 34a0b64..3c52465 100644 --- a/components/schemas/results/location/LocationValidationResult.yaml +++ b/components/schemas/results/location/LocationValidationResult.yaml @@ -12,7 +12,8 @@ properties: which indicates a non-specific error. example: false proposal: - enum: + type: string + examples: - valid - validWithSuggestion - invalid @@ -21,7 +22,6 @@ properties: - invalidWithSuggestion - invalidWithCorrectionWithSuggestion - invalidWithPartialCorrectionWithSuggestion - - null description: >- Proposed solution by Foxentry how you should process the response in your form or application. diff --git a/components/schemas/results/name/NameValidationResult.yaml b/components/schemas/results/name/NameValidationResult.yaml index 7ab80c1..7a7722c 100644 --- a/components/schemas/results/name/NameValidationResult.yaml +++ b/components/schemas/results/name/NameValidationResult.yaml @@ -12,7 +12,8 @@ properties: which indicates a non-specific error. example: false proposal: - enum: + type: string + examples: - valid - validWithSuggestion - invalid diff --git a/components/schemas/results/phone/PhoneValidationResult.yaml b/components/schemas/results/phone/PhoneValidationResult.yaml index 3921c30..3796434 100644 --- a/components/schemas/results/phone/PhoneValidationResult.yaml +++ b/components/schemas/results/phone/PhoneValidationResult.yaml @@ -12,7 +12,8 @@ properties: which indicates a non-specific error. example: false proposal: - enum: + type: string + examples: - valid - validWithSuggestion - invalid @@ -20,7 +21,6 @@ properties: - invalidWithPartialCorrection - invalidWithSuggestion - invalidWithCorrectionWithSuggestion - - null description: >- Proposed solution by Foxentry how you should process the response in your form or application. 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..e8ac269 100644 --- a/components/schemas/validationErrors/ErrorValueGlobal.yaml +++ b/components/schemas/validationErrors/ErrorValueGlobal.yaml @@ -37,7 +37,9 @@ properties: description: Error related to. example: numberWithPrefix description: - type: string + type: + - string + - "null" enum: - Value is empty. - Value contains parts in incorrect order. 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..3195e61 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -64,48 +64,48 @@ info: company/validate - Czech Republic, Slovakia, and Poland + Czech Republic, Hungary, Poland, and Slovakia company/search - Czech Republic, Slovakia, and Poland + Czech Republic, Hungary, Poland, and Slovakia company/get - Czech Republic, Slovakia, and Poland - + Czech Republic, Hungary, Poland, and Slovakia + email/validate Worldwide - + email/search Worldwide - + location/validate - Czech Republic, Slovakia, and Poland - + Albania, Andorra, Austria, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Cyprus, Czech Republic, Denmark, France, Germany, Greece, Hungary, Iceland, Italy, Kosovo, Liechtenstein, Luxembourg, Malta, Monaco, Montenegro, Netherlands, North Macedonia, Poland, Romania, San Marino, Serbia, Slovakia, Slovenia, Spain, Switzerland, United Kingdom, and Vatican City + location/search - Czech Republic, Slovakia, and Poland - + Albania, Andorra, Austria, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Cyprus, Czech Republic, Denmark, France, Germany, Greece, Hungary, Iceland, Italy, Kosovo, Liechtenstein, Luxembourg, Malta, Monaco, Montenegro, Netherlands, North Macedonia, Poland, Romania, San Marino, Serbia, Slovakia, Slovenia, Spain, Switzerland, United Kingdom, and Vatican City + location/get - Czech Republic, Slovakia, and Poland - + Albania, Andorra, Austria, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Cyprus, Czech Republic, Denmark, France, Germany, Greece, Hungary, Iceland, Italy, Kosovo, Liechtenstein, Luxembourg, Malta, Monaco, Montenegro, Netherlands, North Macedonia, Poland, Romania, San Marino, Serbia, Slovakia, Slovenia, Spain, Switzerland, United Kingdom, and Vatican City + location/localize - Czech Republic, Slovakia, and Poland - + Albania, Andorra, Austria, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Cyprus, Czech Republic, Denmark, France, Germany, Greece, Hungary, Iceland, Italy, Kosovo, Liechtenstein, Luxembourg, Malta, Monaco, Montenegro, Netherlands, North Macedonia, Poland, Romania, San Marino, Serbia, Slovakia, Slovenia, Spain, Switzerland, United Kingdom, and Vatican City + name/validate - Czech Republic, Slovakia - + Czech Republic and Slovakia + phone/validate Worldwide - + @@ -114,7 +114,7 @@ info: As part of our commitment to data security, you are required to obtain a Bearer token from Foxentry. If you are a new user and do not have an API key, please fill out our registration form at - https://foxentry.com/help-center/rest-api. + https://app.foxentry.com/registration. ## Need help? @@ -129,7 +129,6 @@ info: url: https://www.foxentry.com servers: - url: https://api.foxentry.com - - url: https://api.foxentry.com/v2.1 paths: /company/validate: $ref: paths/company/CompanyValidate.yaml diff --git a/paths/company/CompanyGet.yaml b/paths/company/CompanyGet.yaml index 26d8f0c..41b9a77 100644 --- a/paths/company/CompanyGet.yaml +++ b/paths/company/CompanyGet.yaml @@ -35,6 +35,3 @@ post: $ref: ./../../components/responses/error/Error503Response.yaml security: - BearerAuth: [] - servers: - - url: https://api.foxentry.com - - url: https://api.foxentry.com/v2.1 diff --git a/paths/company/CompanySearch.yaml b/paths/company/CompanySearch.yaml index be99d9d..6066be8 100644 --- a/paths/company/CompanySearch.yaml +++ b/paths/company/CompanySearch.yaml @@ -38,6 +38,3 @@ post: $ref: ./../../components/responses/error/Error503Response.yaml security: - BearerAuth: [] - servers: - - url: https://api.foxentry.com - - url: https://api.foxentry.com/v2.1 diff --git a/paths/company/CompanyValidate.yaml b/paths/company/CompanyValidate.yaml index 38c9ec9..ecd68ca 100644 --- a/paths/company/CompanyValidate.yaml +++ b/paths/company/CompanyValidate.yaml @@ -6,7 +6,7 @@ post: This endpoint requires at least 1 query parameter and will check if the parameters and their combinations are valid. Returns information about the company based on the datascope set in the options.

Foxentry - validator is able not only to evaluate the validity of the inputed + validator is able not only to evaluate the validity of the entered information but it also can fix various typos, errors and missing data. Foxentry can also suggest more suitable alternatives to the data sent in query. Please pay attention to the result, resultCorrected and @@ -42,6 +42,3 @@ post: $ref: ./../../components/responses/error/Error503Response.yaml security: - BearerAuth: [] - servers: - - url: https://api.foxentry.com - - url: https://api.foxentry.com/v2.1 diff --git a/paths/email/EmailSearch.yaml b/paths/email/EmailSearch.yaml index e0e5e60..2fed72c 100644 --- a/paths/email/EmailSearch.yaml +++ b/paths/email/EmailSearch.yaml @@ -37,6 +37,3 @@ post: $ref: ./../../components/responses/error/Error503Response.yaml security: - BearerAuth: [] - servers: - - url: https://api.foxentry.com - - url: https://api.foxentry.com/v2.1 diff --git a/paths/email/EmailValidate.yaml b/paths/email/EmailValidate.yaml index 70bd8b1..c74ae6c 100644 --- a/paths/email/EmailValidate.yaml +++ b/paths/email/EmailValidate.yaml @@ -9,7 +9,7 @@ post: (default) is the more advanced type that checks the real existence of the e-mail address and its deliverability. It also informs you about various flags such as freemail and disposable mail detection.

- Foxentry validator is able not only to evaluate the validity of the inputed + Foxentry validator is able not only to evaluate the validity of the entered information but it also can fix various typos, errors and missing data. Foxentry can also suggest more suitable alternatives to the data sent in query. Please pay attention to the result, resultCorrected and @@ -45,6 +45,3 @@ post: $ref: ./../../components/responses/error/Error503Response.yaml security: - BearerAuth: [] - servers: - - url: https://api.foxentry.com - - url: https://api.foxentry.com/v2.1 diff --git a/paths/location/LocationGet.yaml b/paths/location/LocationGet.yaml index fc66113..24128cf 100644 --- a/paths/location/LocationGet.yaml +++ b/paths/location/LocationGet.yaml @@ -37,6 +37,3 @@ post: $ref: ./../../components/responses/error/Error503Response.yaml security: - BearerAuth: [] - servers: - - url: https://api.foxentry.com - - url: https://api.foxentry.com/v2.1 diff --git a/paths/location/LocationLocalize.yaml b/paths/location/LocationLocalize.yaml index 8bca40b..38e890d 100644 --- a/paths/location/LocationLocalize.yaml +++ b/paths/location/LocationLocalize.yaml @@ -37,6 +37,3 @@ post: $ref: ./../../components/responses/error/Error503Response.yaml security: - BearerAuth: [] - servers: - - url: https://api.foxentry.com - - url: https://api.foxentry.com/v2.1 diff --git a/paths/location/LocationSearch.yaml b/paths/location/LocationSearch.yaml index bb4102d..45d0802 100644 --- a/paths/location/LocationSearch.yaml +++ b/paths/location/LocationSearch.yaml @@ -38,6 +38,3 @@ post: $ref: ./../../components/responses/error/Error503Response.yaml security: - BearerAuth: [] - servers: - - url: https://api.foxentry.com - - url: https://api.foxentry.com/v2.1 diff --git a/paths/location/LocationValidate.yaml b/paths/location/LocationValidate.yaml index 7c6a2b4..5e8ee35 100644 --- a/paths/location/LocationValidate.yaml +++ b/paths/location/LocationValidate.yaml @@ -6,7 +6,7 @@ post: This endpoint requires at least 1 query parameter and will check if the parameters and their combinations are valid. Returns information about the location based on the datascope set in the options.

Foxentry - validator is able not only to evaluate the validity of the inputed + validator is able not only to evaluate the validity of the entered information but it also can fix various typos, errors and missing data. Foxentry can also suggest more suitable alternatives to the data sent in query. Please pay attention to the result, resultCorrected and @@ -42,6 +42,3 @@ post: $ref: ./../../components/responses/error/Error503Response.yaml security: - BearerAuth: [] - servers: - - url: https://api.foxentry.com - - url: https://api.foxentry.com/v2.1 diff --git a/paths/name/NameValidate.yaml b/paths/name/NameValidate.yaml index 4363c8a..52055ee 100644 --- a/paths/name/NameValidate.yaml +++ b/paths/name/NameValidate.yaml @@ -11,7 +11,7 @@ post: based on your use case. For example you''d want minimal validationDepth for web forms since you usually don''t want to disturb the user too much with error messages and suggestions.

Foxentry validator is able not - only to evaluate the validity of the inputed information but it also can fix + only to evaluate the validity of the entered information but it also can fix various typos, errors and missing data. Foxentry can also suggest more suitable alternatives to the data sent in query. Please pay attention to the result, resultCorrected and suggestions in the @@ -47,6 +47,3 @@ post: $ref: ./../../components/responses/error/Error503Response.yaml security: - BearerAuth: [] - servers: - - url: https://api.foxentry.com - - url: https://api.foxentry.com/v2.1 diff --git a/paths/phone/PhoneSearch.yaml b/paths/phone/PhoneSearch.yaml index b845212..68b7798 100644 --- a/paths/phone/PhoneSearch.yaml +++ b/paths/phone/PhoneSearch.yaml @@ -35,6 +35,3 @@ post: $ref: ./../../components/responses/error/Error503Response.yaml security: - BearerAuth: [] - servers: - - url: https://api.foxentry.com - - url: https://api.foxentry.com/v2.1 diff --git a/paths/phone/PhoneValidate.yaml b/paths/phone/PhoneValidate.yaml index d19a7df..5be2f4f 100644 --- a/paths/phone/PhoneValidate.yaml +++ b/paths/phone/PhoneValidate.yaml @@ -8,7 +8,7 @@ post: based on the validationType option.

Please pay attention to the formatNumber option. This option defines the format of number that should be considered as valid.

Foxentry validator is able not - only to evaluate the validity of the inputed information but it also can fix + only to evaluate the validity of the entered information but it also can fix various typos, errors and missing data. Foxentry can also suggest more suitable alternatives to the data sent in query. Please pay attention to the result, resultCorrected and suggestions in the @@ -44,6 +44,3 @@ post: $ref: ./../../components/responses/error/Error503Response.yaml security: - BearerAuth: [] - servers: - - url: https://api.foxentry.com - - url: https://api.foxentry.com/v2.1 From 81d063d93865f6fc6410aadf0d4d0d5306aefda3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Pavel=20Hrdli=C4=8Dka?= Date: Tue, 21 Jul 2026 16:31:10 +0200 Subject: [PATCH 2/2] Address review: document full proposal value list, restore bundle.sh fail-fast, reword registration --- bundle.sh | 5 +++ .../company/CompanyValidationResult.yaml | 24 ++++++++++--- .../results/email/EmailValidationResult.yaml | 36 +++++++++++++++++-- .../location/LocationValidationResult.yaml | 23 +++++++++--- .../results/name/NameValidationResult.yaml | 24 ++++++++++--- .../results/phone/PhoneValidationResult.yaml | 24 ++++++++++--- .../validationErrors/ErrorValueGlobal.yaml | 6 ---- openapi.yaml | 4 +-- 8 files changed, 119 insertions(+), 27 deletions(-) diff --git a/bundle.sh b/bundle.sh index 848bf24..f36b96f 100755 --- a/bundle.sh +++ b/bundle.sh @@ -7,6 +7,11 @@ if [ -z "$GENERATE_EXAMPLES" ]; then else echo "Generating examples" (cd ./requests && ./generate-examples.sh) + # Fail if previous command failed + if [ $? -ne 0 ]; then + echo "Failed to generate examples" + exit 1 + fi fi redocly bundle openapi.yaml -o openapi-bundled.yaml diff --git a/components/schemas/results/company/CompanyValidationResult.yaml b/components/schemas/results/company/CompanyValidationResult.yaml index 8dce4fb..bab52f2 100644 --- a/components/schemas/results/company/CompanyValidationResult.yaml +++ b/components/schemas/results/company/CompanyValidationResult.yaml @@ -17,14 +17,30 @@ properties: - 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 8e31ecd..0d2a3af 100644 --- a/components/schemas/results/email/EmailValidationResult.yaml +++ b/components/schemas/results/email/EmailValidationResult.yaml @@ -17,15 +17,45 @@ properties: - 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 3c52465..1b3f2e7 100644 --- a/components/schemas/results/location/LocationValidationResult.yaml +++ b/components/schemas/results/location/LocationValidationResult.yaml @@ -17,15 +17,30 @@ properties: - valid - validWithSuggestion - invalid - - invalidWithCorrection - - invalidWithPartialCorrection - invalidWithSuggestion + - invalidWithCorrection - invalidWithCorrectionWithSuggestion + - invalidWithPartialCorrection - invalidWithPartialCorrectionWithSuggestion - 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 7a7722c..8a71a58 100644 --- a/components/schemas/results/name/NameValidationResult.yaml +++ b/components/schemas/results/name/NameValidationResult.yaml @@ -17,14 +17,30 @@ properties: - 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 3796434..0d18a51 100644 --- a/components/schemas/results/phone/PhoneValidationResult.yaml +++ b/components/schemas/results/phone/PhoneValidationResult.yaml @@ -17,14 +17,30 @@ properties: - 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: 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/ErrorValueGlobal.yaml b/components/schemas/validationErrors/ErrorValueGlobal.yaml index e8ac269..d674a78 100644 --- a/components/schemas/validationErrors/ErrorValueGlobal.yaml +++ b/components/schemas/validationErrors/ErrorValueGlobal.yaml @@ -40,11 +40,5 @@ properties: type: - string - "null" - 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. description: Description of error. example: Value is empty. diff --git a/openapi.yaml b/openapi.yaml index 3195e61..4fc7edb 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -113,8 +113,8 @@ info: As part of our commitment to data security, you are required to obtain a Bearer token from Foxentry. If you are a new user and do not have an - API key, please fill out our registration form at - https://app.foxentry.com/registration. + API key, create your account at https://app.foxentry.com/registration and + generate the key in your project settings. ## Need help?