PRO only

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

  1. Upgrade to PRO — free accounts can use the web app only.
  2. Create an API key on API keys. Copy zc_live_… immediately.
  3. CallPOST /api/v1/convert with header X-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

CodeMeaning
401Missing or invalid API key.
403Plan gate — REST API requires PRO or Enterprise. Upgrade at /pricing.
400Unknown format, invalid pair, or missing field.
429Monthly conversion quota exceeded for your plan.

Identical inputs may be served from cache and do not count against quota.