API

Basisadresse: https://senaste.ai/api/v1. Alle Pfade unten werden an sie angehängt. Senden Sie den Header Authorization: Bearer uxp_.... Erstellen Sie einen Schlüssel in Ihrem Konto. Das Limit beträgt 60 Anfragen pro Minute; jede Antwort enthält X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset (Sekunden bis zur nächsten Minute), und bei einem 429-Fehler wird Retry-After zurückgegeben.

Die gesamte API mit der Struktur jeder Antwort, als OpenAPI 3.1 für Codegeneratoren und Postman: https://senaste.ai/api/v1/openapi.json

Von einer neuen Website bis zum Bericht

KEY=uxp_...
# 1. fügen Sie die Website hinzu; die Antwort enthält ihre ID und "verification"
curl -X POST https://senaste.ai/api/v1/sites -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/pricing","task":"Find the price of the Pro plan","personas":["impulse","price"],"generate":2}'
# 2. Legen Sie einen Nachweis auf der Website ab (DNS TXT, die Datei oder das Meta-Tag), dann
curl -X POST https://senaste.ai/api/v1/sites/SITE_ID/verify -H "Authorization: Bearer $KEY"
# 3. Schätzen Sie die Kosten des Testlaufs, ohne ihn zu starten, und starten Sie ihn dann
curl -X POST https://senaste.ai/api/v1/runs -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"site":"SITE_ID","steps":20,"dry_run":true}'
curl -X POST https://senaste.ai/api/v1/runs -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: deploy-1234" \
  -d '{"site":"SITE_ID","steps":20,"concurrency":3,"callback_url":"https://example.com/hooks/senaste"}'
# 4. verfolgen Sie ihn oder warten Sie auf den Callback
curl https://senaste.ai/api/v1/runs/RUN_ID -H "Authorization: Bearer $KEY"

Ohne personas in einem Testlauf starten alle im Panel aktivierten Personas. Eine Antwort auf POST /runs:

{"id":"rmhb2x1k4f9a0c3d1","site":"s1a2b3c4d5e6","domain":"example.com","status":"queued","personas":8,"steps":20,
 "credits":8,"refunded":0,"charged":8,"created":"2026-11-09T10:00:00.000Z","started":null,"finished":null,
 "queue":{"position":1,"ahead_yours":0,"ahead_others":0,"start_in_s":0,"done_in_s":190},
 "callback":{"url":"https://example.com/hooks/senaste","status":null},"warnings":[],"callback_secret":"..."}

Während des Laufs liefert GET /runs/{id} progress:

"progress":{"phase":"walking","percent":41,"personas_done":3,"personas_total":8,"steps_done":71,"steps_total":160,"eta_s":190,
 "personas":[{"persona":"p01","name":"Impulse buyer","step":20,"state":"done","outcome":"gave_up"},
             {"persona":"p02","name":"Price-first evaluator","step":7,"state":"walking"}]}

Wenn ein Testlauf endet: callback_url

Ein mit callback_url (https, eine öffentliche Adresse) gestarteter Testlauf sendet nach seinem Ende einen POST an diese Adresse: done, failed, cancelled oder interrupted. Der Body ist {"event":"run.finished","run":{...}} mit Status, Punktzahl und Zahlen; die Ergebnisse liefert GET /runs/{id}. Header: X-Senaste-Event, X-Senaste-Timestamp (Unix-Sekunden) und X-Senaste-Signature: sha256=…, das HMAC-SHA256 von timestamp + "." + body mit dem Schlüssel callback_secret, den nur die Antwort auf POST /runs zeigt. Antworten Sie mit 2xx; sonst wird es nach 10 und 60 Sekunden erneut versucht. Weiterleitungen werden nicht verfolgt.

// Node.js
const expected = 'sha256=' + crypto.createHmac('sha256', secret).update(req.headers['x-senaste-timestamp'] + '.' + rawBody).digest('hex');
const ok = crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(req.headers['x-senaste-signature']));

Methoden

