ZenithConvert REST API
Convert code and data formats programmatically. API access is included with PRO and Enterprise plans (750 conversions/month, up to 20 keys, 25k input chars).
Base URL: https://converter-backend-abqt.onrender.com — hosted on Render; first request after idle may take ~30s (cold start).
Quickstart
- Upgrade to PRO — free accounts can use the web app only.
- Create an API key on API keys. Copy
zc_live_…immediately. - Call
POST /api/v1/convertwith headerX-API-Key.
GitHub Actions (CI)
Use the official example workflow in .github/workflows/zenithconvert-ci-example.yml in our repository. Add ZENITH_API_KEY as a repository secret (PRO required).
Authentication
Send X-API-Key: zc_live_… on every authenticated request. Revoke compromised keys from your dashboard.
Convert
POST/api/v1/convert
curl -X POST https://converter-backend-abqt.onrender.com/api/v1/convert \
-H "X-API-Key: zc_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{"from":"JSON","to":"XML","input":"{\"name\":\"Ada\"}"}'Discovery endpoints
- GET
/api/v1/formats— all format identifiers (public). - GET
/api/v1/pairs— active conversion pairs + required tier (public).
CI example (GitHub Actions)
name: Convert with ZenithConvert
on: [workflow_dispatch]
jobs:
convert:
runs-on: ubuntu-latest
steps:
- name: JSON to XML
env:
ZENITH_API_KEY: ${{ secrets.ZENITH_API_KEY }}
run: |
curl -sS -X POST https://converter-backend-abqt.onrender.com/api/v1/convert \
-H "X-API-Key: $ZENITH_API_KEY" \
-H "Content-Type: application/json" \
-d '{"from":"JSON","to":"XML","input":"{\"ok\":true}"}'Errors
| Code | Meaning |
|---|---|
401 | Missing or invalid API key. |
403 | Plan gate — REST API requires PRO or Enterprise. Upgrade at /pricing. |
400 | Unknown format, invalid pair, or missing field. |
429 | Monthly conversion quota exceeded for your plan. |
Identical inputs may be served from cache and do not count against quota.