ETHRAEON Governance API

RESTful API for accessibility scanning, design verification, and compliance tracking.

Authentication

All API requests require authentication using Bearer tokens.

Authorization: Bearer {your_api_token}

Contact hello@ethraeon.systems to request API access.

POST /api/scan

Accessibility Scanner

Scan a URL for accessibility compliance issues.

Request Body

Parameter Type Required Description
url string Yes The URL to scan
standard string No WCAG standard (default: "WCAG 2.1 AA")
includeWarnings boolean No Include warnings (default: true)

Example Request

POST https://kasper.ethraeon.ai/api/scan Authorization: Bearer {token} Content-Type: application/json { "url": "https://accessiway.com/products", "standard": "WCAG 2.1 AA", "includeWarnings": true }

Example Response

{ "score": 96, "issues": [ { "severity": "medium", "type": "color-contrast", "element": "button.cta-secondary", "recommendation": "Increase contrast ratio from 4.2:1 to 4.5:1", "location": "line 342" } ], "compliance": "pass", "scanTime": "2.3s", "timestamp": "2026-01-15T10:30:00Z" }

Try It

POST /api/verify-design

Design Verification

Verify that a page adheres to design system boundaries.

Request Body

Parameter Type Required Description
pageId string Yes Unique page identifier
snapshot string Yes Base64 encoded screenshot or DOM snapshot

Example Response

{ "violations": 2, "issues": [ { "severity": "high", "type": "typography", "element": "h2.section-title", "violation": "Font size 22px not in allowed scale [24, 32, 48]", "recommendation": "Change to 24px" }, { "severity": "medium", "type": "spacing", "element": "section.hero", "violation": "Margin 20px not on 8px grid", "recommendation": "Change to 16px or 24px" } ], "approved": false }
GET /api/components

Component Library

Retrieve all available components from the library.

Example Response

{ "components": [ { "id": "hero-section-01", "name": "Hero Section - Standard", "category": "sections", "usage": 127, "lastModified": "2026-01-10", "accessible": true }, { "id": "cta-button-primary", "name": "CTA Button - Primary", "category": "buttons", "usage": 342, "lastModified": "2026-01-08", "accessible": true } ], "total": 47 }

Rate Limits

API rate limits are enforced per API key:

  • Standard: 100 requests per minute
  • Enterprise: 1000 requests per minute

Rate limit headers are included in all responses:

X-RateLimit-Limit: 100 X-RateLimit-Remaining: 87 X-RateLimit-Reset: 1609459200

Error Codes

Code Status Description
400 Bad Request Invalid request parameters
401 Unauthorized Missing or invalid API key
429 Too Many Requests Rate limit exceeded
500 Internal Server Error Server error occurred

Need Help?

Questions about the API? Contact us:

📧 hello@ethraeon.systems
📱 +39 375 667 4701 (Italy)
🌐 ethraeon.systems