Получить метаданные пользователей

GET /user-metadata/{user_id}

Получает данные пользователя, ID которого указан в запросе.

Примеры запросов

cURL

Python

Nodejs

curl -X GET 'https://tasks.yandex.ru/api/v1/user-metadata/1ad097faba0eff85a04fe30bc04d53db' \
     -H 'Authorization: OAuth PlaceYourRealOAuthToken_Here'

import requests

url = "https://tasks.yandex.ru/api/v1/user-metadata/1ad097faba0eff85a04fe30bc04d53db"
headers = {
  'Authorization': 'OAuth PlaceYourRealOAuthToken_Here'
}
response = requests.get(url, headers=headers)

print(response.text)

var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://tasks.yandex.ru/api/v1/user-metadata/1ad097faba0eff85a04fe30bc04d53db',
  'qs': {},
  'headers': {
    'Authorization': 'OAuth PlaceYourRealOAuthToken_Here'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

Path-параметры

Параметр

Описание

user_id*

string

Идентификатор пользователя, для которого нужно получить подробную информацию.

Заголовки

Заголовок	Описание
`Authorization`	API-токен для авторизации аккаунта. В качестве префикса добавьте `OAuth`.

Ответ

Содержит метаданные пользователя в формате JSON.

Пример ответа

{
  "id": "0060ec33ea7938162d024ef1e3cef496",
  "country": "RU",
  "languages": [
    "RU",
    "EN"
    ],
  "adult_allowed": true,
  "attributes": {
    "country_by_phone": "RU",
    "country_by_ip": "RU",
    "client_type": "TOLOKA_APP",
    "user_agent_type": "OTHER",
    "device_category": "SMARTPHONE",
    "os_family": "IOS",
    "os_version": 15,
    "os_version_major": 15,
    "os_version_minor": 0,
    "os_version_bugfix": 0
  }
}

Параметр	Описание
`id`	string Идентификатор пользователя, для которого возвращается подробная информация.
`country`	string Страна, которую исполнитель выбрал при регистрации (двухбуквенный код стандарта ISO 3166-1 alpha-2).
`languages`	array_of_strings Языки, указанные исполнителем в профиле (двухбуквенный ISO-код стандарта ISO 639-1 в верхнем регистре).
`attributes`	object Данные исполнителя, полученные или вычисленные Яндекс Заданиями по номеру телефона, IP-адресу и устройству.
`country_by_phone`	string Регион исполнителя, определяется по номеру мобильного телефона (двухбуквенный код стандарта ISO 3166-1 alpha-2).
`country_by_ip`	string Регион исполнителя, определяется по IP-адресу (двухбуквенный код стандарта ISO 3166-1 alpha-2).
`client_type`	string Тип клиентского приложения, используемого исполнителем для доступа к платформе: `TOLOKA_APP` — мобильное приложение Яндекс Заданий; `BROWSER` — браузер.
`user_agent_type`	string Идентификационная строка клиентского приложения (user agent), который используется приложением клиента для идентификации: `BROWSER` — десктопный браузер; `MOBILE_BROWSER` — мобильный браузер; `OTHER` — идентификационная строка клиентского приложения, которая не определилась как десктопный или мобильный браузер. Если исполнитель использует мобильное приложение, то user agent будет определен как `OTHER`. Полный список доступен на странице библиотеки UADetector.
`device_category`	string Тип устройства исполнителя, используемого для доступа к платформе: `PERSONAL_COMPUTER` — персональный компьютер или устройство семейства Apple Mac; `SMARTPHONE` — мобильный телефон с одной из доступных операционных систем; `TABLET` — планшет; `WEARABLE_COMPUTER` — носимое устройство, например, умные часы или подобное устройство. Полный список доступен на странице библиотеки UADetector.
`os_family`	string Семейство операционной системы, установленной на устройстве исполнителя: `ANDROID` — мобильная операционная система Android, основанная на модифицированном ядре Linux, разработанная для мобильных устройств с сенсорным экраном; `BLACKBERRY` — мобильная операционная система BlackBerry OS, разработанная компанией BlackBerry Limited для смартфонов BlackBerry; `BSD` — операционная система, основанная на Research Unix, разработанная и распространяемая компанией CSRG, а также произошедшие от нее ОС с открытым исходным кодом, такие как FreeBSD, OpenBSD, NetBSD и DragonFly BSD; `IOS` — мобильная операционная система iOS, разработанная компанией Apple Inc. исключительно для собственных мобильных устройств; `LINUX` — семейство Unix-подобных операционных систем с открытым исходным кодом, основанное на ядре Linux; `MAC_OS` — классическая операционная система Mac OS, разрабатывавшаяся компанией Apple Inc. до 2001 для семейства персональных компьютеров Macintosh; `OS_X` — операционная система macOS, разрабатывающаяся компанией Apple Inc. с 2001 для компьютеров Mac; `WINDOWS` — операционная система Microsoft Windows, разработанная компанией Microsoft для персональных компьютеров. Полный список доступен на странице библиотеки UADetector.
`os_version`	float Полная версия операционной системы, установленной на устройстве исполнителя, используемом для доступа к платформе. Версия состоит из мажорной и минорной, например, `14.4`.
`os_version_major`	integer Мажорная версия операционной системы, устновленной на устройстве исполнителя.
`os_version_minor`	integer Минорная версия операционной системы, устновленной на устройстве исполнителя.
`os_version_bugfix`	integer Номер билда или багфиксная версия операционной системы, устновленной на устройстве исполнителя.
`adult_allowed`	boolean Согласен или нет исполнитель выполнять задания, которые содержат контент для взрослых.

Была ли статья полезна?

Отправить сообщение

Получить данные об остатке на счете