Instagram은 시각적으로 주도되는 플랫폼으로, 비즈니스, 개발자, 그리고 제작자에게 강력한 도구가 되었습니다. 사용자 경험을 향상하고 원활한 통합을 촉진하기 위해, Instagram은 두 가지 필수 도구를 제공합니다: Instagram Graph API와 Instagram Basic Display API입니다. 이 기사에서는 Instagram Basic Display API의 기능과 이를 활용하여 Instagram 존재감을 최적화하는 방법에 대해 집중하겠습니다.
Instagram Basic Display API
Instagram Basic Display API는 개발자가 Instagram 계정의 기본 사용자 정보, 미디어 콘텐츠 및 기타 데이터에 접근할 수 있도록 Instagram(페이스북의 자회사)에서 제공하는 도구입니다. 이 API는 사용자 데이터에 대한 읽기 전용 액세스가 필요한 시나리오를 위해 특별히 설계되었으며, Instagram 콘텐츠를 표시하거나 개인화된 경험을 제공하는 애플리케이션에 적합합니다.
API에 접근하기 전 설정하기
요구 사항:
1. 페이스북 개발자 계정.
2. 테스트용 Instagram 계정.
3. Instagram에 접근하기 위해 애플리케이션에 권한을 부여할 웹 페이지(URL).
설정 단계:
- 개발자 페이지에서 앱 만들기를 클릭합니다. 다음으로 다른 항목을 선택하여 진행합니다.
2. Instagram Basic Display API의 앱 유형으로 고객을 선택합니다.
다음으로, 정보를 입력합니다(앱 이름, 연락처 이메일) 및 진행합니다.
3. 플랫폼 URL을 설정합니다. 설정으로 가서 기본 설정을 클릭하고 아래쪽에서 플랫폼 추가를 클릭한 후 URL을 입력합니다(요구 사항에 언급된 웹 페이지).
4. 대시보드에서 Instagram Basic API를 설정합니다.
앱이 생성된 후, 저장할 몇 가지 항목과 입력할 양식이 나타납니다.
앱 ID와 비밀은 나중에 필요합니다.
5. 이 앱이 테스트 용도이므로 유효한 OAuth 리디렉션 URI, 비인가 콜백 URL 및 데이터 삭제 요청에 이전과 같은 URL을 입력합니다.
양식에 테스트를 추가합니다. 예를 들어, 앨리스가 밥의 정보를 가져오고 싶다면 밥의 계정 사용자 이름을 입력합니다.
사용자를 추가한 후, 사용자의 상태는 대기 중이 됩니다. 사용자로부터 승인이 필요합니다. 테스트 계정을 사용하는 것이 권장됩니다.
6. 테스트용 Instagram 계정으로 로그인하고, 설정> 웹사이트 권한> 앱 및 웹사이트> 테스트 초대로 이동합니다. 테스트 초대를 수락합니다.
기본 설정이 완료되었습니다!
승인을 요청하는 방법?
API를 사용하기 전에 승인 코드가 필요하며, 이 승인 코드의 유효 시간은 1시간입니다. 코드를 얻으려면 다음 형식의 URL을 입력합니다:
https://api.instagram.com/oauth/authorize?client_id={app-id}&redirect_uri={redirect-uri}
&scope=user_profile,user_media
&response_type=code속성 설명:
앱-id: 애플리케이션 ID는 앱 ID이며, 이는 Instagram Basic Display 앱의 기본 표시 아래에서 찾을 수 있습니다.
redirect_uri: 유효한 OAuth 리디렉션 URI와 동일한 URL입니다.
전체 URL에 공백을 남기지 않도록 하세요.
입력을 클릭한 후, 승인 허용 페이지로 이동합니다.
모든 액세스를 허용하면, 코드 매개변수가 붙어 있는 URL로 자신의 URL로 리디렉션됩니다.
https://www.example.com/?code=ABCD......#_
승인 코드는 code= 이후의 값이며, 이는 승인 코드의 일부가 아니므로 #_는 삭제해야 합니다.
Apidog을 사용하여 코드를 액세스 토큰으로 교환하는 방법
Apidog는 API를 쉽게 설계, 테스트 및 문서화할 수 있는 올인원 API 개발 플랫폼입니다. Instagram API를 테스트하고자 하는 경우, Apidog을 사용하는 것이 항상 가장 쉬운 해결책입니다.
승인 코드를 액세스 토큰으로 변환하기
메서드를 POST로 전환하고, URL을 입력합니다:
https://api.instagram.com/oauth/access_token
필요한 이러한 매개변수를 추가합니다:
- client_id = Instagram 앱 ID
- client_secret = Instagram 앱 비밀
- code = 획득한 승인 코드
- grant_type = authorization_code (이 값이 설정됨)
- redirect_uri = 자신의 URI
보내기를 클릭하면, 액세스 토큰이 JSON 파일 형식으로 반환됩니다:
{
"access_token": "IGQWR9......",
"user_id": 7666070400110123
}참고: 토큰의 유효 기간도 1시간입니다
액세스 토큰과 사용자 ID를 사용하여 계정 정보를 조회하는 방법
Instagram Display Basic API를 사용하여 가져올 수 있는 기능들이 많이 있으며, 아래는 정보 수집의 두 가지 예입니다.
- 계정의 기본 정보 접근
curl을 사용한 샘플 요청:
curl -X GET \ 'https://graph.instagram.com/{user-id}?fields=id,username&access_token={access-token}'매개변수 설명:
- User_id: 이전 단계에서 가져옴
- Access_token: 이전 단계에서 가져옴
- Fields: 부분적으로 선택적일 수 있습니다. 사용할 수 있는 4가지 유형의 필드가 있습니다:
1. Account_type: 계정 유형
2. Id: user_id
3. Media_count: 게시물 수
4. Username: 계정 이름이 네 가지를 모두 가져오려면, 쉼표(,)로 구분하여 모두 입력합니다.
반환 결과:
2. 사용자의 게시물 정보 조회
샘플 요청:
curl -X GET \
'https://graph.instagram.com/me/media?fields=id,caption&access_token=IGQVJ...'Apidog에서의 설정:
Instagram Display API의 더 많은 기능에 대한 내용은 다음을 참조하십시오:
결론
결론적으로, Instagram API는 개발자가 Instagram 플랫폼과 상호 작용하고 혁신적인 애플리케이션을 만들 수 있는 다양한 가능성을 열어줍니다. 사용자 정보와 미디어 콘텐츠에 접근하고 새 사진 및 비디오를 게시하는 것부터 시작하여, 다양한 엔드포인트를 통해 개발자는 특정 요구에 맞추어 애플리케이션을 조정할 수 있습니다.
