papi: add more details about 0 and 1 to url encoded params for translate

Author: leoncheng57

CHANGELOG.md

@@ -9,6 +9,10 @@ The major and minor version numbers reflect changes to the DeepL API
 number is used only for corrections to the OpenAPI specification, for example:
 typos, schema fixes, or adding examples.
 
+## [3.4.1] - 2025-07-18
+### Added
+* Add note for boolean values about how to input for URL-encoded forms
+
 
 ## [3.4.0] - 2025-07-16
 ### Added
@@ -232,6 +236,7 @@ keys within an organization.
 Initial release of the OpenAPI specification.
 
 
+[3.4.1]: https://github.com/DeepLcom/openapi/compare/v3.4.0...v3.4.1
 [3.4.0]: https://github.com/DeepLcom/openapi/compare/v3.3.1...v3.4.0
 [3.3.1]: https://github.com/DeepLcom/openapi/compare/v3.3.0...v3.3.1
 [3.3.0]: https://github.com/DeepLcom/openapi/compare/v3.2.0...v3.3.0

openapi.yaml

@@ -7,7 +7,7 @@ info:
   contact:
     name: DeepL - Contact us
     url: https://www.deepl.com/contact-us
-  version: 3.4.0
+  version: 3.4.1
 externalDocs:
   description: DeepL Pro - Plans and pricing
   url: https://www.deepl.com/pro#developer
@@ -2292,6 +2292,8 @@ components:
            </document>
            ```
         While this approach is slightly more complicated, it allows for greater control over the structure of the translation output.
+
+        Note: for requests sent as URL-encoded forms, boolean values should be specified as "1" or "0".
       type: boolean
       default: true
     OutlineDetectionOptionStr:
@@ -2345,6 +2347,8 @@ components:
         The formatting aspects affected by this setting include:
          * Punctuation at the beginning and end of the sentence
          * Upper/lower case at the beginning of the sentence
+
+        Note: for requests sent as URL-encoded forms, boolean values should be specified as "1" or "0".
       type: boolean
       default: false
     PreserveFormattingOptionStr:
@@ -2367,6 +2371,8 @@ components:
       description: |-
         When true, the response will include the billed_characters parameter, giving the 
         number of characters from the request that will be counted by DeepL for billing purposes.
+
+        Note: for requests sent as URL-encoded forms, boolean values should be specified as "1" or "0".
       type: boolean
     SplitSentencesOption:
       description: |-

openapi_gitbook.yaml

@@ -9,7 +9,7 @@ info:
   contact:
     name: DeepL - Contact us
     url: https://www.deepl.com/contact-us
-  version: 3.4.0
+  version: 3.4.1
 externalDocs:
   description: DeepL Pro - Plans and pricing
   url: https://www.deepl.com/pro#developer
@@ -2123,6 +2123,8 @@ components:
         Disable the automatic detection of XML structure by setting the `outline_detection` parameter 
         to `false` and selecting the tags that should be considered structure tags. This will split sentences 
         using the `splitting_tags` parameter.
+
+        Note: for requests sent as URL-encoded forms, boolean values should be specified as "1" or "0".
       type: boolean
       default: true
     OutlineDetectionOptionStr:
@@ -2148,6 +2150,8 @@ components:
       description: |-
         Sets whether the translation engine should respect the original formatting, even if it would usually 
         correct some aspects.
+
+        Note: for requests sent as URL-encoded forms, boolean values should be specified as "1" or "0".
       type: boolean
       default: false
     PreserveFormattingOptionStr:
@@ -2165,6 +2169,8 @@ components:
       description: |-
         When true, the response will include the billed_characters parameter, giving the 
         number of characters from the request that will be counted by DeepL for billing purposes.
+
+        Note: for requests sent as URL-encoded forms, boolean values should be specified as "1" or "0".
       type: boolean  
     SplitSentencesOption:
       description: |-