Skip to content

Commit 3187a54

Browse files
healqqclaude
andcommitted
fix: use v3/languages endpoint instead of deprecated v2 endpoints
🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 1dc19db commit 3187a54

6 files changed

Lines changed: 91 additions & 63 deletions

File tree

‎CHANGELOG.md‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,15 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
55
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
66

77
## [Unreleased]
8+
### Changed
9+
- `getSourceLanguages()`, `getTargetLanguages()`, `getLanguages()` and
10+
`getGlossaryLanguages()` now use `GET /v3/languages` instead of the
11+
deprecated v2 endpoints. The returned lists may contain additional
12+
languages, including the bare `en` and `pt` as target languages.
13+
14+
### Fixed
15+
- `getLanguages()` no longer sends a `POST` request to `/v2/languages`; it
16+
now sends `GET`.
817

918
## [1.17.0] - 2026-08-11
1019
### Added

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

Lines changed: 4 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -300,15 +300,10 @@ public List<Language> getTargetLanguages() throws DeepLException, InterruptedExc
300300
*/
301301
public List<Language> getLanguages(LanguageType languageType)
302302
throws DeepLException, InterruptedException {
303-
ArrayList<KeyValuePair<String, String>> params = new ArrayList<>();
304-
if (languageType == LanguageType.Target) {
305-
params.add(new KeyValuePair<>("type", "target"));
306-
}
307303
HttpResponse response =
308-
httpClientWrapper.sendRequestWithBackoff(
309-
String.format("/%s/languages", apiVersion), params);
304+
httpClientWrapper.sendGetRequestWithBackoff("/v3/languages?resource=translate_text");
310305
checkResponse(response, false, false);
311-
return jsonParser.parseLanguages(response.getBody());
306+
return jsonParser.parseV3Languages(response.getBody(), languageType);
312307
}
313308

314309
/**
@@ -323,10 +318,9 @@ public List<Language> getLanguages(LanguageType languageType)
323318
public List<GlossaryLanguagePair> getGlossaryLanguages()
324319
throws DeepLException, InterruptedException {
325320
HttpResponse response =
326-
httpClientWrapper.sendGetRequestWithBackoff(
327-
String.format("/%s/glossary-language-pairs", apiVersion));
321+
httpClientWrapper.sendGetRequestWithBackoff("/v3/languages?resource=glossary");
328322
checkResponse(response, false, false);
329-
return jsonParser.parseGlossaryLanguageList(response.getBody());
323+
return jsonParser.parseV3GlossaryLanguagePairs(response.getBody());
330324
}
331325

332326
/**

‎deepl-java/src/main/java/com/deepl/api/parsing/GlossaryLanguagesResponse.java‎

Lines changed: 0 additions & 22 deletions
This file was deleted.

‎deepl-java/src/main/java/com/deepl/api/parsing/LanguageDeserializer.java‎

Lines changed: 0 additions & 25 deletions
This file was deleted.

‎deepl-java/src/main/java/com/deepl/api/parsing/Parser.java‎

Lines changed: 32 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,6 @@ public Parser() {
2626
GsonBuilder gsonBuilder = new GsonBuilder();
2727
gsonBuilder.registerTypeAdapter(TextResult.class, new TextResultDeserializer());
2828
gsonBuilder.registerTypeAdapter(WriteResult.class, new WriteResultDeserializer());
29-
gsonBuilder.registerTypeAdapter(Language.class, new LanguageDeserializer());
3029
gsonBuilder.registerTypeAdapter(Usage.class, new UsageDeserializer());
3130
gsonBuilder.registerTypeAdapter(
3231
TranslationMemoryJob.class, new TranslationMemoryJobDeserializer());
@@ -47,13 +46,40 @@ public Usage parseUsage(String json) {
4746
return gson.fromJson(json, Usage.class);
4847
}
4948

50-
public List<Language> parseLanguages(String json) {
51-
Type languageListType = new TypeToken<ArrayList<Language>>() {}.getType();
52-
return gson.fromJson(json, languageListType);
49+
public List<Language> parseV3Languages(String json, LanguageType languageType) {
50+
Type v3LanguageListType = new TypeToken<ArrayList<V3Language>>() {}.getType();
51+
List<V3Language> entries = gson.fromJson(json, v3LanguageListType);
52+
List<Language> result = new ArrayList<>();
53+
for (V3Language entry : entries) {
54+
if (languageType == LanguageType.Target) {
55+
if (!entry.isUsableAsTarget()) continue;
56+
result.add(new Language(entry.getName(), entry.getLang(), entry.hasFeature("formality")));
57+
} else {
58+
if (!entry.isUsableAsSource()) continue;
59+
result.add(new Language(entry.getName(), entry.getLang(), null));
60+
}
61+
}
62+
return result;
5363
}
5464

55-
public List<GlossaryLanguagePair> parseGlossaryLanguageList(String json) {
56-
return gson.fromJson(json, GlossaryLanguagesResponse.class).getSupportedLanguages();
65+
public List<GlossaryLanguagePair> parseV3GlossaryLanguagePairs(String json) {
66+
Type v3LanguageListType = new TypeToken<ArrayList<V3Language>>() {}.getType();
67+
List<V3Language> entries = gson.fromJson(json, v3LanguageListType);
68+
List<String> sourceCodes = new ArrayList<>();
69+
List<String> targetCodes = new ArrayList<>();
70+
for (V3Language entry : entries) {
71+
if (entry.isUsableAsSource()) sourceCodes.add(entry.getLang());
72+
if (entry.isUsableAsTarget()) targetCodes.add(entry.getLang());
73+
}
74+
List<GlossaryLanguagePair> pairs = new ArrayList<>();
75+
for (String source : sourceCodes) {
76+
for (String target : targetCodes) {
77+
if (!source.equals(target)) {
78+
pairs.add(new GlossaryLanguagePair(source, target));
79+
}
80+
}
81+
}
82+
return pairs;
5783
}
5884

5985
public DocumentStatus parseDocumentStatus(String json) {
Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
// Copyright 2026 DeepL SE (https://www.deepl.com)
2+
// Use of this source code is governed by an MIT
3+
// license that can be found in the LICENSE file.
4+
package com.deepl.api.parsing;
5+
6+
import com.google.gson.JsonElement;
7+
import com.google.gson.annotations.SerializedName;
8+
import java.util.Map;
9+
10+
/**
11+
* Class representing a single entry in a /v3/languages response.
12+
*
13+
* <p>This class is internal; you should not use this class directly.
14+
*/
15+
class V3Language {
16+
private String lang;
17+
private String name;
18+
19+
@SerializedName("usable_as_source")
20+
private boolean usableAsSource;
21+
22+
@SerializedName("usable_as_target")
23+
private boolean usableAsTarget;
24+
25+
private Map<String, JsonElement> features;
26+
27+
public String getLang() {
28+
return lang;
29+
}
30+
31+
public String getName() {
32+
return name;
33+
}
34+
35+
public boolean isUsableAsSource() {
36+
return usableAsSource;
37+
}
38+
39+
public boolean isUsableAsTarget() {
40+
return usableAsTarget;
41+
}
42+
43+
public boolean hasFeature(String featureName) {
44+
return features != null && features.containsKey(featureName);
45+
}
46+
}

0 commit comments

Comments
 (0)