Aider

SSLWebsites + Aider

Issue, renew, and manage SSL certificates without leaving your editor.

Claude Code Cursor Cline Windsurf Aider

Quick Reference

1 Get your API key

Sign up to receive an API key. A one-time $1 payment activates the key (anti-spam gate).

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

Response includes apiKey, tenantId, and plan limits.

2 Add to CONVENTIONS.md

Drop this skill snippet into your project's CONVENTIONS.md file so Aider knows the full SSLWebsites API.

# SSLWebsites Integration

This project uses SSLWebsites.com for SSL certificate management.
API base: ${SSLWEBSITES_BASE_URL}. Auth: Bearer ${SSLWEBSITES_API_KEY}.
EVERY request MUST include: -H "Authorization: Bearer ${SSLWEBSITES_API_KEY}" -H "Content-Type: application/json"

## Get your API key
POST /api/signup with: { tenantId (optional), name, email (optional) }
Returns: apiKey (ssl_free_...), tenantId, plan limits
Note: $1 payment required to activate key (anti-spam gate)

## Certificate lifecycle
POST /api/v1/certificates — Create cert { domains: ["example.com"], validationType: "http"|"dns"|"email", autoRenew: true }
GET /api/v1/certificates — List certs (?status=active|pending|expired&domain=example.com)
GET /api/v1/certificates/:id — Full cert detail (status, expiry, domains, validation info)
POST /api/v1/certificates/:id/renew — Renew before expiry
POST /api/v1/certificates/:id/revoke — Revoke (irreversible)
DELETE /api/v1/certificates/:id — Delete cert record
GET /api/v1/certificates/:id/download — Download ZIP (certificate.crt, private.key, ca_bundle.crt)
GET /api/v1/certificates/:id/install-guide/:serverType — Install guide (apache|nginx|iis|cpanel|plesk|tomcat|aws|cloudflare|heroku)

## Validation
- HTTP-01: Place challenge file, auto-verified
- DNS-01: Add TXT record (required for wildcards)
- Email: Verification sent to domain admin
- CNAME: Add CNAME record

## Certificate types
- Single domain: example.com (all plans)
- Wildcard: *.example.com (Premium+ plans, DNS validation only)
- Multi-domain SAN: up to 100 domains per cert (Basic+ plans)
- 90-day validity (all plans)
- 1-year validity (Basic+ plans)

## Plans
Free: 3 certs (90-day), ACME only, $1 activation
Basic ($12.99/mo): Unlimited 90-day, 3x 1-year, REST API, monitoring
Premium ($69.99/mo): + wildcards, 10x 1-year, technical support
Business ($139.99/mo): + 25x 1-year, 3x wildcard, preferred support
Platinum ($219.99/mo): Unlimited everything, 100 SANs/cert, priority support

## Key patterns
- Certificate status: pending → validating → active → expired (or revoked)
- Auto-renewal: enabled on paid plans, runs before expiry
- Download bundle: ZIP with .crt, .key, .ca-bundle files
- Install guides: copy-paste config for 9 server types
- ACME: /acme endpoint, compatible with Certbot

3 Create a certificate

Request a new SSL certificate for your domain.

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

4 Check certificate status

Poll until the status moves from pendingvalidatingactive.

curl https://sslwebsites.com/api/v1/certificates/CERT_ID \
  -H "Authorization: Bearer ssl_free_YOUR_KEY"

5 Download the bundle

Once active, download the ZIP containing certificate.crt, private.key, and ca_bundle.crt.

curl -o cert-bundle.zip \
  https://sslwebsites.com/api/v1/certificates/CERT_ID/download \
  -H "Authorization: Bearer ssl_free_YOUR_KEY"

Plan Limits

PlanPrice90-day Certs1-year CertsWildcardsSANs/cert
Free$1 activation31
Basic$12.99/moUnlimited310
Premium$69.99/moUnlimited10Yes25
Business$139.99/moUnlimited25350
Platinum$219.99/moUnlimitedUnlimitedUnlimited100
Full API Docs All Quickstarts GitHub SSLWebsites Home