From 980b5bd082a71d2e225170c5d1efe14985c5a9b2 Mon Sep 17 00:00:00 2001 From: Jason Gardella Date: Tue, 17 Feb 2026 15:08:46 -0500 Subject: [PATCH 1/2] feat: Add all supported languages to Translate API source_lang and target_lang specs Updates the SourceLanguage and TargetLanguage schemas to include the complete list of supported language codes, expanding from ~30 to the full set of available languages. Co-Authored-By: Claude Sonnet 4.5 --- CHANGELOG.md | 1 + openapi.json | 349 +++++++++++++++++++++++++++++++++++- openapi.yaml | 489 +++++++++++++++++++++++++++++++++++---------------- 3 files changed, 683 insertions(+), 156 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 8901738..f9b4be7 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -21,6 +21,7 @@ typos, schema fixes, or adding examples. * Renamed `SourceDataChunk` and `EndOfSourceData` to `SourceMediaChunk` and `EndOfSourceMedia` * * Fixes the usage endpoint response object name. Should be `key_usages` and `key_and_day_usages` instead of `grouped_usage` +* Add all supported languages to Translate API `source_lang` and `target_lang` specs ### Deprecated * Removed the `openapi_gitbook.yaml` file due to redundancy. Please use `openapi.yaml` going forward diff --git a/openapi.json b/openapi.json index 5b14f52..a5fbd91 100644 --- a/openapi.json +++ b/openapi.json @@ -5549,78 +5549,243 @@ }, "SourceLanguage": { "type": "string", - "description": "Language of the text to be translated. Options currently available:\n * `AR` - Arabic\n * `BG` - Bulgarian\n * `CS` - Czech\n * `DA` - Danish\n * `DE` - German\n * `EL` - Greek\n * `EN` - English\n * `ES` - Spanish\n * `ET` - Estonian\n * `FI` - Finnish\n * `FR` - French\n * `HU` - Hungarian\n * `ID` - Indonesian\n * `IT` - Italian\n * `JA` - Japanese\n * `KO` - Korean\n * `LT` - Lithuanian\n * `LV` - Latvian\n * `NB` - Norwegian (Bokm\u00e5l)\n * `NL` - Dutch\n * `PL` - Polish\n * `PT` - Portuguese (all Portuguese varieties mixed)\n * `RO` - Romanian\n * `RU` - Russian\n * `SK` - Slovak\n * `SL` - Slovenian\n * `SV` - Swedish\n * `TR` - Turkish\n * `UK` - Ukrainian\n * `ZH` - Chinese\n\nIf this parameter is omitted, the API will attempt to detect the language of the text and translate it.", + "description": "Language of the text to be translated. If this parameter is omitted, the API will attempt to detect the language of the text and translate it.\n\n**Note:** Some languages only work with `model_type` set to `quality_optimized`. See [supported languages](https://developers.deepl.com/docs/getting-started/supported-languages) for more details.", "enum": [ + "ACE", + "AF", + "AN", "AR", + "AS", + "AY", + "AZ", + "BA", + "BE", "BG", + "BHO", + "BN", + "BR", + "BS", + "CA", + "CEB", + "CKB", "CS", + "CY", "DA", "DE", "EL", "EN", + "EO", "ES", "ET", + "EU", + "FA", "FI", "FR", + "GA", + "GL", + "GN", + "GOM", + "GU", + "HA", + "HE", + "HI", + "HR", + "HT", "HU", + "HY", "ID", + "IG", + "IS", "IT", "JA", + "JV", + "KA", + "KK", + "KMR", "KO", + "KY", + "LA", + "LB", + "LMO", + "LN", "LT", "LV", + "MAI", + "MG", + "MI", + "MK", + "ML", + "MN", + "MR", + "MS", + "MT", + "MY", "NB", + "NE", "NL", + "OC", + "OM", + "PA", + "PAG", + "PAM", "PL", + "PRS", + "PS", "PT", + "QU", "RO", "RU", + "SA", + "SCN", "SK", "SL", + "SQ", + "SR", + "ST", + "SU", "SV", + "SW", + "TA", + "TE", + "TG", + "TH", + "TK", + "TL", + "TN", "TR", + "TS", + "TT", "UK", - "ZH" + "UR", + "UZ", + "VI", + "WO", + "XH", + "YI", + "YUE", + "ZH", + "ZU" ], "example": "EN" }, "SourceLanguageText": { "type": "string", - "description": "Language of the text to be translated. Options currently available:\n * `AR` - Arabic\n * `BG` - Bulgarian\n * `CS` - Czech\n * `DA` - Danish\n * `DE` - German\n * `EL` - Greek\n * `EN` - English\n * `ES` - Spanish\n * `ET` - Estonian\n * `FI` - Finnish\n * `FR` - French\n * `HE` - Hebrew\n * `HU` - Hungarian\n * `ID` - Indonesian\n * `IT` - Italian\n * `JA` - Japanese\n * `KO` - Korean\n * `LT` - Lithuanian\n * `LV` - Latvian\n * `NB` - Norwegian (Bokm\u00e5l)\n * `NL` - Dutch\n * `PL` - Polish\n * `PT` - Portuguese (all Portuguese varieties mixed)\n * `RO` - Romanian\n * `RU` - Russian\n * `SK` - Slovak\n * `SL` - Slovenian\n * `SV` - Swedish\n * `TH` - Thai\n * `TR` - Turkish\n * `UK` - Ukrainian\n * `VI` - Vietnamese\n * `ZH` - Chinese\n\nIf this parameter is omitted, the API will attempt to detect the language of the text and translate it.", + "description": "Language of the text to be translated. If this parameter is omitted, the API will attempt to detect the language of the text and translate it.\n\n**Note:** Some languages only work with `model_type` set to `quality_optimized`. See [supported languages](https://developers.deepl.com/docs/getting-started/supported-languages) for more details.", "enum": [ + "ACE", + "AF", + "AN", "AR", + "AS", + "AY", + "AZ", + "BA", + "BE", "BG", + "BHO", + "BN", + "BR", + "BS", + "CA", + "CEB", + "CKB", "CS", + "CY", "DA", "DE", "EL", "EN", + "EO", "ES", "ET", + "EU", + "FA", "FI", "FR", + "GA", + "GL", + "GN", + "GOM", + "GU", + "HA", "HE", + "HI", + "HR", + "HT", "HU", + "HY", "ID", + "IG", + "IS", "IT", "JA", + "JV", + "KA", + "KK", + "KMR", "KO", + "KY", + "LA", + "LB", + "LMO", + "LN", "LT", "LV", + "MAI", + "MG", + "MI", + "MK", + "ML", + "MN", + "MR", + "MS", + "MT", + "MY", "NB", + "NE", "NL", + "OC", + "OM", + "PA", + "PAG", + "PAM", "PL", + "PRS", + "PS", "PT", + "QU", "RO", "RU", + "SA", + "SCN", "SK", "SL", + "SQ", + "SR", + "ST", + "SU", "SV", + "SW", + "TA", + "TE", + "TG", "TH", + "TK", + "TL", + "TN", "TR", + "TS", + "TT", "UK", + "UR", + "UZ", "VI", - "ZH" + "WO", + "XH", + "YI", + "YUE", + "ZH", + "ZU" ], "example": "EN" }, @@ -5799,88 +5964,254 @@ }, "TargetLanguage": { "type": "string", - "description": "The language into which the text should be translated. Options currently available:\n * `AR` - Arabic\n * `BG` - Bulgarian\n * `CS` - Czech\n * `DA` - Danish\n * `DE` - German\n * `EL` - Greek\n * `EN` - English (unspecified variant for backward compatibility; please select `EN-GB` or `EN-US` instead)\n * `EN-GB` - English (British)\n * `EN-US` - English (American)\n * `ES` - Spanish\n * `ES-419` - Spanish (Latin American)\n * `ET` - Estonian\n * `FI` - Finnish\n * `FR` - French\n * `HU` - Hungarian\n * `ID` - Indonesian\n * `IT` - Italian\n * `JA` - Japanese\n * `KO` - Korean\n * `LT` - Lithuanian\n * `LV` - Latvian\n * `NB` - Norwegian (Bokm\u00e5l)\n * `NL` - Dutch\n * `PL` - Polish\n * `PT` - Portuguese (unspecified variant for backward compatibility; please select `PT-BR` or `PT-PT` instead)\n * `PT-BR` - Portuguese (Brazilian)\n * `PT-PT` - Portuguese (all Portuguese varieties excluding Brazilian Portuguese)\n * `RO` - Romanian\n * `RU` - Russian\n * `SK` - Slovak\n * `SL` - Slovenian\n * `SV` - Swedish\n * `TR` - Turkish\n * `UK` - Ukrainian\n * `ZH` - Chinese (unspecified variant for backward compatibility; please select `ZH-HANS` instead)\n * `ZH-HANS` - Chinese (simplified)\n * `ZH-HANT` - Chinese (traditional)", + "description": "The language into which the text should be translated.\n\n**Note:** Some languages only work with `model_type` set to `quality_optimized`. See [supported languages](https://developers.deepl.com/docs/getting-started/supported-languages) for more details.", "enum": [ + "ACE", + "AF", + "AN", "AR", + "AS", + "AY", + "AZ", + "BA", + "BE", "BG", + "BHO", + "BN", + "BR", + "BS", + "CA", + "CEB", + "CKB", "CS", + "CY", "DA", "DE", "EL", + "EN", "EN-GB", "EN-US", + "EO", "ES", "ES-419", "ET", + "EU", + "FA", "FI", "FR", + "GA", + "GL", + "GN", + "GOM", + "GU", + "HA", + "HE", + "HI", + "HR", + "HT", "HU", + "HY", "ID", + "IG", + "IS", "IT", "JA", + "JV", + "KA", + "KK", + "KMR", "KO", + "KY", + "LA", + "LB", + "LMO", + "LN", "LT", "LV", + "MAI", + "MG", + "MI", + "MK", + "ML", + "MN", + "MR", + "MS", + "MT", + "MY", "NB", + "NE", "NL", + "OC", + "OM", + "PA", + "PAG", + "PAM", "PL", + "PRS", + "PS", + "PT", "PT-BR", "PT-PT", + "QU", "RO", "RU", + "SA", + "SCN", "SK", "SL", + "SQ", + "SR", + "ST", + "SU", "SV", + "SW", + "TA", + "TE", + "TG", + "TH", + "TK", + "TL", + "TN", "TR", + "TS", + "TT", "UK", + "UR", + "UZ", + "VI", + "WO", + "XH", + "YI", + "YUE", "ZH", "ZH-HANS", - "ZH-HANT" + "ZH-HANT", + "ZU" ], "example": "DE" }, "TargetLanguageText": { "type": "string", - "description": "The language into which the text should be translated. Options currently available:\n * `AR` - Arabic\n * `BG` - Bulgarian\n * `CS` - Czech\n * `DA` - Danish\n * `DE` - German\n * `EL` - Greek\n * `EN` - English (unspecified variant for backward compatibility; please select `EN-GB` or `EN-US` instead)\n * `EN-GB` - English (British)\n * `EN-US` - English (American)\n * `ES` - Spanish\n * `ES-419` - Spanish (Latin American)\n * `ET` - Estonian\n * `FI` - Finnish\n * `FR` - French\n * `HE` - Hebrew\n * `HU` - Hungarian\n * `ID` - Indonesian\n * `IT` - Italian\n * `JA` - Japanese\n * `KO` - Korean\n * `LT` - Lithuanian\n * `LV` - Latvian\n * `NB` - Norwegian (Bokm\u00e5l)\n * `NL` - Dutch\n * `PL` - Polish\n * `PT` - Portuguese (unspecified variant for backward compatibility; please select `PT-BR` or `PT-PT` instead)\n * `PT-BR` - Portuguese (Brazilian)\n * `PT-PT` - Portuguese (all Portuguese variants excluding Brazilian Portuguese)\n * `RO` - Romanian\n * `RU` - Russian\n * `SK` - Slovak\n * `SL` - Slovenian\n * `SV` - Swedish\n * `TH` - Thai\n * `TR` - Turkish\n * `UK` - Ukrainian\n * `VI` - Vietnamese\n * `ZH` - Chinese (unspecified variant for backward compatibility; please select `ZH-HANS` or `ZH-HANT` instead)\n * `ZH-HANS` - Chinese (simplified)\n * `ZH-HANT` - Chinese (traditional)", + "description": "The language into which the text should be translated.\n\n**Note:** Some languages only work with `model_type` set to `quality_optimized`. See [supported languages](https://developers.deepl.com/docs/getting-started/supported-languages) for more details.", "enum": [ + "ACE", + "AF", + "AN", "AR", + "AS", + "AY", + "AZ", + "BA", + "BE", "BG", + "BHO", + "BN", + "BR", + "BS", + "CA", + "CEB", + "CKB", "CS", + "CY", "DA", "DE", "EL", "EN-GB", "EN-US", + "EO", "ES", "ES-419", "ET", + "EU", + "FA", "FI", "FR", + "GA", + "GL", + "GN", + "GOM", + "GU", + "HA", "HE", + "HI", + "HR", + "HT", "HU", + "HY", "ID", + "IG", + "IS", "IT", "JA", + "JV", + "KA", + "KK", + "KMR", "KO", + "KY", + "LA", + "LB", + "LMO", + "LN", "LT", "LV", + "MAI", + "MG", + "MI", + "MK", + "ML", + "MN", + "MR", + "MS", + "MT", + "MY", "NB", + "NE", "NL", + "OC", + "OM", + "PA", + "PAG", + "PAM", "PL", + "PRS", + "PS", "PT-BR", "PT-PT", + "QU", "RO", "RU", + "SA", + "SCN", "SK", "SL", + "SQ", + "SR", + "ST", + "SU", "SV", + "SW", + "TA", + "TE", + "TG", "TH", + "TK", + "TL", + "TN", "TR", + "TS", + "TT", "UK", + "UR", + "UZ", "VI", - "ZH", + "WO", + "XH", + "YI", + "YUE", "ZH-HANS", - "ZH-HANT" + "ZH-HANT", + "ZU" ], "example": "DE" }, diff --git a/openapi.yaml b/openapi.yaml index 79026af..faee89a 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -4253,144 +4253,246 @@ components: SourceLanguage: type: string description: |- - Language of the text to be translated. Options currently available: - * `AR` - Arabic - * `BG` - Bulgarian - * `CS` - Czech - * `DA` - Danish - * `DE` - German - * `EL` - Greek - * `EN` - English - * `ES` - Spanish - * `ET` - Estonian - * `FI` - Finnish - * `FR` - French - * `HU` - Hungarian - * `ID` - Indonesian - * `IT` - Italian - * `JA` - Japanese - * `KO` - Korean - * `LT` - Lithuanian - * `LV` - Latvian - * `NB` - Norwegian (Bokmål) - * `NL` - Dutch - * `PL` - Polish - * `PT` - Portuguese (all Portuguese varieties mixed) - * `RO` - Romanian - * `RU` - Russian - * `SK` - Slovak - * `SL` - Slovenian - * `SV` - Swedish - * `TR` - Turkish - * `UK` - Ukrainian - * `ZH` - Chinese + Language of the text to be translated. If this parameter is omitted, the API will attempt to detect the language of the text and translate it. - If this parameter is omitted, the API will attempt to detect the language of the text and translate it. + **Note:** Some languages only work with `model_type` set to `quality_optimized`. See [supported languages](https://developers.deepl.com/docs/getting-started/supported-languages) for more details. enum: + - ACE + - AF + - AN - AR + - AS + - AY + - AZ + - BA + - BE - BG + - BHO + - BN + - BR + - BS + - CA + - CEB + - CKB - CS + - CY - DA - DE - EL - EN + - EO - ES - ET + - EU + - FA - FI - FR + - GA + - GL + - GN + - GOM + - GU + - HA + - HE + - HI + - HR + - HT - HU + - HY - ID + - IG + - IS - IT - JA + - JV + - KA + - KK + - KMR - KO + - KY + - LA + - LB + - LMO + - LN - LT - LV + - MAI + - MG + - MI + - MK + - ML + - MN + - MR + - MS + - MT + - MY - NB + - NE - NL + - OC + - OM + - PA + - PAG + - PAM - PL + - PRS + - PS - PT + - QU - RO - RU + - SA + - SCN - SK - SL + - SQ + - SR + - ST + - SU - SV + - SW + - TA + - TE + - TG + - TH + - TK + - TL + - TN - TR + - TS + - TT - UK + - UR + - UZ + - VI + - WO + - XH + - YI + - YUE - ZH + - ZU example: EN SourceLanguageText: type: string description: |- - Language of the text to be translated. Options currently available: - * `AR` - Arabic - * `BG` - Bulgarian - * `CS` - Czech - * `DA` - Danish - * `DE` - German - * `EL` - Greek - * `EN` - English - * `ES` - Spanish - * `ET` - Estonian - * `FI` - Finnish - * `FR` - French - * `HE` - Hebrew - * `HU` - Hungarian - * `ID` - Indonesian - * `IT` - Italian - * `JA` - Japanese - * `KO` - Korean - * `LT` - Lithuanian - * `LV` - Latvian - * `NB` - Norwegian (Bokmål) - * `NL` - Dutch - * `PL` - Polish - * `PT` - Portuguese (all Portuguese varieties mixed) - * `RO` - Romanian - * `RU` - Russian - * `SK` - Slovak - * `SL` - Slovenian - * `SV` - Swedish - * `TH` - Thai - * `TR` - Turkish - * `UK` - Ukrainian - * `VI` - Vietnamese - * `ZH` - Chinese + Language of the text to be translated. If this parameter is omitted, the API will attempt to detect the language of the text and translate it. - If this parameter is omitted, the API will attempt to detect the language of the text and translate it. + **Note:** Some languages only work with `model_type` set to `quality_optimized`. See [supported languages](https://developers.deepl.com/docs/getting-started/supported-languages) for more details. enum: + - ACE + - AF + - AN - AR + - AS + - AY + - AZ + - BA + - BE - BG + - BHO + - BN + - BR + - BS + - CA + - CEB + - CKB - CS + - CY - DA - DE - EL - EN + - EO - ES - ET + - EU + - FA - FI - FR + - GA + - GL + - GN + - GOM + - GU + - HA - HE + - HI + - HR + - HT - HU + - HY - ID + - IG + - IS - IT - JA + - JV + - KA + - KK + - KMR - KO + - KY + - LA + - LB + - LMO + - LN - LT - LV + - MAI + - MG + - MI + - MK + - ML + - MN + - MR + - MS + - MT + - MY - NB + - NE - NL + - OC + - OM + - PA + - PAG + - PAM - PL + - PRS + - PS - PT + - QU - RO - RU + - SA + - SCN - SK - SL + - SQ + - SR + - ST + - SU - SV + - SW + - TA + - TE + - TG - TH + - TK + - TL + - TN - TR + - TS + - TT - UK + - UR + - UZ - VI + - WO + - XH + - YI + - YUE - ZH + - ZU example: EN TagHandlingOption: description: |- @@ -4606,164 +4708,257 @@ components: TargetLanguage: type: string description: |- - The language into which the text should be translated. Options currently available: - * `AR` - Arabic - * `BG` - Bulgarian - * `CS` - Czech - * `DA` - Danish - * `DE` - German - * `EL` - Greek - * `EN` - English (unspecified variant for backward compatibility; please select `EN-GB` or `EN-US` instead) - * `EN-GB` - English (British) - * `EN-US` - English (American) - * `ES` - Spanish - * `ES-419` - Spanish (Latin American) - * `ET` - Estonian - * `FI` - Finnish - * `FR` - French - * `HU` - Hungarian - * `ID` - Indonesian - * `IT` - Italian - * `JA` - Japanese - * `KO` - Korean - * `LT` - Lithuanian - * `LV` - Latvian - * `NB` - Norwegian (Bokmål) - * `NL` - Dutch - * `PL` - Polish - * `PT` - Portuguese (unspecified variant for backward compatibility; please select `PT-BR` or `PT-PT` instead) - * `PT-BR` - Portuguese (Brazilian) - * `PT-PT` - Portuguese (all Portuguese varieties excluding Brazilian Portuguese) - * `RO` - Romanian - * `RU` - Russian - * `SK` - Slovak - * `SL` - Slovenian - * `SV` - Swedish - * `TR` - Turkish - * `UK` - Ukrainian - * `ZH` - Chinese (unspecified variant for backward compatibility; please select `ZH-HANS` instead) - * `ZH-HANS` - Chinese (simplified) - * `ZH-HANT` - Chinese (traditional) + The language into which the text should be translated. + + **Note:** Some languages only work with `model_type` set to `quality_optimized`. See [supported languages](https://developers.deepl.com/docs/getting-started/supported-languages) for more details. enum: + - ACE + - AF + - AN - AR + - AS + - AY + - AZ + - BA + - BE - BG + - BHO + - BN + - BR + - BS + - CA + - CEB + - CKB - CS + - CY - DA - DE - EL + - EN - EN-GB - EN-US + - EO - ES - ES-419 - ET + - EU + - FA - FI - FR + - GA + - GL + - GN + - GOM + - GU + - HA + - HE + - HI + - HR + - HT - HU + - HY - ID + - IG + - IS - IT - JA + - JV + - KA + - KK + - KMR - KO + - KY + - LA + - LB + - LMO + - LN - LT - LV + - MAI + - MG + - MI + - MK + - ML + - MN + - MR + - MS + - MT + - MY - NB + - NE - NL + - OC + - OM + - PA + - PAG + - PAM - PL + - PRS + - PS + - PT - PT-BR - PT-PT + - QU - RO - RU + - SA + - SCN - SK - SL + - SQ + - SR + - ST + - SU - SV + - SW + - TA + - TE + - TG + - TH + - TK + - TL + - TN - TR + - TS + - TT - UK + - UR + - UZ + - VI + - WO + - XH + - YI + - YUE - ZH - ZH-HANS - ZH-HANT + - ZU example: DE TargetLanguageText: type: string description: |- - The language into which the text should be translated. Options currently available: - * `AR` - Arabic - * `BG` - Bulgarian - * `CS` - Czech - * `DA` - Danish - * `DE` - German - * `EL` - Greek - * `EN` - English (unspecified variant for backward compatibility; please select `EN-GB` or `EN-US` instead) - * `EN-GB` - English (British) - * `EN-US` - English (American) - * `ES` - Spanish - * `ES-419` - Spanish (Latin American) - * `ET` - Estonian - * `FI` - Finnish - * `FR` - French - * `HE` - Hebrew - * `HU` - Hungarian - * `ID` - Indonesian - * `IT` - Italian - * `JA` - Japanese - * `KO` - Korean - * `LT` - Lithuanian - * `LV` - Latvian - * `NB` - Norwegian (Bokmål) - * `NL` - Dutch - * `PL` - Polish - * `PT` - Portuguese (unspecified variant for backward compatibility; please select `PT-BR` or `PT-PT` instead) - * `PT-BR` - Portuguese (Brazilian) - * `PT-PT` - Portuguese (all Portuguese variants excluding Brazilian Portuguese) - * `RO` - Romanian - * `RU` - Russian - * `SK` - Slovak - * `SL` - Slovenian - * `SV` - Swedish - * `TH` - Thai - * `TR` - Turkish - * `UK` - Ukrainian - * `VI` - Vietnamese - * `ZH` - Chinese (unspecified variant for backward compatibility; please select `ZH-HANS` or `ZH-HANT` instead) - * `ZH-HANS` - Chinese (simplified) - * `ZH-HANT` - Chinese (traditional) + The language into which the text should be translated. + + **Note:** Some languages only work with `model_type` set to `quality_optimized`. See [supported languages](https://developers.deepl.com/docs/getting-started/supported-languages) for more details. enum: + - ACE + - AF + - AN - AR + - AS + - AY + - AZ + - BA + - BE - BG + - BHO + - BN + - BR + - BS + - CA + - CEB + - CKB - CS + - CY - DA - DE - EL - EN-GB - EN-US + - EO - ES - ES-419 - ET + - EU + - FA - FI - FR + - GA + - GL + - GN + - GOM + - GU + - HA - HE + - HI + - HR + - HT - HU + - HY - ID + - IG + - IS - IT - JA + - JV + - KA + - KK + - KMR - KO + - KY + - LA + - LB + - LMO + - LN - LT - LV + - MAI + - MG + - MI + - MK + - ML + - MN + - MR + - MS + - MT + - MY - NB + - NE - NL + - OC + - OM + - PA + - PAG + - PAM - PL + - PRS + - PS - PT-BR - PT-PT + - QU - RO - RU + - SA + - SCN - SK - SL + - SQ + - SR + - ST + - SU - SV + - SW + - TA + - TE + - TG - TH + - TK + - TL + - TN - TR + - TS + - TT - UK + - UR + - UZ - VI - - ZH + - WO + - XH + - YI + - YUE - ZH-HANS - ZH-HANT + - ZU example: DE TargetLanguageWrite: type: string From 3f6bc661e98577a9adce4c40751379473b162153 Mon Sep 17 00:00:00 2001 From: Jason Gardella Date: Tue, 17 Feb 2026 15:25:53 -0500 Subject: [PATCH 2/2] refactor: Merge duplicate SourceLanguageText schema into SourceLanguage Consolidates the redundant SourceLanguageText and SourceLanguage schemas into a single SourceLanguage schema. After the previous commit expanded both schemas to include the same 112 language codes, these schemas became identical and maintaining both added unnecessary duplication. Changes: - Replace all references to SourceLanguageText with SourceLanguage - Remove SourceLanguageText schema definition from both YAML and JSON specs - Update CHANGELOG to document this refactoring This simplifies maintenance by ensuring there's only one source language schema to update when languages are added or modified. Co-Authored-By: Claude Sonnet 4.5 --- CHANGELOG.md | 1 + openapi.json | 254 +------------------------------------------------- openapi.yaml | 256 +-------------------------------------------------- 3 files changed, 9 insertions(+), 502 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index f9b4be7..9c1e6de 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -22,6 +22,7 @@ typos, schema fixes, or adding examples. * * Fixes the usage endpoint response object name. Should be `key_usages` and `key_and_day_usages` instead of `grouped_usage` * Add all supported languages to Translate API `source_lang` and `target_lang` specs +* Merge redundant `SourceLanguageText` and `TargetLanguageText` schemas into `SourceLanguage` and `TargetLanguage` to eliminate duplication ### Deprecated * Removed the `openapi_gitbook.yaml` file due to redundancy. Please use `openapi.yaml` going forward diff --git a/openapi.json b/openapi.json index a5fbd91..dcfd718 100644 --- a/openapi.json +++ b/openapi.json @@ -83,10 +83,10 @@ } }, "source_lang": { - "$ref": "#/components/schemas/SourceLanguageText" + "$ref": "#/components/schemas/SourceLanguage" }, "target_lang": { - "$ref": "#/components/schemas/TargetLanguageText" + "$ref": "#/components/schemas/TargetLanguage" }, "context": { "$ref": "#/components/schemas/Context" @@ -206,10 +206,10 @@ } }, "source_lang": { - "$ref": "#/components/schemas/SourceLanguageText" + "$ref": "#/components/schemas/SourceLanguage" }, "target_lang": { - "$ref": "#/components/schemas/TargetLanguageText" + "$ref": "#/components/schemas/TargetLanguage" }, "context": { "$ref": "#/components/schemas/Context" @@ -5668,127 +5668,6 @@ ], "example": "EN" }, - "SourceLanguageText": { - "type": "string", - "description": "Language of the text to be translated. If this parameter is omitted, the API will attempt to detect the language of the text and translate it.\n\n**Note:** Some languages only work with `model_type` set to `quality_optimized`. See [supported languages](https://developers.deepl.com/docs/getting-started/supported-languages) for more details.", - "enum": [ - "ACE", - "AF", - "AN", - "AR", - "AS", - "AY", - "AZ", - "BA", - "BE", - "BG", - "BHO", - "BN", - "BR", - "BS", - "CA", - "CEB", - "CKB", - "CS", - "CY", - "DA", - "DE", - "EL", - "EN", - "EO", - "ES", - "ET", - "EU", - "FA", - "FI", - "FR", - "GA", - "GL", - "GN", - "GOM", - "GU", - "HA", - "HE", - "HI", - "HR", - "HT", - "HU", - "HY", - "ID", - "IG", - "IS", - "IT", - "JA", - "JV", - "KA", - "KK", - "KMR", - "KO", - "KY", - "LA", - "LB", - "LMO", - "LN", - "LT", - "LV", - "MAI", - "MG", - "MI", - "MK", - "ML", - "MN", - "MR", - "MS", - "MT", - "MY", - "NB", - "NE", - "NL", - "OC", - "OM", - "PA", - "PAG", - "PAM", - "PL", - "PRS", - "PS", - "PT", - "QU", - "RO", - "RU", - "SA", - "SCN", - "SK", - "SL", - "SQ", - "SR", - "ST", - "SU", - "SV", - "SW", - "TA", - "TE", - "TG", - "TH", - "TK", - "TL", - "TN", - "TR", - "TS", - "TT", - "UK", - "UR", - "UZ", - "VI", - "WO", - "XH", - "YI", - "YUE", - "ZH", - "ZU" - ], - "example": "EN" - }, "TagHandlingOption": { "description": "Sets which kind of tags should be handled. Options currently available:\n * `xml`: Enable XML tag handling; see [XML Handling](https://www.deepl.com/docs-api/xml).\n * `html`: Enable HTML tag handling; see [HTML Handling](https://www.deepl.com/docs-api/html).", "type": "string", @@ -6090,131 +5969,6 @@ ], "example": "DE" }, - "TargetLanguageText": { - "type": "string", - "description": "The language into which the text should be translated.\n\n**Note:** Some languages only work with `model_type` set to `quality_optimized`. See [supported languages](https://developers.deepl.com/docs/getting-started/supported-languages) for more details.", - "enum": [ - "ACE", - "AF", - "AN", - "AR", - "AS", - "AY", - "AZ", - "BA", - "BE", - "BG", - "BHO", - "BN", - "BR", - "BS", - "CA", - "CEB", - "CKB", - "CS", - "CY", - "DA", - "DE", - "EL", - "EN-GB", - "EN-US", - "EO", - "ES", - "ES-419", - "ET", - "EU", - "FA", - "FI", - "FR", - "GA", - "GL", - "GN", - "GOM", - "GU", - "HA", - "HE", - "HI", - "HR", - "HT", - "HU", - "HY", - "ID", - "IG", - "IS", - "IT", - "JA", - "JV", - "KA", - "KK", - "KMR", - "KO", - "KY", - "LA", - "LB", - "LMO", - "LN", - "LT", - "LV", - "MAI", - "MG", - "MI", - "MK", - "ML", - "MN", - "MR", - "MS", - "MT", - "MY", - "NB", - "NE", - "NL", - "OC", - "OM", - "PA", - "PAG", - "PAM", - "PL", - "PRS", - "PS", - "PT-BR", - "PT-PT", - "QU", - "RO", - "RU", - "SA", - "SCN", - "SK", - "SL", - "SQ", - "SR", - "ST", - "SU", - "SV", - "SW", - "TA", - "TE", - "TG", - "TH", - "TK", - "TL", - "TN", - "TR", - "TS", - "TT", - "UK", - "UR", - "UZ", - "VI", - "WO", - "XH", - "YI", - "YUE", - "ZH-HANS", - "ZH-HANT", - "ZU" - ], - "example": "DE" - }, "TargetLanguageWrite": { "type": "string", "description": "The language for the text improvement. Options currently available:\n * `de` - German\n * `en` - English (unspecified variant, defaults to `en-US`)\n * `en-GB` - English (British)\n * `en-US` - English (American)\n * `es` - Spanish\n * `fr` - French\n * `it` - Italian\n * `pt` - Portuguese (unspecified variant, defaults to `pt-PT`)\n * `pt-BR` - Portuguese (Brazilian)\n * `pt-PT` - Portuguese (all Portuguese variants excluding Brazilian Portuguese)", diff --git a/openapi.yaml b/openapi.yaml index faee89a..36e6052 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -142,9 +142,9 @@ paths: type: string example: Hello, World! source_lang: - $ref: '#/components/schemas/SourceLanguageText' + $ref: '#/components/schemas/SourceLanguage' target_lang: - $ref: '#/components/schemas/TargetLanguageText' + $ref: '#/components/schemas/TargetLanguage' context: $ref: '#/components/schemas/Context' show_billed_characters: @@ -236,9 +236,9 @@ paths: items: type: string source_lang: - $ref: '#/components/schemas/SourceLanguageText' + $ref: '#/components/schemas/SourceLanguage' target_lang: - $ref: '#/components/schemas/TargetLanguageText' + $ref: '#/components/schemas/TargetLanguage' context: $ref: '#/components/schemas/Context' show_billed_characters: @@ -4372,128 +4372,6 @@ components: - ZH - ZU example: EN - SourceLanguageText: - type: string - description: |- - Language of the text to be translated. If this parameter is omitted, the API will attempt to detect the language of the text and translate it. - - **Note:** Some languages only work with `model_type` set to `quality_optimized`. See [supported languages](https://developers.deepl.com/docs/getting-started/supported-languages) for more details. - enum: - - ACE - - AF - - AN - - AR - - AS - - AY - - AZ - - BA - - BE - - BG - - BHO - - BN - - BR - - BS - - CA - - CEB - - CKB - - CS - - CY - - DA - - DE - - EL - - EN - - EO - - ES - - ET - - EU - - FA - - FI - - FR - - GA - - GL - - GN - - GOM - - GU - - HA - - HE - - HI - - HR - - HT - - HU - - HY - - ID - - IG - - IS - - IT - - JA - - JV - - KA - - KK - - KMR - - KO - - KY - - LA - - LB - - LMO - - LN - - LT - - LV - - MAI - - MG - - MI - - MK - - ML - - MN - - MR - - MS - - MT - - MY - - NB - - NE - - NL - - OC - - OM - - PA - - PAG - - PAM - - PL - - PRS - - PS - - PT - - QU - - RO - - RU - - SA - - SCN - - SK - - SL - - SQ - - SR - - ST - - SU - - SV - - SW - - TA - - TE - - TG - - TH - - TK - - TL - - TN - - TR - - TS - - TT - - UK - - UR - - UZ - - VI - - WO - - XH - - YI - - YUE - - ZH - - ZU - example: EN TagHandlingOption: description: |- Sets which kind of tags should be handled. Options currently available: @@ -4834,132 +4712,6 @@ components: - ZH-HANT - ZU example: DE - TargetLanguageText: - type: string - description: |- - The language into which the text should be translated. - - **Note:** Some languages only work with `model_type` set to `quality_optimized`. See [supported languages](https://developers.deepl.com/docs/getting-started/supported-languages) for more details. - enum: - - ACE - - AF - - AN - - AR - - AS - - AY - - AZ - - BA - - BE - - BG - - BHO - - BN - - BR - - BS - - CA - - CEB - - CKB - - CS - - CY - - DA - - DE - - EL - - EN-GB - - EN-US - - EO - - ES - - ES-419 - - ET - - EU - - FA - - FI - - FR - - GA - - GL - - GN - - GOM - - GU - - HA - - HE - - HI - - HR - - HT - - HU - - HY - - ID - - IG - - IS - - IT - - JA - - JV - - KA - - KK - - KMR - - KO - - KY - - LA - - LB - - LMO - - LN - - LT - - LV - - MAI - - MG - - MI - - MK - - ML - - MN - - MR - - MS - - MT - - MY - - NB - - NE - - NL - - OC - - OM - - PA - - PAG - - PAM - - PL - - PRS - - PS - - PT-BR - - PT-PT - - QU - - RO - - RU - - SA - - SCN - - SK - - SL - - SQ - - SR - - ST - - SU - - SV - - SW - - TA - - TE - - TG - - TH - - TK - - TL - - TN - - TR - - TS - - TT - - UK - - UR - - UZ - - VI - - WO - - XH - - YI - - YUE - - ZH-HANS - - ZH-HANT - - ZU - example: DE TargetLanguageWrite: type: string description: |-