API Usage Examples

v0.81.2

Practical curl examples for common operations.

Base URL: https://your-server/api/v1

All requests require Authorization: Bearer <token>.

Obtain JWT Token

curl -X POST https://your-server/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username":"admin","password":"..."}'

List Systems

curl -H "Authorization: Bearer $TOKEN" \
     https://your-server/api/v1/systems

Trigger On-Demand Audit

curl -X POST -H "Authorization: Bearer $TOKEN" \
     -d '{"system_id":"sys_abc123"}' \
     https://your-server/api/v1/audits/run

Create Enrollment Token

curl -X POST -H "Authorization: Bearer $TOKEN" \
     -d '{"name":"Production","expires_days":30}' \
     https://your-server/api/v1/enrollment-tokens

Export PDF Report

curl -H "Authorization: Bearer $TOKEN" -o report.pdf \
     https://your-server/api/v1/reports/audit/audit_123?format=pdf

Full OpenAPI spec

https://your-server/docs (Swagger UI)