Платформа Instagram

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/v21.0/10218560180051171?fields=id,username&access_token=IGQVJ...'

Ответ

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

Обновление

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

Удаление

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