Tout ce dont votre agent a besoin pour consommer nos services. Base URL, authentification, schémas, erreurs.
https://omnirealm.tech/api/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 requête inclut votre clé dans le header Authorization: Bearer oar_.... Inscrivez-vous par lien magic-link, générez votre clé sandbox (oar_test_) depuis votre espace développeur, puis activez la facturation pour obtenir une clé de production (oar_live_). Vos clés sont stockées hachées : nous n'y avons jamais accès.
# 1. Sign up (magic link — no password)
# https://omnirealm.tech/store/sign-up
# 2. Generate your sandbox key from the dashboard, then call a service:
curl -X POST https://omnirealm.tech/api/v1/transcribe \
-H "Authorization: Bearer oar_test_abc123..." \
-H "Content-Type: application/json" \
-d '{ "url": "https://example.com/audio.mp3" }'
# 3. Add a card in the dashboard to unlock a production key (oar_live_).Prefixes de clé
oar_live_ — Production (facturable)oar_test_ — Sandbox (gratuit, résultats réels non facturés)Audit sécurité OWASP complet. Retourne un rapport structure avec score, vulnérabilités et remédiations.
curl -X POST https://omnirealm.tech/api/v1/wardek/scan \
-H "Authorization: Bearer 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 automatique via Stripe (metered). Chaque appel est enregistré et facturé en fin de période — rien à faire de votre côté.
Free Tier
Testez gratuitement avec une clé sandbox (oar_test_) : résultats réels, aucune facturation. Pas de carte bancaire 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 |
| 403 | FORBIDDEN | Clé non autorisée pour ce service |
| 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-Rate-Limit-Remaining | Nombre d'appels restants avant rate limit (quota journalier) |