docs: Increase version to 1.9.0

Author: JanEbbing

CHANGELOG.md

@@ -5,6 +5,13 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 
+## [1.9.0] - 2025-02-21
+### Added
+* Allow specifying the API version to use. This is mostly for users who have an
+  API subscription that includes an API key for CAT tool usage, who need to use
+  the v1 API.
+
+
 ## [1.8.1] - 2025-02-07
 ### Fixed
 * Added a constructor for `DeepLClient` that only takes an `authKey`, to fix the
@@ -143,6 +150,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 Initial version.
 
 
+[1.9.0]: https://github.com/DeepLcom/deepl-java/compare/v1.8.1...v1.9.0
 [1.8.1]: https://github.com/DeepLcom/deepl-java/compare/v1.8.0...v1.8.1
 [1.8.0]: https://github.com/DeepLcom/deepl-java/compare/v1.7.0...v1.8.0
 [1.7.0]: https://github.com/DeepLcom/deepl-java/compare/v1.6.0...v1.7.0

README.md

@@ -31,7 +31,7 @@ Java 1.8 or later.
 Add this dependency to your project's build file:
 
 ```
-implementation "com.deepl.api:deepl-java:1.8.1"
+implementation "com.deepl.api:deepl-java:1.9.0"
 ```
 
 ### Maven users
@@ -42,7 +42,7 @@ Add this dependency to your project's POM:
 <dependency>
   <groupId>com.deepl.api</groupId>
   <artifactId>deepl-java</artifactId>
-  <version>1.8.1</version>
+  <version>1.9.0</version>
 </dependency>
 ```
 
@@ -634,6 +634,10 @@ The available options setters are:
 - `setServerUrl()`: base URL for DeepL API, may be overridden for testing
   purposes. By default, the correct DeepL API (Free or Pro) is automatically
   selected.
+- `setApiVersion()`: Version of the DeepL API, may be overridden to use e.g.
+  the v1 API. By default, the most recent API version is automatically selected.
+  Please note: The v1 API does not support all features of the API, e.g.
+  document translation or rephrase.
 
 #### Anonymous platform information
 

deepl-java/build.gradle.kts

@@ -6,7 +6,7 @@ plugins {
 }
 
 group = "com.deepl.api"
-version = "1.8.1"
+version = "1.9.0"
 
 val sharedManifest = the<JavaPluginConvention>().manifest {
     attributes (

deepl-java/src/main/java/com/deepl/api/Translator.java

@@ -88,7 +88,7 @@ public Translator(String authKey) throws IllegalArgumentException {
    */
   private String constructUserAgentString(boolean sendPlatformInfo, AppInfo appInfo) {
     StringBuilder sb = new StringBuilder();
-    sb.append("deepl-java/1.8.1");
+    sb.append("deepl-java/1.9.0");
     if (sendPlatformInfo) {
       sb.append(" (");
       Properties props = System.getProperties();