User

Соответствует профилю пользователя Instagram.

ID пользователей внутри приложений (ASID) были представлены в API версии 11.0. Вы можете по-прежнему запрашивать пользователей по их обычным ID или эквивалентным ASID, однако вызовы версии 11.0 и более поздних будут получать в ответ ASID.

ASID заменят собой ID пользователей примерно через два года, после упразднения версии 10.0, поэтому рекомендуем начать замену ID пользователей ваших приложений эквивалентными ASID.

Создание

Эта операция не поддерживается.

Чтение

GET /{user-id}

Получение полей и границ контекста пользователя.

Ограничения

ID пользователей, которые использовались в устаревшем API Instagram, не поддерживаются.

Требования

Тип	Требование
Маркеры доступа	Пользователь Instagram
Разрешения	`instagram_graph_user_profile`. Для поля`media_count` также нужно `instagram_graph_user_media`.

Синтаксис запроса

GET https://graph.instagram.com/{api-version}/{user-id}
  ?fields={fields}
  &access_token={access-token}

Параметры пути

Заполнитель	Значение
`{api-version}` Строка	Версия API.
`{user-id}` Обязательный Строка	ID пользователя внутри приложения (для версии 11.0 и более поздних) или обычный ID пользователя (для всех версий).

Параметры строки запроса

В строку запроса можно включить следующие параметры:

Ключ	Значение
`access_token` Обязательное поле Строка	Маркер доступа пользователя Instagram для пользователя приложения.
`fields` Список значений, разделенных запятыми	Список полей и границ контекста, которые нужно вернуть (разделенных запятыми). Если его не задать, будут возвращены поля по умолчанию.

Поля

Параметр fields позволяет запросить следующие поля узла User.

Имя поля	Описание
`account_type`	Тип аккаунта узла User. Возможные варианты: `BUSINESS`, `MEDIA_CREATOR`, `PERSONAL`.
`id`	ID пользователя внутри приложения (для версии 11.0 и более поздних) или обычный ID пользователя (для версии 10.0 и более ранних).
`media_count`	Количество медиафайлов узла User. Чтобы использовать это поле, необходимо разрешение `instagram_graph_user_media`.
`username`	Имя пользователя узла User.

Границы контекста

С использованием параметра fields или в качестве параметров пути можно запросить следующие границы контекста.

Граница контекста	Описание
`media`	Список медиафайлов узла User.

Ответ

Объект в формате JSON со стандартными и запрошенными полями и границами контекста.

{
  "{field}":"{value}",
  ...
}

Пример запроса cURL

Запрос

curl -X GET \
  'https://graph.instagram.com/v19.0/10218560180051171?fields=id,username&access_token=IGQVJ...'

Ответ

{
  "id": "17841405793187218",
  "username": "jayposiris"
}

Обновление

Эта операция не поддерживается.

Удаление

Эта операция не поддерживается.