AI Cyber Shield — Developers & API

What machines can use today: a public security-score badge, a CI/CD security gate returning a synchronous PASS/FAIL verdict with SARIF output, and an AI-agent-readable surface. All URLs are stable and on the primary domain.

Security-score badge (public, no auth)

A dynamic SVG showing a scanned domain's latest security grade — embeddable in a README or any page:

![Security](https://www.ai-cyber-shield.com/api/proxy/api/v1/badge/yourdomain.com)

CI/CD security gate (API key required)

One synchronous call runs a scan and returns a policy verdict — fail the pipeline if the grade drops or a critical finding appears. Works from GitHub Actions, GitLab CI, or Jenkins. Passive / fast / standard scans only (no PT):

curl -X POST https://www.ai-cyber-shield.com/api/proxy/api/v1/ci/scan \
  -H "X-API-Key: $CYBERSHIELD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://staging.example.com", "mode": "fast",
       "policy": {"min_grade": "C", "max_severity": "CRITICAL"}}'

# → {"passed": true|false, "grade": "A".."F", "score": 0-100,
#    "counts_by_severity": {...}, "violations": [...],
#    "sarif_url": "...", "report_url": "..."}

API keys are issued on request (there is no self-serve key dashboard yet): email contact@ai-cyber-shield.com with the subject "API Access", your domain, and a line about your pipeline. The same authorization rule as every scan applies — scan only domains you own or are authorized to test.

For AI agents

This site is machine-readable: an llms.txt with when-to-use guidance, plus a markdown variant of every public page — via Accept: text/markdown or a .md suffix:

curl https://www.ai-cyber-shield.com/llms.txt
curl -H "Accept: text/markdown" https://www.ai-cyber-shield.com/how-it-works
curl https://www.ai-cyber-shield.com/developers.md

Liveness

curl https://www.ai-cyber-shield.com/api/proxy/health
# → {"status": "ok", "version": "...", "build": "..."}

Interactive OpenAPI docs are deliberately not exposed in production (attack-surface minimization). Everything public is documented on this page.