Como usar a API de exibição básica do Instagram: um guia completo
Como usar a API de exibição básica do Instagram: um guia completo

api%20insta

A API de Exibição Básica do Instagram permite que os desenvolvedores integrem o conteúdo do Instagram em aplicativos, permitindo acesso a perfis de usuários e mídias. Este guia detalha a configuração da API, o gerenciamento de tokens de acesso e a realização de conexões, fornece conhecimentos essenciais para uma integração eficaz com o Instagram antes de sua descontinuação.


Sua Hospedagem Compartilhada - A Melhor Hospedagem Web pelo melhor preço do Brasil

O Instagram se tornou uma potência para empresas e indivíduos. A API de Exibição Básica do Instagram abre novas possibilidades para desenvolvedores integrarem conteúdo do Instagram em seus aplicativos. Esta ferramenta poderosa permite acesso a perfis de usuários, mídias e informações básicas de contato, possibilitando a criação de experiências inovadoras e envolventes para os usuários.

A API de Exibição Básica do Instagram tem um impacto significativo na forma como os desenvolvedores interagem com a plataforma do Instagram. Este guia irá guiá-lo pelo processo de configuração da API, obtenção de tokens de acesso e realização de transações de API. Também exploraremos como implementar uma API em seu aplicativo, fornecendo a você o conhecimento necessário para aproveitar os recursos do Instagram de forma eficaz. Ao final deste guia, você estará bem equipado para usar a API de Exibição Básica do Instagram e aprimorar seus projetos com a integração do Instagram.

Configurando sua API de exibição básica do Instagram Para começar a usar a API de Exibição Básica do Instagram, você precisa configurar seu ambiente corretamente. Esse processo envolve a criação de um aplicativo do Facebook, a configuração das configurações de Exibição Básica do Instagram e a adição de um usuário de teste do Instagram. Vamos detalhar essas etapas para você começar.


São diversas extensões de Domínios ao seu gosto e preferencia, com Add-ons GRÁTIS em todos os nomes de domínio

Criando um aplicativo do Facebook

O primeiro passo é criar um aplicativo do Facebook, necessário para acessar os recursos do Instagram.


1 GB Espaço em Disco, 1 Domínio, 1 endereço de e-mail, No Ads, 5 GB Tráfego E Suporte ao cliente...

Veja como fazer: (CLICK PARA EXPANDIR)


SÃO MODELOS PRONTOS EM SISTEMA JOOMLA E WORDPRESS OU A SUA ESCOLHA

  • Acesse developers.facebook.com e clique em “Meus aplicativos”.
  • Clique no botão "Criar aplicativo".
  • Escolha "Consumidor" como o tipo de aplicativo e clique em "Avançar".
  • Dê um nome ao seu aplicativo, como “Instagram Basic Display App”.
  • Insira seu e-mail de contato e selecione uma conta de gerente de negócios, se tiver uma.
  • Clique em “Criar aplicativo” para finalizar o processo.

Depois de criar seu aplicativo, você precisará definir algumas configurações básicas:

  1. Navegue até "Configurações" > "Básico" na barra lateral esquerda.
  2. Role para baixo e clique em "Adicionar plataforma".
  3. Selecione "Site" e insira a URL do seu site.
  4. Selecione uma categoria para seu aplicativo (por exemplo, Educação)
  5. Adicione um ícone de aplicativo para personalizar seu aplicativo.
  6. Salve suas alterações.


SÃO MODELOS DE FACIL GERENCIAMENTO DE TVWEB E RADIOWEB

São diversas extensões de Domínios ao seu gosto e preferencia, com Add-ons GRÁTIS em todos os nomes de domínio


