Chaves de API e autenticação

Uma chave de API permite que seu próprio código, os SDKs do Posty5, o n8n e assistentes de IA trabalhem com sua conta do Posty5. Esta página explica como as chaves funcionam, e as outras páginas para desenvolvedores têm um link para cá em vez de repetir isso.

Obtenha uma conta de desenvolvedor

As chaves de API são um recurso da conta de desenvolvedor. O upgrade é gratuito e vale na hora. Ele não altera seu plano nem seus créditos.

No painel do Posty5, abra Configurações da conta e escolha Chaves de API.
Escolha Fazer upgrade para desenvolvedor. A página é recarregada com suas chaves de API e as formas de se conectar ao Posty5.

Abra Chaves de API no painel

Crie uma chave

Em Chaves de API, escolha Criar chave de API.
Dê à chave um nome que diga onde ela é usada, por exemplo Formulário de contato do site. O nome é só para você.
Escolha o escopo dos registros dela (explicado abaixo) e escolha Criar. A nova chave aparece com um botão de copiar.

A chave não é mostrada só uma vez. A lista mostra cada chave mascarada, e o botão de copiar copia a chave inteira de novo sempre que você precisar. Renomeie uma chave ou altere o escopo dos registros dela pelas ações na lista.

Envie a chave em cada solicitação

Envie a chave neste cabeçalho em cada solicitação à API do Posty5 —

A API fica em

Para verificar uma chave, chame a rota que a descreve. Ela responde com a chave, o dono dela, o plano e os créditos que a conta pode gastar. Uma chave revogada ou desconhecida recebe 401.

curl https://api.posty5.com/api/api-key/current \
  -H "X-API-Key: YOUR_API_KEY"

Os SDKs e os nós do n8n usam a mesma chave.

Cliente	Onde vai a chave	Saiba mais
JavaScript / TypeScript	`new HttpClient({ apiKey: "YOUR_API_KEY" })`	npm-sdk
.NET	`new Posty5Options { ApiKey = "YOUR_API_KEY" }`	dotnet-sdk
n8n	A credencial Posty5 API, no campo API Key	n8n-nodes

Escolha o que uma chave pode ver

Toda chave tem um escopo dos registros. Ele define quais dos seus registros a chave pode listar e editar.

Escopo dos registros	O que a chave pode listar e editar
Somente registros criados com esta chave	Somente os registros que esta chave criou. Os registros que você fez no painel ou com outra chave ficam fora do alcance dela, então duas integrações nunca mexem no trabalho uma da outra.
Toda a minha conta	Todos os registros da sua conta, onde quer que tenham sido criados. Um assistente de IA geralmente precisa disso, porque você pergunta a ele sobre coisas que você mesmo criou.

Uma chave nova começa com Somente registros criados com esta chave, assim como toda chave criada antes de esta configuração existir. Para mudar, abra as ações da chave e escolha Alterar o escopo dos registros. O link MCP de uma chave usa o escopo dos registros dessa chave.

Último uso e revogação de uma chave

A coluna Último uso mostra quando a chave fez a última solicitação. Ela é atualizada no máximo uma vez a cada poucos minutos, então uma chave em uso constante pode parecer alguns minutos atrasada.

Para revogar uma chave, abra as ações dela na lista, escolha Revogar e confirme.

Ela para de funcionar na hora. Todo app, script e integração que a usa recebe 401 na próxima solicitação.
O link de assistente de IA (MCP) dela para no mesmo instante.
A revogação não pode ser desfeita. Crie uma nova chave se precisar de uma novamente.
O que a chave já fez permanece. Os registros que ela criou continuam na sua conta, e as publicações que ela agendou ainda são publicadas no horário, porque a publicação agendada não usa a chave.

Créditos

Uma chamada feita com uma chave de API custa exatamente o mesmo que a mesma ação no painel, e os créditos saem da conta dona da chave. O preço de cada ação está listado em Créditos de recursos

Mantenha as chaves seguras

Mantenha as chaves em um servidor. Nunca coloque uma em uma página da web, em um app para celular ou em um repositório público — qualquer pessoa que a leia pode agir como você.
Uma chave não pode gerenciar chaves. Criar, listar, renomear e revogar chaves só funciona enquanto você está conectado ao Posty5, então uma chave vazada não consegue ler suas outras chaves nem criar novas.
Para fazer a rotação de uma chave, crie uma nova, mude sua integração para ela, verifique se a data de Último uso da nova chave é atualizada e então revogue a chave antiga.
Se uma chave vazar, revogue-a imediatamente e crie uma nova.