FeaturePOST /v1/jobs

Website Monitoring

Geplante Checks mit Jobs und signierten Webhooks. Assert, Screenshot oder Facts — automatisch und pipeline-ready.

Was du mit Monitoring-Jobs machen kannst

Batch- oder geplante Checks als Job: Scout führt Requests aus und liefert Ergebnisse per Poll oder signiertem Webhook. Die Live-Demo unten zeigt den typischen Smoke-Check (Assert) — Jobs orchestrieren dieselben Primitives.

Mehrere Requests in einem Job (Screenshot, Inspect, Assert, …)
Optional signierte Webhooks an dein System
Ergebnisse pollen via GET /v1/jobs/:id
Als Grundlage für Alerts, Tickets und Auto-Remediation

API Call

editable

Request body

{'{'}

{'}'}

Smoke-Check wie in Monitoring-Jobs: Selector und visible ändern, dann ausführen.

Response

Noch nicht ausgeführt

Assert: h1 visible=true auf example.com

Endpoints & Parameter

Endpoint wählen — darunter siehst du eine beispielhafte Anfrage und die Erklärung aller relevanten Parameter.

POST /v1/jobs

Enqueue Batch-Job; Credits = Summe der nested Requests.

Beispiel-Anfrage

json

{
  "webhook_url": "https://hooks.example.com/scout",
  "webhook_secret": "whsec_example",
  "requests": [
    {
      "type": "assert",
      "body": {
        "url": "https://example.com",
        "assert": [
          {
            "selector": "h1",
            "visible": true
          }
        ]
      }
    },
    {
      "type": "screenshot",
      "body": {
        "url": "https://example.com",
        "format": "jpeg",
        "mode": "viewport"
      }
    }
  ]
}

Parameter

requestsarray required
Liste von { type, body } — type mappt auf Scout-Primitives (assert, screenshot, inspect, …).
webhook_urlstring
Callback-URL für Job-Ergebnis.
webhook_secretstring
HMAC-Secret; sonst Key-/Env-Default.