Pular para o conteúdo
POST AI agent ready /v1/encrypt/decrypt

API de descriptografia AES-256 - descriptografia de texto livre

Envie a string criptografada produzida pelo endpoint criptografado junto com a senha original para recuperar o texto simples. A descriptografia acontece no lado do servidor na memória; nem o texto cifrado nem o texto simples recuperado são armazenados ou registrados.

Parameters

stringrequired

The base64-encoded ciphertext returned by the /v1/encrypt/encrypt endpoint.

stringrequired

The same password used during encryption.

Code examples

curl -X POST https://api.botoi.com/v1/encrypt/decrypt \
  -H "Content-Type: application/json" \
  -d '{"ciphertext":"base64-encoded salt+iv+encrypted data","password":"my-strong-password-2026"}'

When to use this API

Descriptografar valores de configuração na inicialização do aplicativo

Armazene credenciais de banco de dados criptografadas e chaves de API em seus arquivos de configuração ou ambiente. No momento da inicialização, chame o endpoint de descriptografia para recuperar os valores de texto simples. Isso mantém os segredos seguros sem um cofre dedicado.

Descriptografar cargas recebidas de outros serviços

Quando seu serviço receber uma carga criptografada de um microsserviço upstream (criptografado por meio do endpoint criptografado), descriptografe-o aqui antes do processamento. Garante que dados confidenciais permaneçam criptografados durante a transmissão.

Crie um recurso de "revelar segredo" em seu aplicativo

Permita que os usuários armazenem notas ou senhas criptografadas. Quando eles clicarem em “revelar”, chame o endpoint de descriptografia com sua senha mestra. O texto simples é mostrado uma vez e nunca persiste em seus servidores.

Frequently asked questions

Meus dados são armazenados ou registrados durante a descriptografia?
Não. O texto cifrado, a senha e o texto simples recuperado são mantidos na memória somente durante a solicitação e descartados imediatamente após a resposta.
O que acontece se eu fornecer a senha errada?
AES-256-GCM é criptografia autenticada. Se a senha estiver errada, a verificação da etiqueta de autenticação falhará e a API retornará um erro. Ele não retornará texto simples ilegível.
Posso descriptografar dados criptografados fora desta API?
O endpoint espera o formato específico produzido pelo endpoint /v1/encrypt/encrypt (inclui IV, salt e texto cifrado em uma string estruturada). Se você corresponder a esse formato e aos parâmetros PBKDF2, o texto cifrado externo funcionará.
Existe um limite de tamanho para a string criptografada?
O limite do corpo da solicitação é de 1 MB. Para a maioria dos casos de uso de criptografia de texto (valores de configuração, tokens, mensagens curtas), isso é mais que suficiente.
Posso descriptografar o mesmo texto cifrado várias vezes?
Sim. Contanto que você forneça a senha correta, o mesmo texto cifrado será sempre descriptografado para o mesmo texto simples. O texto cifrado não é consumido ou invalidado pela descriptografia.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs