Tout ce dont votre agent a besoin pour consommer nos services. Base URL, authentification, schémas, erreurs.
https://api.omnirealm.tech/v1Le point d'entree de l'economie agent. Votre agent lit ce fichier pour découvrir tous les services disponibles, leurs prix, et leurs schémas d'entree/sortie.
curl https://omnirealm.tech/.well-known/agent-services.jsonCe fichier est mis a jour automatiquement quand de nouveaux services sont ajoutes. Votre agent peut le consulter periodiquement pour détectér les nouveaux services.
Chaque requete doit inclure une API key dans le header X-Agent-Key. Obtenez votre clé en 30 secondes.
curl -X POST https://omnirealm.tech/api/v1/auth/register \
-H "Content-Type: application/json" \
-d '{
"agent_name": "my-devops-agent",
"owner_email": "dev@example.com"
}'
# Response:
# {
# "api_key": "oar_live_abc123...",
# "agent_id": "agt_xyz789"
# }Prefixes de clé
oar_live_ — Production (facturable)oar_test_ — Sandbox (gratuit, données fictives)Audit sécurité OWASP complet. Retourne un rapport structure avec score, vulnérabilités et remédiations.
curl -X POST https://api.omnirealm.tech/v1/wardek/scan \
-H "X-Agent-Key: oar_live_abc123..." \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com",
"depth": "standard"
}'
# Response:
# {
# "scan_id": "wdk_abc123",
# "status": "warn",
# "score": 72,
# "vulnerabilities": [
# {
# "severity": "medium",
# "category": "misconfig",
# "title": "Missing Content-Security-Policy header",
# "remediation": "Add CSP header with appropriate directives"
# }
# ],
# "scan_duration_ms": 8500,
# "scanned_at": "2026-04-03T12:00:00Z"
# }| Param | Type | Required | Description |
|---|---|---|---|
| url | string | URL du site a scanner | |
| depth | enum | — | quick | standard | deep (defaut: standard) |
Facturation Stripe metered. Chaque appel est enregistre et facture en fin de mois.
Free Tier
10 appels gratuits par mois par service. Aucune carte bancaire requise pour commencer.
Facturation mensuelle
Au-delà du free tier, chaque appel est facture au centime pres. Facture mensuelle via Stripe.
Format unifie pour toutes les erreurs. Chaque réponse d'erreur inclut un code machine-readable et un message humain.
| HTTP | Code | Description |
|---|---|---|
| 400 | INVALID_INPUT | Schema de validation echoue |
| 401 | UNAUTHORIZED | API key manquante ou invalide |
| 402 | PAYMENT_REQUIRED | Free tier epuise, paiement non configure |
| 429 | RATE_LIMITED | Rate limit atteint (header Retry-After inclus) |
| 500 | INTERNAL_ERROR | Erreur serveur (retry safe) |
{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit exceeded. Try again in 45 seconds.",
"retry_after_ms": 45000
}
}Chaque réponse inclut des headers utiles pour le monitoring et le billing.
| Header | Description |
|---|---|
| X-Request-Id | ID unique de la requete pour tracabilite |
| X-Cost | Coût de cet appel en EUR |
| X-Free-Tier-Remaining | Nombre d'appels gratuits restants ce mois |
| X-Rate-Limit-Remaining | Nombre d'appels restants avant rate limit |