변경 사항

2024년 9월 4일

Instagram 기본 디스플레이 API가 사용 중단됩니다. 90일 후인 2024년 12월 4일부터 Instagram 기본 디스플레이 API가 더 이상 제공되지 않습니다.

2022년 6월 28일

릴스

모든 버전에 적용됩니다.

이제 GET /{user-id}/media 응답에 동영상 릴스가 포함되지만 현재 응답 세트의 특정 동영상이 릴스로 지정되었는지 확인할 수 있는 방법은 없습니다.

2022년 6월 27일

기존 Instagram API 문서

모든 버전에 적용됩니다.

기존 Instagram API 개발자 문서가 삭제되었고, 이제 Instagram 플랫폼 개발자 문서로 리디렉션됩니다.

2021년 8월 30일

Facebook 외부 활동

모든 버전에 적용됩니다.

활동 기록 지우기와 향후 활동 설정에 대한 2021년 6월 15일 변경 사항이 7월 중순에 일시 중단되었으나 현재 다시 적용되었습니다.

2021년 6월 30일

비공개 계정 액세스 토큰

모든 버전에 적용됩니다.

비공개 Instagram 계정에 대한 장기 실행 액세스 토큰새로 고침할 수 있습니다. 또한 이제 비공개 계정으로 앱 사용자가 앱에 부여한 권한은 90일 동안 유효합니다.

2021년 6월 15일

Facebook 외부 활동

모든 버전에 적용됩니다.

기록을 삭제하거나 향후 활동을 비활성화한 사용자는 액세스 토큰이 무효화됩니다. 또한 향후 활동을 비활성화한 사용자와 인증 창을 사용하려고 시도한 사용자에게는 앱을 사용하려면 향후 활동을 활성화하라는 메시지가 표시됩니다.

2021년 6월 8일

액세스 토큰 디버거

모든 버전에 적용됩니다.

이제 액세스 토큰 디버거 도구는 토큰을 디버깅할 때 앱 범위 ID만 반환합니다.


API 버전 관리

모든 버전에 적용됩니다.

이제 이 API는 버전이 지정된 호출을 지원합니다. 특정 API 버전을 쿼리하려면 기본 URL 뒤의 쿼리 경로에 버전 번호를 포함하세요. 예를 들면 다음과 같습니다.

https://graph.instagram.com/v11.0/{node-id}/{edge-name}

버전이 지정되지 않은 요청(버전 번호가 없음)은 호출하는 앱의 앱 대시보드 > 설정 > 고급 > API 버전 업그레이드 섹션에 지정된 버전으로 지정합니다.


앱 범위 사용자 ID

11.0 이상 버전에 적용됩니다.

앱 범위 사용자 ID(ASID)가 도입되었습니다. ASID는 버전 10.0이 사용 중단되는 약 2년 후에 원시 사용자 ID를 대체할 예정입니다. 그러므로 앱 사용자의 원시 ID를 ASID에 매핑하기 시작하는 것이 좋습니다.

  • 모든 버전이 원시 사용자 ID 기반 쿼리를 지원합니다.
  • 11.0 이상 버전의 호출만 ASID 기반 쿼리를 지원합니다.
  • 11.0 이상 버전의 호출은 원시 사용자 ID를 쿼리할 때도 응답에서 ASID를 수신합니다.

시간 기반 페이지 매김

v11.0+에 적용됩니다.

시간 기반 페이지 매김을 지원하기 위해 sinceuntil 매개변수를 GET /{user-id}/media 엔드포인트에 추가했습니다.

2020년 10월 24일

  • 사용자 노드 — 앱 사용자의 Instagram 기존 사용자 ID를 반환하는 ig_id 필드가 사용 중단되었습니다.

2020년 8월 31일

2020년 6월 5일

  • 기존 ID — 이제 사용자 노드의 ig_id 필드를 요청하여 앱 사용자의 Instagram 기존 API 사용자 ID를 가져올 수 있습니다. 이 필드는 2020년 9월 30일까지 사용할 수 있습니다. (업데이트: 2020년 10월 24일까지 사용 가능)

2020년 2월 20일

2020년 1월 14일

2019년 12월 6일

2019년 10월 15일

Instagram 기본 디스플레이 API가 정식 출시되었습니다!