Desligue para o conteúdo principal

Busca

Digite uma palavra ou uma pergunta para procurar os artigos de ajuda.

Como criar uma chave de API?

Nesta história

Onde: Configurações → Avançado → Conectar outros aplicativos

Abra esta página: admin.<your-site>/settings/integrations (troque <your-site> pelo endereço do seu site). Se não encontrar essa opção no menu, ative Mostrar todas as configurações na página de Configurações.

Antes de começar

  • Apenas o dono do site pode criar chaves.

Passo a passo

  1. Abra Configurações → Avançado → Conectar outros apps → Chaves de API.
  2. Toque em Criar chave.
  3. Digite um Nome, por exemplo "Site parceiro".
  4. Em O que ela pode fazer? marque o que for necessário:
    • Ler matérias: artigos publicados, sem conteúdo pago.
    • Ler texto completo para assinantes: também o texto completo dos artigos pagos.
    • Enviar rascunhos: salvar artigos como rascunhos. Nada vai ao ar sem a aprovação da sua equipe.
    • Enviar fotos: adicionar fotos à sua biblioteca de mídia a partir de um endereço da web.
    • Ler editorias e tags.
    • Ler números de tráfego: visualizações de artigos e total de visitantes.
    • Ler relatórios financeiros: apenas os totais, nunca os leitores.
  5. Opcional: defina Expira em, Apenas destes endereços (um por linha, até 20), Requisições por minuto (1 a 600) e Requisições por dia (1 a 1.000.000).
  6. Toque em Criar chave.
  7. Copie a chave exibida na caixa. Esta é a única vez que você a verá. Toque em Já salvei.
  8. Envie a chave para o outro aplicativo. Ele a enviará no cabeçalho "Authorization: Bearer".

Importante saber

  • A lista mostra de cada chave o Nome, Permissões, Último uso, Expira em e Status: Funcionando, Expirada ou Interrompido.
  • O botão Criar uma nova chave substitui uma chave. A chave antiga continua funcionando pelo período que você escolher, ou escolha Parar agora caso ela tenha vazado.
  • O botão Interromper chave bloqueia todas as requisições com essa chave na hora. Não é possível desfazer isso. Crie uma nova chave para permitir o acesso do aplicativo novamente.
  • Os detalhes de uma chave mostram o uso dela nos últimos 30 dias.
  • Cada chave tem seus próprios limites. Aplicativos que fazem requisições em excesso têm o acesso reduzido temporariamente.
  • Uma chave com acesso a conteúdo pago permite que qualquer pessoa de posse dela leia os artigos fechados. Mantenha-a em segurança.

Problemas comuns

  • "Você atingiu o limite de chaves disponíveis. Desative primeiro uma chave que você não usa mais."
  • "Dê um nome para a chave."
  • "Escolha pelo menos uma ação permitida para a chave."
  • "Escolha uma data futura."

Dúvidas frequentes

Perguntas frequentes

Posso ver a chave novamente mais tarde?

Não. Se precisar, gere uma nova chave.

Posso usar a mesma chave em vários aplicativos?

Pode, mas o ideal é criar uma chave para cada app para desativar apenas um deles quando precisar.

Artigos relacionados

Feedback

Isto ajudou?

Também disponível em

Ainda precisas de ajuda?