---
keywords:
  - getLangs
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/tech-only/doc/dg/ru/llms.txt


# Метод getLangs

Возвращает список направлений перевода, поддерживаемых сервисом.

## Описание

```javascript
string[] getLangs(string key);
```

## Входные параметры

Список входных параметров:

#|

||
**Параметр**
|
**Тип**
|
**Описание**
||
||
**Обязательные**
| >
| >
||
||
`key`
|
`string`
|
API-ключ. Получите бесплатный API-ключ на этой [странице](https://yandex.ru/dev/dictionary/keys/get/?service=dict).
||

|#

<!-----

**Необязательные**
| >
| >
||
||
`ui`
|
`string`
|
Если задан, то в ответ сервиса будет добавлен список языковых кодов и соответствующих им названий  языков:
- `en` - на английском;
- `ru` - на русском;
- `tr` - на турецком;
- `uk` - на украинском.

----->


**Пример запроса**:

XML-интерфейс:

```
https://dictionary.yandex.net/api/v1/dicservice/getLangs?key=API-ключ
```

JSON-интерфейс:

```
https://dictionary.yandex.net/api/v1/dicservice.json/getLangs?key=API-ключ
```

JSONP-интерфейс (для функции myCallback):

```
https://dictionary.yandex.net/api/v1/dicservice.json/getLangs?key=API-ключ&callback=myCallback
```

## Возвращает {#translate-returns}

В XML-интерфейсе возвращает ответ в виде XML-документа с корневым элементом `ArrayOfString`. Например:

```xml
<?xml version="1.0" encoding="utf-8"?>
<ArrayOfString>
  <string>ru-ru</string>
  <string>ru-en</string>
  <string>ru-pl</string>
  <string>ru-uk</string>
  <string>ru-de</string>
  <string>ru-fr</string>
         ...
  <string>it-ru</string>
  <string>it-en</string>
  <string>tr-ru</string>
  <string>tr-en</string>
</ArrayOfString>
```


#### Коды ошибок {#translate-returns}

#|

||
**Код**
|
**Значение**
|
**Описание**
||
||
`ERR_KEY_INVALID`
|
`401`
|
Ключ API невалиден.
||
||
`ERR_KEY_BLOCKED`
|
`402`
|
Ключ API заблокирован.
||

|#


В JSON-интерфейсе вместо XML-элементов возвращаются JavaScript-объекты с теми же именами и семантикой:

```javascript
["ru-ru","ru-en","ru-pl","ru-uk","ru-de","ru-fr","ru-es","ru-it","ru-tr","en-ru","en-en",
"en-de","en-fr","en-es","en-it","en-tr","pl-ru","uk-ru","de-ru","de-en","fr-ru","fr-en",
"es-ru","es-en","it-ru","it-en","tr-ru","tr-en"]
```


В JSONP-интерфейсе те же самые JavaScript-объекты возвращаются в callback-функции (например, myCallback):

```javascript
myCallback(["ru-ru","ru-en","ru-pl","ru-uk","ru-de","ru-fr","ru-es","ru-it","ru-tr","en-ru",
"en-en","en-de","en-fr","en-es","en-it","en-tr","pl-ru","uk-ru","de-ru","de-en","fr-ru",
"fr-en","es-ru","es-en","it-ru","it-en","tr-ru","tr-en"])
```