Configurando a exibição básica do Instagram Agora que você tem um aplicativo do Facebook, é hora de adicionar o produto Instagram Basic Display:

  1. Na barra de navegação à esquerda, clique em "Produtos".
  2. Encontre "Exibição básica do Instagram" e clique em "Configurar".
  3. Depois de adicionado, clique em "Exibição básica" no produto Instagram.
  4. Role para baixo e clique em "Criar novo aplicativo".
  5. Mantenha o nome de exibição como está e clique em "Criar aplicativo".
  6. Após criar o aplicativo do Instagram, você verá informações importantes, como o ID do aplicativo e o segredo do aplicativo. Guarde-o em local seguro, pois você precisará deles mais tarde.

Em seguida, configure as URLs possíveis:

  1. Role para baixo até "URIs de redirecionamento de OAuth válidos".
  2. Insira uma URL para onde os usuários serão redirecionados após autenticação.
  3. Preencha a URL de retorno de chamada de desautorização e a URL de solicitação de exclusão de dados com o endereço do seu site por enquanto.
  4. Adicionando um usuário de teste do Instagram

Para testar a funcionalidade do seu aplicativo, você precisa adicionar como um usuário de teste do Instagram:

  1. Expanda a seção "Funções" na barra lateral esquerda e clique em "Funções".
  2. Role para baixo até a seção "Testadores do Instagram".
  3. Clique em "Adicionar testadores do Instagram".
  4. Digite seu nome de usuário do Instagram e envie o convite.

Para aceitar o convite:

  1. Entre na sua conta do Instagram em www.instagram.com.
  2. Acesse seu perfil e clique em "Editar perfil".
  3. Navegue até "Aplicativos e sites" > "Convites para testadores".
  4. Encontre o convite do seu aplicativo e clique em “Aceitar”.


SÃO DIVERSOS MODELOS PARA SEU BLOSPOT A SEU GOSTO

Após a acessibilidade, sua conta do Instagram se torna elegível para testar seu aplicativo enquanto ele estiver no Modo de Desenvolvimento.

Lembre-se de que a API de exibição básica do Instagram será descontinuada em 4 de dezembro de 2024. É planejado a migração para a API mais recente do Instagram para garantir que seus serviços continuem sem interrupções.

Seguindo estes passos, você configurou com sucesso seu ambiente da API de Exibição Básica do Instagram. Agora você tem um aplicativo do Facebook com a Exibição Básica do Instagram configurada e um usuário de teste adicionado. Esta configuração permite que você comece a desenvolver e testar a integração do seu aplicativo com os recursos do Instagram.

Nos próximos tópicos, exploraremos como obter tokens de acesso e fazer ofertas de API usando essa configuração. Essas etapas permitirão que você recupere perfis de usuário, mídias e outras informações básicas de conta, abrindo possibilidades para criar experiências envolventes integradas ao Instagram em seus aplicativos.

Obter Tokens de Acesso

Os tokens de acesso são cruciais para autenticar solicitações à API de Exibição Básica do Instagram. Esses tokens permitem que seu aplicativo interaja com a plataforma do Instagram em nome de um usuário. Existem dois tipos de tokens de acesso: de curta duração e de longa duração. Vamos explorar como obter e gerenciar esses tokens de forma eficaz.

Gerando um token de curta duração

Para começar, você precisará gerar um token de acesso de curta duração. Este token é válido por uma hora e serve como ponto de partida para acessar os recursos do Instagram. Veja como obter um token de curta duração:

  1. Navegue até a seção Exibição básica do painel do seu aplicativo do Facebook.
  2. Role para baixo até a seção Gerador de Tokens de Usuário e clique no botão "Gerar Token".
  3. Talvez seja necessário fazer login na sua conta do Instagram novamente para conceder as especificações específicas.
  4. Após a geração, uma janela pop-up exibirá seu token de acesso. Copie este token para uso imediato.

O token de curta duração é obtido por meio de um processo de solicitação. Seu aplicativo direciona o usuário para a janela de autorização do Instagram:

https://api.instagram.com/oauth/authorize ?client_id={instagram-app-id} &redirect_uri={redirect-uri} &scope={scope} &response_type=code

