REST API Integration Guide

Rate Limit: Public API requests are strictly limited to 10 requests per minute per IP address. For unlimited use, use the web interface.

1. Process Text (/api/process_text)

Encrypt or decrypt text payloads using HASHI or VHE.

cURL (HASHI)
curl -X POST https://ilenc.vercel.app/api/process_text \ -F "engine=hashi" \ -F "key=YOUR_PASSPHRASE" \ -F "dna=ATCG...TAA" \ -F "action=enc" \ -F "encoding=raw" \ -F "text=Hello World"
cURL (VHE Asymmetric)
curl -X POST https://ilenc.vercel.app/api/process_text \ -F "engine=vhe" \ -F "peer_pub=HEX_PUBLIC_KEY" \ -F "action=enc" \ -F "encoding=hex" \ -F "text=Hello World"

2. Process Files (/api/process_files)

Encrypt or decrypt multiple files (Max 10 files, 1MB each).

Python (Requests) - VHE Decrypt
import requests url = "https://ilenc.vercel.app/api/process_files" data = { "engine": "vhe", "my_priv": "YOUR_HEX_PRIVATE_KEY", "action": "dec" } files = [('files', ('secret.vhe', open('secret.vhe', 'rb'), 'application/octet-stream'))] response = requests.post(url, data=data, files=files) print(response.json())

3. VHE KEM (/api/vhe/kem)

Compute HASHI credentials securely using VHE Key Exchange Mechanism.

curl -X POST https://ilenc.vercel.app/api/vhe/kem \ -F "my_priv=YOUR_HEX_PRIVATE_KEY" \ -F "peer_pub=THEIR_HEX_PUBLIC_KEY"

Parameters

  • engine: hashi for symmetric, vhe for asymmetric.
  • key / dna: Required for HASHI engine.
  • peer_pub / my_priv: Required for VHE engine (depending on action).
  • action: enc for encryption, dec for decryption.
  • encoding: raw, hex, or b64.