Pular para o conteúdo

Como criar uma chave de API para a interface de programação?

Revisado em 2 min de leitura

Em Programmschnittstelle, toque em “Schlüssel anlegen”, escolha as permissões e confirme com o seu código. O tiaki mostra o segredo uma única vez – copie na hora.

Abrir no app Quem pode fazer isso? Proprietário, Administrador
Nesta página

Pela interface de programação (API), outros programas – por exemplo, serviços de newsletter como Brevo ou CleverReach, seu CRM ou Zapier e Make – buscam seus contatos no tiaki, junto com o comprovante de consentimento.

Passo a passo

  1. Abra o menu do workspace (nome da empresa no topo) e, nele, Programmschnittstelle (interface de programação).
  2. Em Schlüssel (chaves), toque em Schlüssel anlegen (criar chave).
  3. Em Wofür? (para quê?), digite um nome, por exemplo “Brevo”.
  4. Em Was darf der Schlüssel? (o que a chave pode fazer?), escolha Kontakte lesen (ler contatos), Einwilligungen lesen (ler consentimentos) e, se precisar, Kontakte anlegen und ergänzen (criar e completar contatos).
  5. Em Gültig (validade), escolha por quanto tempo a chave vale – ou läuft nicht ab (não expira).
  6. Digite o Bestätigungscode (código de confirmação) do seu app autenticador e toque em Schlüssel anlegen.
  7. Agora copie o Schlüssel-ID (ID da chave) e o Geheimnis (segredo) e cole os dois no seu programa.

Atenção: O tiaki mostra o segredo só desta vez. Perdeu? É só criar uma chave nova e revogar a antiga.

Dica: Se o seu programa pedir “usuário” e “senha”, use o ID da chave como usuário e o segredo como senha. Se ele pedir um “Bearer token”, copie o campo Bearer-Token (ID.Geheimnis). Um guia com exemplos está em Anleitung mit Beispielen (guia com exemplos).

Em Protokoll (registro), você vê cada acesso feito com uma chave; com Widerrufen (revogar), você a bloqueia na hora.

Não funcionou?

  • “Die Programmschnittstelle ist Teil jedes Tarifs” (a interface de programação faz parte de todos os planos): No período de teste ela fica bloqueada. Escolha um plano e aí você pode criar chaves.
  • Você não vê nenhum botão: Só Proprietários e Administradores configuram chaves e webhooks.
  • Seu programa é recusado: Veja se a chave está abgelaufen (expirada) ou widerrufen (revogada). Se você cadastrou uma liberação de IP, deixe-a vazia para Zapier e Make – os endereços deles mudam.
  • Não conseguiu resolver? Fale com a gente em Fazer uma pergunta no Helpdesk.

Artigos relacionados

Ainda tem dúvidas sobre este artigo?

Escreva para nós – cuidamos disso pessoalmente e respondemos por e-mail.

PT