POST AI agent ready /v1/encrypt/decrypt

AES-256 復号化 API - フリーテキスト復号化

暗号化エンドポイントによって生成された暗号化文字列を元のパスワードとともに送信して、平文を復元します。復号化はサーバー側のメモリ内で行われます。暗号文も復元された平文も保存または記録されません。

Endpoint

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

アプリケーション起動時に設定値を復号化する

暗号化されたデータベース認証情報と API キーを構成ファイルまたは環境に保存します。起動時に、復号エンドポイントを呼び出して平文値を回復します。これにより、専用の保管庫がなくても秘密が安全に保管されます。

他のサービスから受信したペイロードを復号化する

サービスが上流のマイクロサービスから暗号化されたペイロード (暗号化エンドポイント経由で暗号化されたもの) を受信した場合、処理する前にここで復号化します。機密データがネットワーク上で暗号化された状態に保たれるようにします。

アプリに「シークレットを公開」機能を構築する

ユーザーが暗号化されたメモやパスワードを保存できるようにします。「公開」をクリックすると、マスターパスワードを使用して復号化エンドポイントを呼び出します。プレーンテキストは一度表示されるだけで、サーバー上に永続化されることはありません。

Frequently asked questions

復号化中にデータは保存または記録されますか?

いいえ。暗号文、パスワード、および復元された平文は、要求中のみメモリに保持され、応答直後に破棄されます。

間違ったパスワードを入力するとどうなりますか?

AES-256-GCM は認証された暗号化です。パスワードが間違っている場合、認証タグの検証は失敗し、API はエラーを返します。文字化けした平文は返されません。

この API の外部で暗号化されたデータを復号化できますか?

エンドポイントは、/v1/encrypt/encrypt エンドポイントによって生成される特定の形式 (IV、ソルト、および構造化文字列の暗号文を含む) を期待します。その形式と PBKDF2 パラメーターが一致すると、外部暗号文が機能します。

暗号化された文字列にサイズ制限はありますか?

リクエスト本文の制限は 1 MB です。ほとんどのテキスト暗号化の使用例 (構成値、トークン、ショートメッセージ) では、これで十分です。

同じ暗号文を複数回復号化できますか?

はい。正しいパスワードを入力する限り、毎回同じ暗号文が同じ平文に復号化されます。暗号文は復号化によって消費されたり無効になったりすることはありません。

Get your API key

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