MethodePfadWas es tut
GET/balanceCredit-Guthaben
GET/sitesIhre Websites, deren IDs und Panels
POST/sitesFügen Sie eine Website hinzu: url, task (bis zu 500 Zeichen), personas (Library-Schlüssel aus GET /personas) und/oder generate (wie viele die KI von der Startseite aus generiert, bis zu einer Minute), report_lang, audience. Die Antwort enthält verification: den DNS-Eintrag, die Datei und das Meta-Tag; einer davon reicht zum Nachweis der Domain.
GET/sites/{id}Eine Website mit ihrem Panel und, bis zur Verifizierung, verification
POST/sites/{id}/verifyJetzt nach dem Nachweis suchen. 200 mit der Website, wenn er gefunden ist (und referral, wenn dabei ein Einladungsbonus gutgeschrieben wurde oder nicht), 422 not_verified, wenn noch nicht.
GET/personasDie Persona-Bibliothek
GET/runsIhre Testläufe, neueste zuerst, seitenweise: ?limit= 1 bis 100 (Standard 50). Wenn next nicht null ist, fragen Sie ?before= damit für die nächste Seite ab.
POST/runsTestlauf starten: steps 3 bis 30, concurrency 1 bis 4. Die Antwort enthält warnings: forms, wenn eine Aufgabe zum Senden eines Formulars, Kauf oder zur Registrierung auffordert (der Test hält Formulare zurück), offsite, wenn eine andere Domain genannt wird. "dry_run":true führt alle Prüfungen durch und antwortet mit 200 und credits, balance sowie would_start, ohne etwas zu starten. Der Header Idempotency-Key macht einen Retry sicher: derselbe Schlüssel innerhalb von 24 Stunden liefert den gestarteten Testlauf zurück (200, Idempotent-Replayed: true). callback_url wurde oben beschrieben.
GET/runs/{id}Status und Ergebnisse pro Persona. summary gibt an, wie viele Personas die Website durchlaufen sind und wie viele der Test selbst fehlgeschlagen ist; ein solches Ergebnis hat failure mit Phase, Schritt und Adresse. Jedes Ergebnis enthält steps (das verwendete Element und effect, was der Browser tat) und goal_check: die Teile der Aufgabe und ob die Bildschirme jeden Teil zeigen. Eine Persona, die angibt, das Ziel erreicht zu haben, deren Bildschirme jedoch nur einen Teil der Aufgabe zeigen, hat das Ergebnis partly_reached. groups fasst Notizen mehrerer Personas zu einem Problem zusammen; eine Notiz-ID ist persona:index. http listet HTTP-Fehler mit dem Ressourcentyp, ob es eine Seitenladung war, die Seite und den Schritt auf. Ein in der Warteschlange befindlicher Testlauf hat queue (Platz, Testläufe vor Ihrem und anderen Konten, Sekunden bis zum Start und bis zur Bereitschaft); ein laufender Testlauf hat progress; ein abgeschlossener Testlauf hat waited_s und ran_s. Ein Schritt, der getippt hat, enthält value, also den Feldinhalt danach. notes_dropped listet Notizen auf, die die Prüfung ausgelassen hat, samt Begründung. Ein Serverfehler in http enthält zudem at (UTC), url, retry (eine weitere Anfrage 2 s später), hindered sowie die Antwort-Header, über die ein Website-Betreiber den Fehler in seinen Logs finden kann.
POST/runs/{id}/cancelAbbrechen, nicht verbrauchte Credits werden gutgeschrieben

Fehler

Format: {"error":{"code":"...","message":"..."}}. Ein Wert außerhalb des Bereichs nennt auch das Feld und seine Grenzen: {"error":{"code":"invalid_steps","message":"...","field":"steps","min":3,"max":30,"got":40}}

HTTPCodeBedeutung
400invalid_steps, invalid_concurrencySchritte oder Parallelität außerhalb des Bereichs; nichts wurde gestartet, kein Credit verbraucht
400invalid_limit, invalid_cursorEine Seite der Testlaufliste wurde mit einem falschen Limit oder vor dem erwarteten Punkt abgerufen
400no_personasKeine Persona ausgewählt oder eine ID ist auf dieser Website nicht vorhanden
400invalid_url, invalid_task, unknown_persona, invalid_generate, invalid_report_lang, domain_unreachableEine neue Website mit einem falschen Feld; es wurde nichts hinzugefügt
400invalid_dry_run, invalid_idempotency_key, invalid_callback_urlEin falscher dry_run, Idempotency-Key oder callback_url; es wurde nichts gestartet
400not_test_hostDer Testzahlungsmodus erfordert eine Startseite auf einem Test-Host
401unauthorizedFehlender oder ungültiger Schlüssel
402insufficient_creditsNicht genug Credits
403domain_not_verifiedDomain nicht verifiziert
404not_foundNichts davon auf Ihrem Konto
409too_many_runsZu viele Testläufe in der Warteschlange
409site_exists, too_many_sitesDie Domain ist bereits Ihrem Konto zugeordnet, oder das Konto enthält bereits 20 Websites
422not_verifiedNoch kein Domänennachweis gefunden
502generation_failedDas Modell konnte keine Personas erstellen; versuchen Sie es erneut oder wählen Sie aus der Bibliothek
429rate_limitedAnfrage-Limit überschritten

Was ein Testlauf auf Ihrer Website macht

Nur GET-Anfragen an die verifizierte Domain. Formulare werden nicht gesendet, Passwort- und Kartenfelder bleiben leer, daher registriert sich ein Testlauf nie, meldet sich nicht an oder zahlt. Die Ausnahme ist der Testzahlmodus, den Sie für einen Test-Host aktivieren. Notizen stammen von einem Modell, prüfen Sie sie, bevor Sie handeln.