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.
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-chaveBearer.
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.

Bearer. Inclua também o Content-Type de application/json.
Header
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.
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.Resposta do Post
Você receberá uma resposta com umstatus 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
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
Post
Aprofundando um Pouco Mais
Vamos detalhar o processo do que aconteceu quando fizemos essa chamada de API.Configurar o Header
Definimos o token bearer de Authorization do header (API Key) e o content type
json.
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.
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âmetrosrandomPost, randomMediaUrl e isLandscapeVideo ou isPortraitVideo no endpoint /post. Se você usar o randomPost, o parâmetro post não é obrigatório.
Citação Aleatória
Envie uma citação aleatória para testar a publicação adicionandorandomPost: true.
Usado com o endpoint /post.
Imagem Aleatória
Envie uma imagem aleatória adicionandorandomMediaUrl: true.
Usado com o endpoint /post.
Vídeo Aleatório
Envie um vídeo em paisagem aleatório adicionandoisVideo: true e isLandscapeVideo: true.
O vídeo terá o tamanho padrão de paisagem.
Usado com o endpoint /post.
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 adicionandorandomComment: true.
Usado com o endpoint /comment.