Após o usuário conceder permissão, o Instagram o redirecionará de volta para o URI de redirecionamento especificado com um código de autorização. Este código é válido por uma hora e pode ser usado apenas uma vez.

Para alterar o código de autorização de um token de curta duração, envie uma solicitação POST para:

POST https://api.instagram.com/oauth/access_token

Inclui as seguintes configurações no corpo de sua solicitação:

  • ID do cliente
  • segredo_do_cliente
  • tipo de concessão (definido como " código de autorização")
  • redirecionamento_uri
  • código (o código de autorização que você recebeu)

Se bem-sucedido, a API responderá com uma carga JSON contendo o token de acesso de curta duração e o ID do usuário:

{ "access_token": "IGQVJ...", "user_id": 17841405793187218 }

Trocando por um token de longa duração

Embora os tokens de curta duração sejam úteis, eles expiram rapidamente. Para um acesso mais prolongado, você pode trocar seu token de curta duração por um token de longa duração. Os tokens de longa duração são válidos por 60 dias e podem ser renovados antes de expirarem.

Para trocar seu token de curta duração por um de longa duração, envie uma solicitação GET para:

https://graph.instagram.com/access_token

?grant_type=ig_exchange_token

&client_secret={instagram-app-secret}

&access_token={short-lived-access-token}

Substitua {instagram-app-secret} pelo segredo do seu aplicativo e {short-lived-access-token} pelo token que você acabou de obter.

Se bem-sucedido, a API responderá com uma carga JSON contendo o token de acesso de longa duração:

{ "access_token": "{long-lived-user-access-token}", "token_type": "bearer", "expires_in": 5183944 }

O campo "expires_in" indica o número de segundos até o token expirar (aproximadamente 60 dias).

É importante observar que essa solicitação deve ser feita no lado do servidor para proteger o segredo do seu aplicativo. Depois de obter o token de longa duração, você poderá usá-lo em interfaces no lado do servidor ou enviá-lo ao cliente para uso.

Para manter seu token de longa duração válido, atualize-o antes que ele expire. Você pode atualizar um token de longa duração desde que tenha pelo menos 24 horas de uso, mas não tenha expirado. Para atualizar o token, envie uma solicitação GET para: https://graph.instagram.com/refresh_access_token

?grant_type=ig_refresh_token

&access_token={long-lived-access-token} A atualização do token redefine sua validade para 60 dias a partir da data de atualização. Lembre-se de que os tokens não atualizados dentro de 60 dias expirarão e não poderão mais ser atualizados.

Seguindo estas etapas, você poderá obter e gerenciar tokens de acesso para a API de Exibição Básica do Instagram de forma eficaz. Esses tokens são essenciais para fazer solicitações autenticadas e acessar dados do usuário por meio da API. Na próxima seção, exploraremos como usar esses tokens para fazer conexões de API e recuperar conteúdo do Instagram para seu aplicativo.

Fazendo noite de API

Agora que você obteve os tokens de acesso necessários, é hora de começar a fazer desvantagens de API para recuperar dados do Instagram. A API de Exibição Básica do Instagram permite que você acesse perfis de usuários e conteúdo de mídia. Vamos explorar como usar os endpoints da API de forma eficaz.

Ponto final do perfil do usuário

Para obter informações do perfil de um usuário do Instagram, você pode usar o endpoint do Perfil do Usuário. Este endpoint fornece detalhes básicos sobre a conta do usuário.

Veja como fazer uma solicitação:

  1. Envie uma solicitação GET para o seguinte URL: https://graph.instagram.com/me?fields=id,username&access_token={access-token}
  2. Substitua {access-token} pelo seu token de acesso de longa duração.
  3. A API responderá com uma carga JSON contendo o ID do usuário e o nome do usuário:

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

Você pode personalizar os campos dos parâmetros para solicitar informações adicionais, como tipo de conta e exclusão de mídia. Por exemplo: campos = id, nome de usuário, tipo de conta, contagem de mídia

