API
Base-adresse: https://senaste.ai/api/v1. Alle stier nedenfor følger den. Send headeren Authorization: Bearer uxp_.... Opret en nøgle i din konto. Grænsen er 60 requests i minuttet; hvert svar har X-RateLimit-Limit, X-RateLimit-Remaining og X-RateLimit-Reset (sekunder til næste minut), og et 429-svar har Retry-After.
Hele API'et med strukturen for hvert svar, som OpenAPI 3.1 til kode-generators og Postman: https://senaste.ai/api/v1/openapi.json
Fra et nyt site til en rapport
KEY=uxp_...
# 1. tilføj site; svaret har dens id og "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. placer et bevis på site (DNS TXT, filen eller meta-tagget), og så
curl -X POST https://senaste.ai/api/v1/sites/SITE_ID/verify -H "Authorization: Bearer $KEY"
# 3. prisfastsæt kørslen uden at starte den, og start den derefter
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. følg den, eller vent på callback
curl https://senaste.ai/api/v1/runs/RUN_ID -H "Authorization: Bearer $KEY"
Udelad personas fra en kørsel for at sende alle aktiverede på panelet. Et svar på 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":"..."}
Under kørslen har 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"}]}Når et kørsel slutter: callback_url
En kør startet med callback_url (https, en offentlig adresse) følges af et POST til den, når den slutter: done, failed, cancelled eller interrupted. Body er {"event":"run.finished","run":{...}} med status, score og tællinger; resultaterne hentes fra GET /runs/{id}. Headers: X-Senaste-Event, X-Senaste-Timestamp (Unix-sekunder) og X-Senaste-Signature: sha256=…, HMAC-SHA256 af timestamp + "." + body med nøglen callback_secret, som kun svaret til POST /runs viser. Svar med 2xx; ellers prøves det igen efter 10 og 60 sekunder. Redirects følges ikke.
// 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']));Metoder
| Metode | Sti | Hvad det gør |
|---|---|---|
| GET | /balance | Kreditbalance |
| GET | /sites | Dine sider, deres ids og paneler |
| POST | /sites | Tilføj et site: url, task (op til 500 tegn), personas (biblioteksnøgler fra GET /personas) og/eller generate (hvor mange modellen skriver fra startsiden, op til et minut), report_lang, audience. Svaret indeholder verification: DNS-posten, filen og meta-tagget; enhver af dem beviser domænet. |
| GET | /sites/{id} | Et site med sin panel og, indtil det er verificeret, verification |
| POST | /sites/{id}/verify | Søg efter beviset nu. 200 med siden, når den er fundet (og referral, når dette har udbetalt eller ikke har udbetalt en invitationsbonus), 422 not_verified, når det endnu ikke er tilfældet. |
| GET | /personas | Persona-biblioteket |
| GET | /runs | Dine kørsler, nyeste først, side for side: ?limit= 1 til 100 (50 som standard). Når next ikke er null, bedes du bruge ?before= med den værdi for at hente næste side. |
| POST | /runs | Start en kørsel: steps 3 til 30, concurrency 1 til 4. Svaret har warnings: forms når en opgave beder om at sende en formular, købe eller tilmelde sig ( testen holder formularer tilbage), offsite når den nævner et andet domæne. "dry_run":true kører alle tjek og svarer 200 med credits, balance og would_start, uden at starte noget. Headeren Idempotency-Key gør et forsøg sikkert: det samme nøgle inden for 24 timer returnerer den kørsel, den startede (200, Idempotent-Replayed: true). callback_url er beskrevet ovenfor. |
| GET | /runs/{id} | Status og resultater for hver persona. summary angiver, hvor mange personas der besøgte siden, og hvor mange gange selve testen fejlede; et sådant resultat har failure med trin, skridt og adresse.
Hvert resultat har steps (det brugte element og effect, hvad browseren gjorde) og goal_check: delene af opgaven og, om skærmene viser hver enkelt. En persona, der siger, at den har nået målet, mens dens skærme kun viser en del af opgaven, har udfaldet partly_reached. groups samler noter fra flere personas om ét problem; en notats id er persona:index. http lister HTTP-fejl med resourcetype, om det var en sideindlæsning, siden og trinnet. En kørende kørsel har queue (plads, kørsler foran din og andre konti, sekunder til start og til klarhed); en igangværende har progress; en færdig har waited_s og ran_s. Et trin, der har tastet, har value, hvad feltet indeholdte bagefter. notes_dropped angiver de noter, tjekket udelod, med årsag. En serverfejl i http har også at (UTC), url, retry (én anmodning mere 2 s senere), hindered og responsheaderne, som en sideejer kan finde den ved i deres logs. |
| POST | /runs/{id}/cancel | Annuller, ubrugte credits returneres |
Fejl
Format: {"error":{"code":"...","message":"..."}}. En værdi uden for området angiver også feltet og dets grænser: {"error":{"code":"invalid_steps","message":"...","field":"steps","min":3,"max":30,"got":40}}
| HTTP | Kode | Betydning |
|---|---|---|
| 400 | invalid_steps, invalid_concurrency | Trin eller parallelitet uden for området; intet blev startet, og der blev ikke brugt kredit |
| 400 | invalid_limit, invalid_cursor | En side fra kørselslisten blev anmodet med en forkert grænse eller før |
| 400 | no_personas | Ingen persona valgt, eller et id findes ikke på dette site |
| 400 | invalid_url, invalid_task, unknown_persona, invalid_generate, invalid_report_lang, domain_unreachable | Et nyt site med et forkert felt; intet blev tilføjet |
| 400 | invalid_dry_run, invalid_idempotency_key, invalid_callback_url | En forkert dry_run, Idempotency-Key eller callback_url; intet blev startet |
| 400 | not_test_host | Testbetalingsmodus kræver en startside på en testvært |
| 401 | unauthorized | Manglende eller ugyldig nøgle |
| 402 | insufficient_credits | Ikke nok credits |
| 403 | domain_not_verified | Domæne ikke verificeret |
| 404 | not_found | Intet af den slags på din konto |
| 409 | too_many_runs | For mange kørsler i køen |
| 409 | site_exists, too_many_sites | Domænet er allerede på din konto, eller kontoen har 20 sites |
| 422 | not_verified | Ingen bevis for domænet fundet endnu |
| 502 | generation_failed | Modellen kunne ikke skrive personas; prøv igen eller vælg fra biblioteket |
| 429 | rate_limited | Forespørgselsgrænsen overskredet |
Hvad en kørsel gør ved dit site
Kun GET-anmodninger til det verificerede domæne. Formularer sendes ikke, og feltene til adgangskode og kort forbliver tomme, så en kørsel hverken registrerer sig, logger ind eller betaler. Undtagelsen er testbetalingsfunktionen, som du aktiverer til en testvært. Noterne kommer fra en model; tjek dem, før du handler.