Pular para o conteúdo principal
Este guia é para configurar uma única empresa. Para assinaturas do Business Plan e Enterprise Plan com múltiplos usuários, é fornecido um guia de integração personalizado.

Conecte Suas Contas de Redes Sociais

Faça login ou cadastre-se em uma conta Ayrshare. Na página Social Account, clique nas redes sociais que você quer conectar. Por favor, conceda todas as permissões.

Exemplo de vinculação do Facebook

Obtenha Sua API Key

Uma API Key é necessária para autorizar o acesso aos endpoints da API. Essa chave é usada no header das suas requisições e deve ser precedida pela palavra-chave Bearer. Sua API Key está localizada no Painel Ayrshare, na página API Key. Se necessário, mude para seu ‘Primary Profile’ pela página User Profiles. A partir daí, você pode encontrar a página API Key no painel lateral esquerdo. API Key Toda chamada de API deve incluir a API Key no Header usando um Token Bearer. Inclua também o Content-Type de application/json.
Header
Consulte Authorization para mais informações.

Envie Sua Primeira Publicação via API

Publicando o Post

Abaixo estão exemplos de código mostrando como fazer uma publicação usando nossa API em diferentes linguagens de programação. Para uma integração ainda mais fácil, você pode usar um de nossos pacotes SDK pré-construídos. Para fazer uma publicação, você precisará de:
  • Sua API Key para autenticação.
  • O conteúdo de texto da sua publicação.
  • As plataformas de redes sociais em que você quer publicar (inclua apenas as plataformas que você vinculou).
  • Opcional: URLs de quaisquer imagens ou vídeos que você queira incluir.
Todos os exemplos usam o endpoint /post. Vamos ver um código de exemplo:
Publicando no X/Twitter? O X exige suas próprias credenciais de API. Adicione 2 headers BYO (X-Twitter-OAuth1-Api-Key e X-Twitter-OAuth1-Api-Secret) à sua requisição. Esta é uma configuração única por conta Ayrshare, e o mesmo par de chaves funciona para todo sub-profile / usuário final. Veja o guia de configuração para mais detalhes.
Parabéns! Você acabou de enviar sua primeira publicação.

Resposta do Post

Você receberá uma resposta com um status de “success” quando nossa API processar sua publicação com sucesso. A resposta inclui:
  • status: Status geral da chamada de API (“success” ou “error”)
  • errors: Array de quaisquer erros encontrados (vazio se bem-sucedido)
  • postIds: Array de objetos contendo detalhes específicos de cada plataforma:
    • Nome da plataforma
    • ID da publicação nessa plataforma
    • URL para visualizar a publicação
    • Informações adicionais específicas da plataforma
Cada plataforma no array postIds terá seu próprio status, permitindo verificar quais plataformas receberam sua publicação com sucesso. Verifique suas páginas de redes sociais para garantir que a publicação foi processada com sucesso e está no ar. Observe que algumas plataformas podem ter um pequeno atraso antes que as publicações apareçam publicamente. Aqui está um exemplo de resposta:
Post Response
Veja mais exemplos de código chamando a API de redes sociais em Node.js, Python, PHP, Golang, C# e Ruby, além de outras ótimas funcionalidades:

Post

Aprofundando um Pouco Mais

Vamos detalhar o processo do que aconteceu quando fizemos essa chamada de API.
1

Configurar o Header

Definimos o token bearer de Authorization do header (API Key) e o content type json.
2

Criar um Objeto de Corpo

Em seguida, criamos um objeto de corpo:
  • Publicação contendo o texto “Today is a great day!”.
  • Plataformas de redes sociais Facebook, Instagram e LinkedIn. Você só deve incluir as plataformas que vinculou na Social Linkage Page.
  • Adicionamos uma imagem em mediaUrls.
3

Chamar o Endpoint /post

Enviamos tudo como uma requisição HTTP POST para o endpoint /post.

Antes de Você Ir, Algumas Boas Práticas

Leia a Documentação

Mantemos uma documentação extensa e atualizada. Já que você está aqui, tire um tempo para conferir as seções da documentação na navegação à esquerda.

Códigos de Erro São Importantes

Você precisa lidar com eles para que seus usuários tenham uma ótima experiência.

Erros

Mantenha Sua API Key Segura

Levamos segurança muito a sério, e você também deve. Você tem controle total sobre a conexão entre a Ayrshare e suas contas de redes sociais. Uma vez que as contas estão conectadas, a API Key da Ayrshare se torna a forma de você se autenticar. Por favor, mantenha essa chave secreta e segura.

Publique Publicações de Teste

Você pode publicar publicações de teste com uma citação, imagem ou vídeo aleatório usando os parâmetros randomPost, randomMediaUrl e isLandscapeVideo ou isPortraitVideo no endpoint /post. Se você usar o randomPost, o parâmetro post não é obrigatório.
Essas publicações ficam ao vivo nas suas páginas de redes sociais, então, se for apropriado, exclua-as após os testes.

Citação Aleatória

Envie uma citação aleatória para testar a publicação adicionando randomPost: true. Usado com o endpoint /post.

Imagem Aleatória

Envie uma imagem aleatória adicionando randomMediaUrl: true. Usado com o endpoint /post.

Vídeo Aleatório

Envie um vídeo em paisagem aleatório adicionando isVideo: true e isLandscapeVideo: true. O vídeo terá o tamanho padrão de paisagem. Usado com o endpoint /post.
Envie um vídeo em retrato aleatório, necessário para TikTok ou Reels do Facebook/Instagram, adicionando isVideo: true e isPortraitVideo: true. Usado com o endpoint /post.

Comentário Aleatório

Envie um comentário aleatório para testar a publicação de um comentário adicionando randomComment: true. Usado com o endpoint /comment.

Exemplo de Chamada cURL

Envie uma citação aleatória e um vídeo em retrato.

Use o Postman para Testar Suas Chamadas de API

Postman é uma ferramenta incrível para testar chamadas de API. Você pode até gerar código em mais de uma dezena de linguagens.

Código Demo

Se você procura um projeto de demonstração em React e NodeJS, veja este repositório no GitHub:

Aplicativo Demo de Publicação Social no Github

Solução de Problemas Comuns

Às vezes as coisas não vão bem, então aqui está uma pequena ajuda em nossa central de ajuda.

Solução de Problemas

Fale Conosco para Ajuda

Estamos aqui para ajudar, então use o chat no canto inferior direito ou nos envie um e-mail.