--- metadata: - name: generator content: Diplodoc Platform v5.42.1 alternate: - https://yandex.ru/dev/rasp/doc/ru/reference/query-carrier.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/rasp/doc/ru/llms.txt # Информация о перевозчике Запрос позволяет получить информацию о [перевозчике](https://yandex.ru/dev/rasp/doc/ru/concepts/termin.md#carrier) по указанному коду перевозчика. Коды перевозчиков можно получить в публичных справочниках кодов, а также в ответах на запросы: [Расписание рейсов между станциями](https://yandex.ru/dev/rasp/doc/ru/reference/schedule-point-point.md), [Расписание рейсов по станции](https://yandex.ru/dev/rasp/doc/ru/reference/schedule-on-station.md), [Список станций следования](https://yandex.ru/dev/rasp/doc/ru/reference/list-stations-route.md). {% note info %} Мы не гарантируем доступность домена [api.rasp.yandex.net](../_includes/reference/schedule-point-point/id-schedule-point-point/api.rasp.yandex.net) по независимым от Яндекса причинам. Если ваша интеграция уже использует этот домен — рекомендуем переключиться на [api.rasp.yandex-net.ru](../_includes/reference/schedule-point-point/id-schedule-point-point/api.rasp.yandex-net.ru). Для этого в вызовах АПИ замените `api.rasp.yandex.net` на `api.rasp.yandex-net.ru`, других действий не требуется. Ключи доступа и тарифы остаются без изменений. {% endnote %} ## Синтаксис запроса {#query} ```no-highlight https://api.rasp.yandex-net.ru/v3.0/carrier/ ? [apikey](*apikey)=<ключ> & [code](*code)=<код перевозчика> [& [format](*format)=<формат>] [& [lang](*lang)=<язык>] [& [system](*system)=<текущая система кодирования>] ``` Пример запроса: ```no-highlight https://api.rasp.yandex-net.ru/v3.0/carrier/?format=json&apikey={ключ}&lang=ru_RU&code=TK&system=iata ``` Входные параметры: **Обязательные параметры** #| || **Параметр** | **Описание** || || `apikey` | [Ключ доступа](https://yandex.ru/dev/rasp/doc/ru/concepts/access.md) к API. Параметр можно не передавать, если ключ доступа указан в заголовке `Authorization`, например: ```no-highlight Authorization: 1eb31582-941a-3ac8-a61f-041c344495ab ``` || || `code` | Код перевозчика. По умолчанию в системе кодирования Яндекс Расписаний. Чтобы отправить код в другой системе кодирования, укажите параметр `system`. Если код указан в системе кодирования IATA, в ответе могут быть описаны несколько перевозчиков. || |# **Необязательные параметры** #| || **Параметр** | **Описание** || || `system` | [Система кодирования](https://yandex.ru/dev/rasp/doc/ru/concepts/coding-system.md), в которой указывается код перевозчика (параметр `code`) в запросе. Возможные значения: - `yandex` (значение по умолчанию) — система кодирования Яндекс Расписаний; - `iata` — [коды Международной ассоциации воздушного транспорта](https://ru.wikipedia.org/wiki/Код_ИАТА); - `sirena` — коды в системах, построенных на базе [сетей «Сирена»](http://ru.wikipedia.org/wiki/Сирена_(сеть)); - `express` — коды железнодорожных станций СНГ и стран Балтии из базы [Экспресс-3](http://www.express-3.ru/); - `esr` — коды железнодорожных станций СНГ и стран Балтии из базы [ЕСР](https://ru.wikipedia.org/wiki/Единая_сетевая_разметка). Параметр обязателен, если используется система кодирования, отличная от системы кодирования Яндекс Расписаний. || || `lang` | Язык возвращаемой информации, в формате <код языка>_<код страны>. Поддерживаемые коды языка описаны стандартом [ISO 639](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2), коды стран — стандартом [ISO 3166](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). По умолчанию ответ возвращается для значения `ru_RU`. Поддерживаемые коды языков: - `ru` — русский; - `uk` — украинский. Поддерживаемые коды стран: - `RU` — Россия; - `UA` — Украина. || || `format` | Формат ответа. Поддерживаемые значения: - `json` (по умолчанию); - `xml`. || |# ## Структура ответа {#emails-detailed} Ответ содержит информацию об указанном в запросе перевозчике. Если код перевозчика в запросе указан в системе кодирования [IATA](https://ru.wikipedia.org/wiki/Международная_ассоциация_воздушного_транспорта) ответ содержит данные по нескольким перевозчикам (вместо одного элемента `carrier` возвращается массив `carriers`). Структура ответа в различных форматах показана в примерах. {% list tabs %} - Пример ответа в формате JSON ```javascript { "carriers": [ { "code": 680, "contacts": "Телефон: +7 (1234) 123456", "url": "http://www.example.com/", "title": "Россия", "phone": "", "codes": { "icao": null, "sirena": null, "iata": "SU" }, "address": "Санкт-Петербург, ул. Строителей, д. 18", "logo": "//yastatic.net/rasp/media/data/company/logo/logo_1.jpg", "email": "" } ... ] } ``` #### Описание элементов JSON #| || **Элемент JSON** | **Тип** | **Описание** || || `carriers` | Массив | Список перевозчиков. Может быть включен в ответ, если код перевозчика был указан в системе IATA. || |# **Элементыобъекта** `carriers` #| || **Элемент JSON** | **Тип** | **Описание** || || `code` | Число | Код перевозчика в указанной системе кодирования (по умолчанию — в системе Яндекс Расписаний.) || || `contacts` | Строка | Контактная информация, в свободной форме. || || `url` | Строка | Ссылка на сайт перевозчика. || || `title` | Строка | Название перевозчика. || || `phone` | Строка | Контактный номер телефона перевозчика. || || `codes` | Объект | Список кодов перевозчика в других системах кодирования, поддерживаемых Яндекс Расписаниями. || || `address` | Строка | Юридический адрес перевозчика. || || `logo` | Строка | Ссылка на используемый Яндексом логотип перевозчика в растровом формате. || || `email` | Строка | Электронный почтовый адрес перевозчика. || |# **Элементыобъекта** `codes` #| || **Элемент JSON** | **Тип** | **Описание** || || `icao` | Строка | Код перевозчика в системе кодирования [ICAO](https://ru.wikipedia.org/wiki/Международная_организация_гражданской_авиации). || || `sirena` | Строка | Код перевозчика в системе кодирования [Sirena](http://ru.wikipedia.org/wiki/Сирена_(сеть)). || || `iata` | Строка | Код перевозчика в системе кодирования [IATA](https://ru.wikipedia.org/wiki/Международная_ассоциация_воздушного_транспорта). || |# - Пример ответа в формате XML ```xml <[carrier](*code-carrier)> <[code](*code-code)>680 <[title](*code-title)>Turkish Airlines <[url](*code-url)>http://www.thy.com/ <[contacts](*code-contacts)/> <[phone](*code-phone)> <[codes](*code-codes)> <[icao](*code-icao)>xsi:nil="true" <[sirena](*code-sirena)>xsi:nil="true" <[iata](*code-iata)>SU <[address](*code-address)>Москва, Ленинградский пр., д.37, корп.9 <[logo](*code-logo)>//yastatic.net/rasp/media/data/company/logo/logo_ru.gif <[email](*code-email)/> ... ``` #### Описание элементов XML #| || **Элемент JSON** | **Тип** | **Описание** || || `carrier` | | Элемент, содержащий контактные данные перевозчика. || |# **Элементы, вложенные в** `carriers` #| || **Элемент JSON** | **Тип** | **Описание** || || `code` | Число | Код перевозчика в указанной системе кодирования (по умолчанию — в системе Яндекс Расписаний.) || || `title` | Строка | Название перевозчика. || || `url` | Строка | Ссылка на сайт перевозчика. || || `contacts` | Строка | Контактная информация, в свободной форме. || || `phone` | Строка | Контактный номер телефона перевозчика. || || `codes` | | Список кодов перевозчика в других системах кодирования, поддерживаемых Яндекс Расписаниями. || || `address` | Строка | Юридический адрес перевозчика. || || `logo` | Строка | Ссылка на используемый Яндексом логотип перевозчика в растровом формате. || || `email` | Строка | Электронный почтовый адрес перевозчика. || |# **Элементы, вложенные в** `codes` #| || **Элемент JSON** | **Тип** | **Описание** || || `icao` | Строка | Код перевозчика в системе кодирования [ICAO](https://ru.wikipedia.org/wiki/Международная_организация_гражданской_авиации). || || `sirena` | Строка | Код перевозчика в системе кодирования [Sirena](http://ru.wikipedia.org/wiki/Сирена_(сеть)). || || `iata` | Строка | Код перевозчика в системе кодирования [IATA](https://ru.wikipedia.org/wiki/Международная_ассоциация_воздушного_транспорта). || |# {% endlist %} [*apikey]: [Ключ доступа](https://yandex.ru/dev/rasp/doc/ru/concepts/access.md) к API.   Параметр можно не передавать, если ключ доступа указан в заголовке `Authorization`, например:   ```no-highlight Authorization: 1eb31582-941a-3ac8-a61f-041c344495ab ``` [*lang]: Язык возвращаемой информации, в формате <код языка>_<код страны>. Поддерживаемые коды языка описаны стандартом [ISO 639](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2), коды стран — стандартом [ISO 3166](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).   По умолчанию ответ возвращается для значения `ru_RU`.   Поддерживаемые коды языков:   - `ru` — русский; - `uk` — украинский.   Поддерживаемые коды стран:   - `RU` — Россия; - `UA` — Украина. [*format]: Формат ответа. Поддерживаемые значения:   - `json` (по умолчанию); - `xml`. [*code]: Код перевозчика. По умолчанию в системе кодирования Яндекс Расписаний. Чтобы отправить код в другой системе кодирования, укажите параметр `system`.   Если код указан в системе кодирования IATA, в ответе могут быть описаны несколько перевозчиков. [*system]: [Система кодирования](https://yandex.ru/dev/rasp/doc/ru/concepts/coding-system.md), в которой указывается код перевозчика (параметр `code`) в запросе. Возможные значения:   - `yandex` (значение по умолчанию) — система кодирования Яндекс Расписаний; - `iata` — [коды Международной ассоциации воздушного транспорта](https://ru.wikipedia.org/wiki/Код_ИАТА); - `sirena` — коды в системах, построенных на базе [сетей «Сирена»](http://ru.wikipedia.org/wiki/Сирена_(сеть)); - `express` — коды железнодорожных станций СНГ и стран Балтии из базы [Экспресс-3](http://www.express-3.ru/); - `esr` — коды железнодорожных станций СНГ и стран Балтии из базы [ЕСР](https://ru.wikipedia.org/wiki/Единая_сетевая_разметка).   Параметр обязателен, если используется система кодирования, отличная от системы кодирования Яндекс Расписаний. [*code-code]: **Тип**   Число   **Описание**   Код перевозчика в указанной системе кодирования (по умолчанию — в системе Яндекс Расписаний.) [*code-carrier]: **Тип**   **Описание**   Элемент, содержащий контактные данные перевозчика. [*code-title]: **Тип**   Строка   **Описание**   Название перевозчика. [*code-url]: **Тип**   Строка   **Описание**   Ссылка на сайт перевозчика. [*code-contacts]: **Тип**   Строка   **Описание**   Контактная информация, в свободной форме. [*code-phone]: **Тип**   Строка   **Описание**   Контактный номер телефона перевозчика. [*code-codes]: **Тип**   Объект   **Описание**   Список кодов перевозчика в других системах кодирования, поддерживаемых Яндекс Расписаниями. [*code-icao]: **Тип**   Строка   **Описание**   Код перевозчика в системе кодирования [ICAO](https://ru.wikipedia.org/wiki/Международная_организация_гражданской_авиации). [*code-sirena]: **Тип**   Строка   **Описание**   Код перевозчика в системе кодирования [Sirena](http://ru.wikipedia.org/wiki/Сирена_(сеть)). [*code-iata]: **Тип**   Строка   **Описание**   Код перевозчика в системе кодирования [IATA](https://ru.wikipedia.org/wiki/Международная_ассоциация_воздушного_транспорта). [*code-address]: **Тип**   Строка   **Описание**   Юридический адрес перевозчика. [*code-logo]: **Тип**   Строка   **Описание**   Ссылка на используемый Яндексом логотип перевозчика в растровом формате. [*code-email]: **Тип**   Строка   **Описание**   Электронный почтовый адрес перевозчика.