Ponto de extremidade da mídia do usuário

Para recuperar o conteúdo da mídia de um usuário, incluindo imagens, vídeos e álbuns, você pode usar o endpoint da Mídia do Usuário. Este endpoint permite que você acesse as postagens do usuário e informações relacionadas.

Veja como fazer uma solicitação:

  1. Envie uma solicitação GET para o seguinte URL: https://graph.instagram.com/me/media?fields=id,caption,media_type,media_url,permalink,thumbnail_url,timestamp&access_token={access-token}
  2. Substitua {access-token} pelo seu token de acesso de longa duração.
  3. A API responderá com uma carga JSON contendo uma lista de itens de mídia:

{ "data": [ { "id": "17895695668004550", "caption": "Beautiful sunset!", "media_type": "IMAGE", "media_url": "https://scontent.cdninstagram.com/v/t51.29350-15/123456789_123456789_n.jpg", "permalink": "https://www.instagram.com/p/ABC123/", "timestamp": "2023-05-01T18:30:00+0000" }, // More media items... ], "paging": { "cursors": { "before": "QVFIUjNfZADJoZD", "after": "QVFIUmFfZADJoZD" }, "next": "https://graph.instagram.com/me/media?fields=id,caption,media_type,media_url,permalink,thumbnail_url,timestamp&access_token={access-token}&after=QVFIUmFfZADJoZD" } }

A resposta inclui detalhes detalhados sobre cada item de mídia, como ID, legenda, tipo de mídia, URL e registro de dados e hora.

Paginação

Ao lidar com grandes quantidades de dados, a API de Exibição Básica do Instagram usa paginação baseada em cursor para gerenciar os resultados. Isso permite que você recupere dados em blocos menores e mais simples de gerenciar. Veja como a paginação funciona:

  1. Na resposta inicial da API, você receberá um objeto de paginação contendo cursores e uma próxima URL.
  2. Para acessar a próxima página de resultados, use o próximo URL fornecido na resposta. Este URL inclui as informações sobre o cursor.
  3. Continue fazendo transações usando a próxima URL até chegar ao final do conjunto de dados, indicado pela ausência de uma próxima URL na resposta.
  4. Para navegar nas páginas anteriores, use o cursor anterior fornecido no objeto cursors.

Exemplo de uso de paginação:

  1. Faça uma solicitação inicial para recuperar itens de mídia.
  2. Verifique se há uma próxima URL no objeto de paginação da resposta.
  3. Se houver uma próxima URL, faça outra solicitação usando essa URL para obter a próxima página de resultados.
  4. Repita as etapas 2 e 3 até que não haja mais URL, indicando que você chegou ao fim do conjunto de dados.

Ao usar a paginação, você pode recuperar grandes quantidades de dados com eficiência sem sobrecarregar seu aplicativo ou atingir os limites de taxas da API. Lembre-se de lidar com a paginação corretamente no seu código para garantir a recuperação de todos os dados desejados.

Implementando uma API em seu aplicativo

Agora que você já tem um conhecimento sólido de como configurar a API de Exibição Básica do Instagram e obter tokens de acesso, é hora de implementar a API em seu aplicativo. Esta seção orientará você pelo processo de integração da API ao seu projeto, fornecendo código de exemplo, práticas recomendadas e técnicas de tratamento de erros.

Código de exemplo

Para começar a implementar a API de Exibição Básica do Instagram em seu aplicativo, você precisa fazer ofertas HTTP para endpoints da API. Aqui está um exemplo básico usando Python e uma biblioteca de proteção:

import requests access_token = 'YOUR_ACCESS_TOKEN' user_id = 'YOUR_USER_ID' # Fetch user profile information profile_url = f'https://graph.instagram.com/{user_id}?fields=id,username&access_token={access_token}' profile_response = requests.get(profile_url) profile_data = profile_response.json() print(f"Username: {profile_data['username']}") # Fetch user's media media_url = f'https://graph.instagram.com/me/media?fields=id,caption,media_type,media_url,permalink,thumbnail_url,timestamp&access_token={access_token}' media_response = requests.get(media_url) media_data = media_response.json() for item in media_data['data']: print(f"Media ID: {item['id']}") print(f"Caption: {item.get('caption', 'No caption')}") print(f"Media Type: {item['media_type']}") print(f"Media URL: {item['media_url']}") print("---")

Este código de exemplo demonstra como buscar informações de perfil de um usuário e itens de mídia recentes usando a API de Exibição Básica do Instagram. Você pode expandir este código para criar recursos mais complexos em seu aplicativo.

Melhores Práticas

Ao implementar a API de exibição básica do Instagram em seu aplicativo, é importante seguir estas práticas recomendadas:

  1. Gerenciamento de Tokens: Armazene tokens de acesso com segurança e implemente um mecanismo para atualizar tokens de longa duração antes que expirem. Isso garante acesso ininterrupto à API.
  2. Limitação de Taxa: Esteja atento aos limites de taxa da API. Implemente estratégias corretas de tratamento de erros e proteção para evitar ultrapassar esses limites e bloquear seu aplicativo.
  3. Cache: para reduzir chamadas de API e melhorar o desempenho, armazene em cache as respostas da API quando limpa. Isso é particularmente útil para dados que não mudam com frequência, como perfis de usuários.
  4. Paginação: Ao buscar grandes quantidades de dados, utilize os recursos de paginação fornecidos pela API. Isso permite que você recupere dados em blocos menores e mais simples de gerenciar.
  5. Registro de erros: implemente um registro de erros abrangente para rastrear e diagnosticar problemas com alterações de API. Isso ajudará você a identificar e resolver problemas rapidamente.
  6. Consentimento do Usuário: Sempre obtenha o consentimento adequado do usuário antes de acessar seus dados do Instagram. Comunique quais dados você acessará e como claramente eles serão usados.
  7. Acompanhe as mudanças: mantenha-se informado sobre as atualizações da API de exibição básica do Instagram. O Meta atualiza suas APIs com frequência e é crucial adaptar seu aplicativo de acordo.

Tratamento de erros

O tratamento adequado de erros é crucial ao trabalhar com APIs externos. A API de Exibição Básica do Instagram pode retornar diversas respostas de erro, e seu aplicativo deve estar preparado para lidar com elas sem problemas. Veja um exemplo de como implementar o tratamento básico de erros:

import requests def make_api_request(url): try: response = requests.get(url) response.raise_for_status() # Raises an HTTPError for bad responses return response.json() except requests.exceptions.HTTPError as http_err: print(f"HTTP error occurred: {http_err}") # Handle specific HTTP errors (e.g., 404, 500) except requests.exceptions.ConnectionError as conn_err: print(f"Error connecting: {conn_err}") # Handle connection errors except requests.exceptions.Timeout as timeout_err: print(f"Timeout error: {timeout_err}") # Handle timeout errors except requests.exceptions.RequestException as req_err: print(f"An error occurred: {req_err}") # Handle any other requests-related errors return None # Usage access_token = 'YOUR_ACCESS_TOKEN' user_id = 'YOUR_USER_ID' profile_url = f'https://graph.instagram.com/{user_id}?fields=id,username&access_token={access_token}' profile_data = make_api_request(profile_url) if profile_data: print(f"Username: {profile_data['username']}") else: print("Failed to fetch profile data")

Essa abordagem de tratamento de erros permite gerenciar com eficiência diferentes tipos de erros que podem ocorrer ao fazer solicitações de API. Você pode expandir isso para incluir um tratamento de erros mais específico com base nas respostas de erro da API.

Lembre-se de que a API de Exibição Básica do Instagram será descontinuada em 4 de dezembro de 2024. É crucial planejar a migração do seu aplicativo para a API mais recente do Instagram para garantir a continuidade do serviço. Fique de olho na documentação do desenvolvedor do Meta para atualizações e guias de migração.

Seguindo estas diretrizes de implementação, práticas recomendadas e técnicas de tratamento de erros, você estará bem equipado para integrar a API de Exibição Básica do Instagram ao seu aplicativo de forma eficaz. Isso permitirá que você crie experiências envolventes para seus usuários, mantendo uma integração robusta e confiável com a plataforma do Instagram.

Perguntas frequentes:

1. A API de exibição básica do Instagram ainda estará disponível em 2025?

Não, a API de Exibição Básica do Instagram foi oficialmente descontinuada em 4 de dezembro de 2024. A partir de 2025, ela não será mais suportada pelo Meta. Os desenvolvedores são fortemente encorajados a migrar para a API de Gráfico do Instagram , que oferece funcionalidades mais amplas e melhor segurança.

2. Qual é a diferença entre a API de exibição básica do Instagram e a API de gráficos?

A API de Exibição Básica foi projetada para casos de uso mais simples, como exibir o perfil e as mídias de um usuário. A API de Gráficos do Instagram , por outro lado, oferece suporte a recursos avançados, como publicação de posts, leitura de insights e moderação de comentários, e está disponível apenas para contas Empresariais e de Criador .

3. Ainda posso recuperar fotos ou vídeos de usuários do Instagram em 2025?

Sim, mas agora você deve usar a API do Instagram Graph , e somente se o usuário tiver uma conta comercial ou de criador conectada a uma página do Facebook. O acesso ao contato pessoal não está mais disponível por meio de nenhuma API pública.

4. O que devo usar em vez da API de exibição básica?

A Meta recomenda migrar para a API Graph do Instagram , que oferece:

  • Acesso à mídia e ao perfil
  • Dados de Reel e Story
  • Insights sobre público e engajamento
  • Capacidades de publicação (via API de publicação de conteúdo)

Você precisará reconfigurar seu aplicativo do Facebook e solicitar as permissões necessárias.

5. Como faço para migrar a API de exibição básica para a API de gráficos?

Para migrar, você deve:

  • Converta contas do Instagram para tipos Empresariais ou Criadores
  • Contas vinculadas a uma página do Facebook
  • Reconfigure seu aplicativo com permissões da API do Instagram Graph (por exemplo, instagram_basic, pages_show_list, ads_management)
  • Siga o guia de integração da Graph API da Meta

Mensagem de erro: "Função de desenvolvedor é insuficiente: Função de desenvolvedor é insuficiente"

mensagemd%20e%20rro

Vamos consertar esse erro:

  1. Entrar no https://business.facebook.com/
  2. Entrar no menu a esquerda e clicam em configurações.
  3. Entrar no menu de informações da empresa clique em Apps, seleciona o aplicativo e clica nos 3 pontinhos e clica em abrir no painel de Apps.
  4. No menu a esquerda clica em Configurações do App e depois clica em Básico, em verificações clica em inciar verificação e faz todas etapas que eles pedir.
  5. Caso continue apresentando o erro:
  6. No menu a esquerda clica em Funções do app e depois clica em funções.
  7. Clica no botão azul escrito Adcionar pessoas.
  8. Em Adicionar pessoas ao seu aplicativo seleciona a a ultima opção Testador do Instagram, clica no botão azul de adcionar
  9. Na barra de pequisa escrito Insira o nome de usuário da conta do Instagram que você deseja adicionar, vocês vão colocar o @doinstagram da loja de vocês, após isso clica no botão azul escrito adcionar.
  10. Tera escrito Testador do Instagram Os usuários do Instagram podem gerenciar os convites na seção [Apps e sites] do perfil.
  11. Clica em [Apps e sites] que esta escrito de azul, logam o instagram e aceitam o controle o total onde vai ativar todas funções.
  12. Só gerar o token.

por MBS Multimídia e Tecnologia