Configure sua própria API Key do X

​

Etapa 1: Crie sua conta de desenvolvedor no X

1

Entre no Developer Console

Acesse console.x.com e entre com sua conta do X. Consulte o guia de introdução do X se precisar de ajuda.

2

Conclua o onboarding

Conclua o onboarding de desenvolvedor e aceite o Developer Agreement e as políticas.

3

Acesse o console

Você agora está no X Developer Console.

​

Etapa 2: Crie um app

1

Navegue até Apps

No Developer Console, navegue até Apps.

2

Crie o app

No painel de Apps, clique em Create App (consulte a documentação de configuração do App do X para detalhes). Insira um nome de app (normalmente o nome da sua marca). Esse nome aparecerá na tela de autorização OAuth quando os usuários conectarem sua conta do X.

3

Selecione o ambiente

Selecione o ambiente Production no menu suspenso.

4

Feche o pop-up inicial de credenciais

O X gerará várias credenciais. Ignore essas credenciais e feche esta janela.

​

Etapa 3: Configure as permissões do app

1

Abra as configurações do seu app

Em “Apps”, localize o novo app (atualize a página se ele não aparecer) e, em seguida, clique nele para ver os detalhes.Em User authentication settings, clique em Set up.

2

Defina as permissões do app

Em App permissions, selecione Read and write and Direct message. Isso é necessário para suporte completo aos recursos, incluindo publicação e DMs.

3

Defina o tipo de app

Em Type of App, selecione Web App, Automated App or Bot. Essa é a escolha correta para integrações do lado do servidor como a do Ayrshare.

4

Defina a callback e a URL do site

Em App info:

• Callback URL: adicione as duas URLs de callback a seguir:
  • https://profile.ayrshare.com/social-accounts
  • https://app.ayrshare.com/social-accounts
• Website URL: https://app.ayrshare.com

Não pule esta etapa. Essas callback URLs são obrigatórias para o fluxo de vinculação OAuth. Quando seus usuários finais autorizam a conexão do X, o X os redireciona de volta para uma dessas URLs para concluir o processo de vinculação. Se elas estiverem ausentes, o fluxo OAuth falhará com um erro 403 Callback URL not approved.

5

Salve suas configurações

Clique em Save. Você pode ignorar o pop-up de OAuth 2.0, pois usará apenas 2 das chaves de OAuth 1.0 (API Key e API Secret).

Importante: defina as permissões antes de vincular. As permissões que você escolhe aqui determinam o que seu app pode fazer. Se você alterar as permissões após vincular sua conta do X via OAuth, precisará vincular novamente para que o novo Access Token herde as permissões atualizadas.

1. API Key (também chamada de Consumer Key, o identificador do app do X)
2. API Secret (também chamada de Consumer Secret)

​

Etapa 4: Compre créditos da API do X

1

Navegue até o faturamento

No Developer Console, clique em Billing → Credits na barra lateral esquerda.

2

Compre créditos

Compre créditos (o mínimo é $5, o que é suficiente para centenas de chamadas de API). Cada chamada de API custa uma fração de centavo, então o custo deve ser mínimo para a maioria dos usuários.

3

Habilite a recarga automática

Você pode habilitar a auto-recharge para evitar interrupções de serviço e gerenciar seu limite de gastos definindo um valor máximo que pode gastar em seu ciclo de faturamento.

​

Etapa 5: Atualize suas chamadas de API do Ayrshare

1. API Key (também chamada de Consumer Key, o identificador do app do X)
2. API Secret (também chamada de Consumer Secret)

​

Referência de headers

​

Exemplos de código

curl -X POST https://api.ayrshare.com/api/post \
  -H "Authorization: Bearer YOUR_AYRSHARE_API_KEY" \
  -H "X-Twitter-OAuth1-Api-Key: your_api_key" \
  -H "X-Twitter-OAuth1-Api-Secret: your_api_secret" \
  -H "Content-Type: application/json" \
  -d '{"post": "Hello from my own X App!", "platforms": ["twitter"]}'

const response = await fetch("https://api.ayrshare.com/api/post", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_AYRSHARE_API_KEY",
    "Content-Type": "application/json",
    "X-Twitter-OAuth1-Api-Key": process.env.X_API_KEY,
    "X-Twitter-OAuth1-Api-Secret": process.env.X_API_SECRET,
  },
  body: JSON.stringify({
    post: "Hello from my own X App!",
    platforms: ["twitter"],
  }),
});

import os
import requests

headers = {
    "Authorization": "Bearer YOUR_AYRSHARE_API_KEY",
    "Content-Type": "application/json",
    "X-Twitter-OAuth1-Api-Key": os.environ["X_API_KEY"],
    "X-Twitter-OAuth1-Api-Secret": os.environ["X_API_SECRET"],
}

response = requests.post(
    "https://api.ayrshare.com/api/post",
    headers=headers,
    json={"post": "Hello from my own X App!", "platforms": ["twitter"]},
)

​

Migrando profiles existentes (Business & Enterprise)

{
  "domain": "your-domain",
  "profileKey": "...",
  "privateKey": "...",
  "twitterApiKey": "YOUR_X_CONSUMER_KEY",
  "twitterApiSecret": "YOUR_X_CONSUMER_SECRET"
}

​

Verifique sua configuração

​

Como funciona a precificação da API do X

​

Benefícios de usar sua própria API Key do X

• Experiência OAuth com sua marca: os usuários veem o nome do seu app e sua marca ao autorizar o acesso ao X.
• Limites de taxa dedicados: seu uso da API é regido pelos limites da sua própria conta de desenvolvedor do X, separada de outros usuários do Ayrshare. Você pode monitorar seu uso no X Developer Console e revisar a documentação de rate limits da API do X.
• Controle de credenciais: sua API Key e Secret permanecem em sua própria conta de desenvolvedor do X. O Ayrshare não armazena suas chaves secretas.
• Portabilidade: como os usuários se autenticam com seu X App, sua integração permanece totalmente sob seu controle.
• Visibilidade de uso: seu painel de desenvolvedor do X mostra requisições de API, limites de taxa e uso de créditos.

​

Segurança

• Sua API Key e API Secret não são armazenadas pelo Ayrshare.
• Para boas práticas gerais de segurança, consulte o guia de segurança de autenticação do X.

​

FAQ

​

Solução de problemas

​

Precisa de ajuda?