O Instagram, com sua plataforma orientada para o visual, tornou-se uma ferramenta poderosa para empresas, desenvolvedores e criadores. Para melhorar a experiência do usuário e facilitar a integração contínua, o Instagram fornece duas ferramentas essenciais: Instagram Graph API e Instagram Basic Display API. Neste artigo, vamos nos concentrar nas capacidades da Instagram Basic Display API e como ela pode ser aproveitada para otimizar sua presença no Instagram.
Instagram Basic Display API
A Instagram Basic Display API é uma ferramenta fornecida pelo Instagram (uma subsidiária do Facebook) que permite que desenvolvedores acessem informações básicas do usuário, conteúdo de mídia e outros dados de contas do Instagram. Esta API é especificamente projetada para cenários onde o acesso somente leitura aos dados do usuário é necessário, tornando-a adequada para aplicativos que se concentram em exibir conteúdo do Instagram ou fornecer experiências personalizadas.
Configuração antes de acessar a API
Requisitos:
1. Uma conta de desenvolvedor do Facebook.
2. Uma conta de teste do Instagram.
3. Uma página da web (URL) para redirecionamento, para conceder permissão para que o aplicativo acesse o Instagram.
Passos para configuração:
- Na página do desenvolvedor, clique em Criar Aplicativo. Selecione Outros para prosseguir.
2. escolha cliente como tipo de aplicativo para Instagram basic display API
Em seguida, preencha suas informações (Nome do aplicativo, email de contato) e prossiga
3. Defina a URL da plataforma. Vá para configurações > básico, clique em adicionar plataforma na parte inferior e insira sua URL (A página da web mencionada nos requisitos).
4. Configure a Instagram Basic API no painel
Após a criação do aplicativo, um formulário aparecerá com algumas informações a serem salvas e preenchidas.
O ID do aplicativo e o segredo serão necessários mais tarde.
5. Insira a mesma URL que antes em Valid OAuth redirect URI, Deauthorization callback URL and data deletion request uma vez que este aplicativo é para fins de teste.
Adicione um testador no formulário, por exemplo, se Alice quiser recuperar as informações de Bob, insira o nome de usuário da conta de Bob.
Após adicionar um usuário, o status do usuário ficará pendente, pois a autorização do usuário é necessária. Recomenda-se usar a conta de teste.
6. Faça login na sua conta de teste do Instagram, vá para configurações> permissão do site> Aplicativos e Sites> Convites de Testador. Aceite o convite de teste.
A configuração básica está completa!
Como solicitar autorização?
Um código de autorização é necessário antes de usar a API, o tempo de validade deste código de autorização é de 1 hora. Para obter o código, insira a URL neste formato:
https://api.instagram.com/oauth/authorize?client_id={app-id}&redirect_uri={redirect-uri}
&scope=user_profile,user_media
&response_type=codeExplicação dos atributos:
App-id: O ID do aplicativo é o app-id, isso pode ser encontrado na exibição básica sob o aplicativo Instagram basic display.
redirect_uri: a mesma URL que a URI de redirecionamento OAuth válida.
Lembre-se de não deixar espaço para a URL inteira.
Após clicar em entrar, será redirecionado para a página que permite a autorização.
Após permitir todos os acessos, será redirecionado para sua própria URL, com o parâmetro de código anexado à URL, parecendo
https://www.example.com/?code=ABCD......#_
O código de autorização é o que vem depois de code=, lembre-se de excluir o #_ uma vez que isso não faz parte do código de autorização.
Como usar o Apidog para trocar o código pelo token de acesso?
Apidog é uma plataforma de desenvolvimento de API tudo-em-um que permite que você projete, teste e documente sua API facilmente. Para quem deseja testar a API do Instagram, usar o Apidog é sempre a solução mais fácil.
Converter o código de autorização em token de acesso
https://api.instagram.com/oauth/access_token
Adicione estes parâmetros que são necessários:
- client_id = ID do aplicativo do Instagram
- client_secret = segredo do aplicativo do Instagram
- code = código de autorização obtido
- grant_type = authorization_code (Este valor é definido)
- redirect_uri = sua própria URI
Clique em enviar, o token de acesso será retornado em forma de arquivo JSON, parecendo:
{
"access_token": "IGQWR9......",
"user_id": 7666070400110123
}Nota: o token também é válido por 1 hora
Como usar o token de acesso e o ID do usuário para consultar informações da conta?
Existem várias funcionalidades que podem ser obtidas usando a Instagram Display Basic API, abaixo estão dois exemplos de recuperação de informações.
- acessar as informações básicas de uma conta
Exemplo de solicitação usando curl:
curl -X GET \ 'https://graph.instagram.com/{user-id}?fields=id,username&access_token={access-token}'Explicação dos parâmetros:
- User_id: obtido do passo anterior
- Access_token: do passo anterior
- Fields: pode ser opcional em parte. Existem 4 tipos de campos disponíveis:
1. Account_type: tipo de conta
2. Id: user_id
3. Media_count: número de postagens
4. Username: nome da contaSe você quiser obter todos esses quatro, insira todos separados por vírgula (,)
O resultado retornado:
2. Recuperar informações das postagens do usuário
Exemplo de solicitação:
curl -X GET \
'https://graph.instagram.com/me/media?fields=id,caption&access_token=IGQVJ...'Configuração no Apidog:
Para mais funcionalidades com a API de exibição do Instagram, consulte:
Conclusão
Em conclusão, a API do Instagram abre um mundo de possibilidades para os desenvolvedores interagirem com a plataforma do Instagram e criarem aplicativos inovadores. Desde o acesso a informações de usuários e conteúdo de mídia até o envio de novas fotos e vídeos, a diversa gama de endpoints permite que os desenvolvedores adaptem seus aplicativos às necessidades específicas.
