사용자

Instagram 사용자 프로필을 나타냅니다.

앱 범위 사용자 ID(ASID)가 API 버전 11.0에 도입되었습니다. 원시 사용자 ID나 해당 ASID로 사용자를 계속 쿼리할 수 있지만 버전 11.0+ 호출은 응답으로 ASID를 수신합니다.

ASID는 버전 10.0이 사용 중단되는 약 2년 후에 원시 사용자 ID를 대체할 예정입니다. 그러므로 앱 사용자를 해당 ASID에 매핑하는 것이 좋습니다.

만들기

지원되지 않는 작업입니다.

GET /{user-id}

사용자에 대한 필드와 에지를 가져옵니다.

Instagram 기존 API 사용자 ID는 지원되지 않습니다.

유형	요구 사항
액세스 토큰	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 쿼리 문자열 매개변수를 사용하여 사용자에 대한 다음 필드를 요청할 수 있습니다.

필드 이름	설명
`account_type`	사용자 계정 유형입니다. `BUSINESS`, `MEDIA_CREATOR` 또는 `PERSONAL`일 수 있습니다.
`id`	앱 사용자의 앱 범위 ID(버전 11.0+) 또는 원시 사용자 ID(버전 10.0 이하).
`media_count`	사용자에 대한 미디어 개수. 이 필드는 `instagram_graph_user_media` 권한이 필요합니다.
`username`	사용자의 사용자 이름.

다음 에지를 경로 매개변수로 요청하거나 fields 쿼리 문자열 매개변수를 사용하여 요청할 수 있습니다.

에지	설명
`media`	사용자에 대한 미디어 리스트를 가져옵니다.

기본 및 요청된 필드와 에지를 포함하는 JSON 형식의 개체입니다.

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

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

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

지원되지 않는 작업입니다.

지원되지 않는 작업입니다.