Chaves de API

Quer acessar seus dados por conta própria — um sistema interno, um script, uma integração sob medida? Use as chaves de API da sua organização.

Gerando uma chave

1. Vá em Configurações → Chaves de API.
2. Clique em criar, dê um nome que ajude a identificar o uso (ex.: “Integração ERP”).
3. Copie a chave que aparece — ela começa com iuzy_sk_.

O valor completo da chave é mostrado uma única vez, na criação. Guarde em local seguro; se perder, gere outra e revogue a antiga.

Usando a chave

Autentique cada chamada com o cabeçalho:

Authorization: Bearer iuzy_sk_...

A chave pertence à organização e responde com os dados dela. Consulte a documentação para os endpoints disponíveis.

Segurança

• As chaves são guardadas com hash — a IuzyPay não consegue exibir de novo o valor completo; a lista mostra só o prefixo.
• Revogue na hora qualquer chave que vazou ou parou de ser usada. A revogação é imediata.
• Trate a chave como uma senha: nunca a exponha no navegador nem em repositórios públicos.

Chave de API x integrações prontas

Se a ferramenta que você quer conectar já está no catálogo de integrações, use a integração — é mais simples. As chaves de API são para acesso programático direto, quando você mesmo desenvolve a ligação.