Quickstart: SSL Certificate API

SSL certificate management, monitoring, and automated renewal for coding agents. Get running in 60 seconds.

Claude Code Cursor Cline Windsurf Aider
1

Get your API key

Add to your project's .env file:

export SSLWEBSITES_BASE_URL=https://sslwebsites.com
export SSLWEBSITES_API_KEY=ssl_free_your_key_here

No key yet? Sign up free via API ($1 one-time activation required). Your human gets an email with the payment link:

curl -X POST https://sslwebsites.com/api/signup \
  -H "Content-Type: application/json" \
  -d '{
    "tenantId": "my-project",
    "name": "My Project",
    "email": "you@example.com"
  }'

# Response: {"apiKey":"ssl_free_...","tenantId":"my-project","plan":"free"}
2

Create your first certificate

curl -X POST ${SSLWEBSITES_BASE_URL}/api/v1/certificates \
  -H "Authorization: Bearer ${SSLWEBSITES_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "domains": ["example.com"],
    "validationType": "http",
    "autoRenew": true
  }'

# Response: {"id":"cert_abc123","status":"pending","domains":["example.com"]}
3

Check certificate status

curl ${SSLWEBSITES_BASE_URL}/api/v1/certificates/cert_abc123 \
  -H "Authorization: Bearer ${SSLWEBSITES_API_KEY}"

# Response: {"id":"cert_abc123","status":"active","domains":["example.com"],
#   "expiresAt":"2026-08-11T00:00:00Z","autoRenew":true}

Renew a certificate

curl -X POST ${SSLWEBSITES_BASE_URL}/api/v1/certificates/cert_abc123/renew \
  -H "Authorization: Bearer ${SSLWEBSITES_API_KEY}"

# Response: {"id":"cert_abc123","status":"pending","message":"Renewal initiated"}

Download certificate bundle

curl ${SSLWEBSITES_BASE_URL}/api/v1/certificates/cert_abc123/download \
  -H "Authorization: Bearer ${SSLWEBSITES_API_KEY}" \
  -o certificate-bundle.zip

# ZIP contains: certificate.crt, private.key, ca_bundle.crt

Revoke a certificate

curl -X POST ${SSLWEBSITES_BASE_URL}/api/v1/certificates/cert_abc123/revoke \
  -H "Authorization: Bearer ${SSLWEBSITES_API_KEY}"

# Response: {"id":"cert_abc123","status":"revoked"}
# WARNING: Revocation is irreversible