文档已更新。
中文(简体) 译文尚未完成。
英语更新时间:2021年6月11日

用户

代表 Instagram 用户个人主页。

已通过 11.0 版本的 API 推出应用范围用户编号 (ASID)您可以继续通过原始用户编号或等效的 ASID 查询用户,但 11.0 及以上版本的通话将在响应中接收 ASID。

大约两年后,10.0 版本将停用,ASID 将取代原始用户编号,因此我们建议您开始将应用用户映射到其等效的 ASID。

创建

不支持此操作。

读取

GET /{user-id}

获取用户的字段和连线。

限制

不支持 Instagram 旧版 API 用户编号。

要求

类型要求

访问口令

Instagram 用户

权限

instagram_graph_user_profilemedia_count字段还需要 instagram_graph_user_media

请求语法

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

路径参数

占位符

{api-version}
字符串

API 版本

{comment-id}
必填
字符串

应用用户的应用范围用户编号(11.0 及以上版本)或原始用户编号(所有版本)。

查询字符串参数

添加以下查询字符串参数以扩充请求。

access_token
必需
字符串

应用用户的 Instagram 用户访问口令

fields
逗号分隔列表

您希望系统返回的以逗号分隔的字段连线列表。如果不指定,系统将返回默认字段。

字段

您可以使用 fields 查询字符串参数,以请求用户的下列字段。

字段名称说明

account_type

用户的帐户类型。可以是 BUSINESSMEDIA_CREATORPERSONAL

id

应用用户的应用范围编号(11.0 及以上版本)或原始用户编号(10.0 及以下版本)。

media_count

用户的多媒体素材数量。该字段需要 instagram_graph_user_media 权限。

username

用户的用户名。

连线

您可以请求将以下连线用作路径参数,或使用 fields 查询字符串参数。

连线说明

media

获取用户的多媒体素材列表。

响应

JSON 格式的对象包含默认和请求的字段连线

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

cURL 示例

请求

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

响应

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

更新

不支持此操作。

删除

不支持此操作。