ToolsXpo
ToolsXpo

Security

AES Encryption API

GET request to /v1/aes-encryption, returning text in the standard envelope.

GET/v1/aes-encryption2 credits / call Free tier

Authentication

Send your API key as a bearer token. Create one free in the dashboard.

Authorization: Bearer $TOOLSXPO_KEY

Parameters

Sent as query-string parameters (or a JSON body with POST). Fields marked required must be present; everything else has a sensible default.

NameTypeDefaultDescription
textrequiredstring—Text to encrypt, or ciphertext to decrypt.
keyrequiredstring1–…—Passphrase / key.
modestringencryptWhether to encrypt the input or decrypt it.One of: encrypt, decrypt
outputFormatstringBase64Encoding of the encrypted output. Decryption expects the same encoding.One of: Base64, Hex

Example request

curl "https://api.toolsxpo.com/v1/aes-encryption?text=hello&key=my-secret&mode=encrypt&outputFormat=Base64" \
  -H "Authorization: Bearer $TOOLSXPO_KEY"

Response

Every endpoint answers with the same envelope: the result in data, what the call cost and your standing in meta.

{
  "ok": true,
  "data": { /* text */ },
  "meta": { "credits": 2 }
}

meta fields (every tool)

FieldTypeDescription
meta.toolstringThe tool id that ran.
meta.authstringHow the call authenticated — `key` for an API key.
meta.creditsnumberEverything this call cost, in credits (both currencies together).
meta.baseCreditsnumberThe tool's own price — the compute-credit part of `credits`.
meta.aiCreditsnumberAI credits spent on a model step. Present only when non-zero.
meta.billedFromstringWhich balance paid: the plan allowance or the purchased credit balance.
meta.pricing.mode"flat" | "metered"Flat price per call, or metered by usage.
meta.pricing.meterUnitstringMetered tools: what is counted (e.g. `megapixel`).
meta.pricing.creditsPerUnitnumberMetered tools: credits per unit counted.
meta.quota.limitnumberYour plan's allowance for the current period.
meta.quota.usednumberAllowance used so far this period.
meta.quota.remainingnumberAllowance left this period.
meta.quota.resetsAtstring (ISO 8601)When the allowance resets.
meta.quota.creditBalancenumberPurchased credits remaining, used after the allowance.
meta.quota.scopestringWhat the quota belongs to — `account` (your workspace) for API keys.
meta.quota.planstringYour plan id.

Errors

Failures use the same envelope with ok: false and a machine-readable code.

StatusCodeMeaning
400invalid_inputA parameter failed validation. `details` lists which.
401unauthorizedMissing or invalid API key.
402quota_exceededOut of credits on this workspace.
404not_foundNo such tool.
429rate_limitedToo many requests. Retry after `Retry-After` seconds.
503service_unavailableTemporarily disabled by an administrator.