Skip to content

Commit 25ec726

Browse files
Merge pull request #232237 from laujan/fix-hyperlink-translator-reference
update translator reference page hyperlink
2 parents 8bedcdf + ef46481 commit 25ec726

File tree

1 file changed

+17
-15
lines changed

1 file changed

+17
-15
lines changed

articles/cognitive-services/Translator/reference/v3-0-languages.md

Lines changed: 17 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ ms.author: lajanuar
1515

1616
# Translator 3.0: Languages
1717

18-
Gets the set of languages currently supported by other operations of the Translator.
18+
Gets the set of languages currently supported by other operations of the Translator.
1919

2020
## Request URL
2121

@@ -37,9 +37,11 @@ Request parameters passed on the query string are:
3737
</tr>
3838
<tr>
3939
<td>scope</td>
40-
<td>*Optional parameter*.<br/>A comma-separated list of names defining the group of languages to return. Allowed group names are: `translation`, `transliteration` and `dictionary`. If no scope is given, then all groups are returned, which is equivalent to passing `scope=translation,transliteration,dictionary`. To decide which set of supported languages is appropriate for your scenario, see the description of the [response object](#response-body).</td>
40+
<td>*Optional parameter*.<br/>A comma-separated list of names defining the group of languages to return. Allowed group names are: `translation`, `transliteration` and `dictionary`. If no scope is given, then all groups are returned, which is equivalent to passing `scope=translation,transliteration,dictionary`.</td>
4141
</tr>
42-
</table>
42+
</table>
43+
44+
*See* [response body](#response-body).
4345

4446
Request headers are:
4547

@@ -48,14 +50,14 @@ Request headers are:
4850
<th>Description</th>
4951
<tr>
5052
<td>Accept-Language</td>
51-
<td>*Optional request header*.<br/>The language to use for user interface strings. Some of the fields in the response are names of languages or names of regions. Use this parameter to define the language in which these names are returned. The language is specified by providing a well-formed BCP 47 language tag. For instance, use the value `fr` to request names in French or use the value `zh-Hant` to request names in Chinese Traditional.<br/>Names are provided in the English language when a target language is not specified or when localization is not available.
53+
<td>*Optional request header*.<br/>The language to use for user interface strings. Some of the fields in the response are names of languages or names of regions. Use this parameter to define the language in which these names are returned. The language is specified by providing a well-formed BCP 47 language tag. For instance, use the value `fr` to request names in French or use the value `zh-Hant` to request names in Chinese Traditional.<br/>Names are provided in the English language when a target language isn't specified or when localization isn't available.
5254
</td>
5355
</tr>
5456
<tr>
5557
<td>X-ClientTraceId</td>
5658
<td>*Optional request header*.<br/>A client-generated GUID to uniquely identify the request.</td>
5759
</tr>
58-
</table>
60+
</table>
5961

6062
Authentication isn't required to get language resources.
6163

@@ -100,7 +102,7 @@ The value for each property is as follows.
100102
* `dir`: Directionality, which is `rtl` for right-to-left languages or `ltr` for left-to-right languages.
101103

102104
An example is:
103-
105+
104106
```json
105107
{
106108
"translation": {
@@ -197,7 +199,7 @@ The value for each property is as follows.
197199
* `nativeName`: Display name of the target language in the locale native for the target language.
198200

199201
* `dir`: Directionality, which is `rtl` for right-to-left languages or `ltr` for left-to-right languages.
200-
202+
201203
* `code`: Language code identifying the target language.
202204

203205
An example is:
@@ -218,9 +220,9 @@ The value for each property is as follows.
218220
},
219221
```
220222

221-
The structure of the response object will not change without a change in the version of the API. For the same version of the API, the list of available languages may change over time because Microsoft Translator continually extends the list of languages supported by its services.
223+
The structure of the response object doesn't change without a change in the version of the API. For the same version of the API, the list of available languages may change over time because Microsoft Translator continually extends the list of languages supported by its services.
222224

223-
The list of supported languages will not change frequently. To save network bandwidth and improve responsiveness, a client application should consider caching language resources and the corresponding entity tag (`ETag`). Then, the client application can periodically (for example, once every 24 hours) query the service to fetch the latest set of supported languages. Passing the current `ETag` value in an `If-None-Match` header field will allow the service to optimize the response. If the resource has not been modified, the service will return status code 304 and an empty response body.
225+
The list of supported languages doesn't change frequently. To save network bandwidth and improve responsiveness, a client application should consider caching language resources and the corresponding entity tag (`ETag`). Then, the client application can periodically (for example, once every 24 hours) query the service to fetch the latest set of supported languages. Passing the current `ETag` value in an `If-None-Match` header field allows the service to optimize the response. If the resource hasn't been modified, the service returns status code 304 and an empty response body.
224226

225227
## Response headers
226228

@@ -234,13 +236,13 @@ The list of supported languages will not change frequently. To save network band
234236
</tr>
235237
<tr>
236238
<td>X-RequestId</td>
237-
<td>Value generated by the service to identify the request. It is used for troubleshooting purposes.</td>
239+
<td>Value generated by the service to identify the request. It's used for troubleshooting purposes.</td>
238240
</tr>
239-
</table>
241+
</table>
240242

241243
## Response status codes
242244

243-
The following are the possible HTTP status codes that a request returns.
245+
The following are the possible HTTP status codes that a request returns.
244246

245247
<table width="100%">
246248
<th width="20%">Status Code</th>
@@ -251,7 +253,7 @@ The following are the possible HTTP status codes that a request returns.
251253
</tr>
252254
<tr>
253255
<td>304</td>
254-
<td>The resource has not been modified since the version specified by request headers `If-None-Match`.</td>
256+
<td>The resource hasn't been modified since the version specified by request headers `If-None-Match`.</td>
255257
</tr>
256258
<tr>
257259
<td>400</td>
@@ -269,9 +271,9 @@ The following are the possible HTTP status codes that a request returns.
269271
<td>503</td>
270272
<td>Server temporarily unavailable. Retry the request. If the error persists, report it with: date and time of the failure, request identifier from response header `X-RequestId`, and client identifier from request header `X-ClientTraceId`.</td>
271273
</tr>
272-
</table>
274+
</table>
273275

274-
If an error occurs, the request will also return a JSON error response. The error code is a 6-digit number combining the 3-digit HTTP status code followed by a 3-digit number to further categorize the error. Common error codes can be found on the [v3 Translator reference page](./v3-0-reference.md#errors).
276+
If an error occurs, the request also returns a JSON error response. The error code is a 6-digit number combining the 3-digit HTTP status code followed by a 3-digit number to further categorize the error. Common error codes can be found on the [v3 Translator reference page](./v3-0-reference.md#errors).
275277

276278
## Examples
277279

0 commit comments

Comments
 (0)