API
Baseadresse: https://senaste.ai/api/v1. Alle stier nedenfor følger den. Send headeren Authorization: Bearer uxp_.... Opprett en nøkkel i kontoen din. Grensen er 60 forespørsler i minuttet; hver svarheader har X-RateLimit-Limit, X-RateLimit-Remaining og X-RateLimit-Reset (sekunder til neste minutt), og 429 har Retry-After.
Hele API-et med strukturen til hvert svar, som OpenAPI 3.1 for kodegenerering og Postman: https://senaste.ai/api/v1/openapi.json
Fra nytt nettsted til rapport
KEY=uxp_...
# 1. legg til nettstedet; svaret har sin 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. legg til ett bevis på nettstedet (DNS TXT, filen eller meta-taggen), og deretter
curl -X POST https://senaste.ai/api/v1/sites/SITE_ID/verify -H "Authorization: Bearer $KEY"
# 3. beregn prisen uten å starte den, og start deretter
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å callbacken
curl https://senaste.ai/api/v1/runs/RUN_ID -H "Authorization: Bearer $KEY"
La være med personas i et kjøring for å sende alle som er aktivert i 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":"..."}
Når den kjører, 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 en kjøring avsluttes: callback_url
En kjøring startet med callback_url (https, en offentlig adresse) følges opp med ett POST til den når den er ferdig: done, failed, cancelled eller interrupted. Kroppen er {"event":"run.finished","run":{...}} med status, poengsum og tellinger; resultatene hentes fra GET /runs/{id}. Headers: X-Senaste-Event, X-Senaste-Timestamp (Unix-sekunder) og X-Senaste-Signature: sha256=…, HMAC-SHA256 av timestamp + "." + body med nøkkel callback_secret, som kun vises i svaret på POST /runs. Svar med 2xx; ellers prøves det på nytt etter 10 og 60 sekunder. Omdirigeringer 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 | Hva det gjør |
|---|---|---|
| GET | /balance | Kredittbalanse |
| GET | /sites | Dine nettsteder, deres id-er og paneler |
| POST | /sites | Legg til et nettsted: url, task (opptil 500 tegn), personas (biblioteknøkler fra GET /personas) og/eller generate (hvor mange modellen skriver fra startsiden, opptil ett minutt), report_lang, audience. Svaret har verification: DNS-posten, filen og meta-taggen, hvorav hvilken som helst beviser domenet. |
| GET | /sites/{id} | Et enkelt nettsted med panelet sitt og, inntil det er verifisert, verification |
| POST | /sites/{id}/verify | Søk etter beviset nå. 200 med nettstedet når det er funnet (og referral når dette ga eller ikke ga en invitasjonsbonus), 422 not_verified når det ennå ikke er det. |
| GET | /personas | Personabiblioteket |
| GET | /runs | Kjøringene dine, nyeste først, side for side: ?limit= 1 til 100 (50 som standard). Når next ikke er null, bruk ?before= med den for å hente neste side. |
| POST | /runs | Start en kjøring: steps 3 til 30, concurrency 1 til 4. Svaret har warnings: forms når en oppgave ber om å sende inn en skjema, kjøpe eller registrere seg (testen holder tilbake skjemaer), offsite når det nevner et annet domene. "dry_run":true kjører alle sjekker og svarer med 200 og credits, balance og would_start, uten å starte noe. Headeren Idempotency-Key gjør et nytt forsøk trygt: samme nøkkel innen 24 timer returnerer kjøringen den startet (200, Idempotent-Replayed: true). callback_url er beskrevet ovenfor. |
| GET | /runs/{id} | Status og resultater per persona. summary viser hvor mange personas som besøkte nettstedet og hvor mange ganger testen selv feilet; et slikt resultat har failure med fase, steg og adresse.
Hvert resultat har steps (elementet som ble brukt og effect, hva nettleseren gjorde) og goal_check: delene av oppgaven og om skjermene viser hver enkelt. En persona som sier at den nådde målet, mens skjermene bare viser en del av oppgaven, har utfallet partly_reached. groups samler notater fra flere personas om ett problem; en notat-ID er persona:index. http lister HTTP-feil med ressurstypen, om det var en sideinnlasting, siden og trinnet. En køet kjøring har queue (plass, kjøring foran din og fra andre kontoer, sekunder til den starter og til den er klar); en pågående har progress; en fullført har waited_s og ran_s. Et steg der er tastet inn har value, det feltet holdt etterpå. notes_dropped lister opp notater sjekken utlot, med hvorfor. En serverfeil i http har også at (UTC), url, retry (én til forespørsel 2 s senere), hindered og responsheaderne et nettstedseier kan finne det i loggene sine. |
| POST | /runs/{id}/cancel | Avbryt, ubrukte kreditter returneres |
Feil
Format: {"error":{"code":"...","message":"..."}}. En verdi utenfor gyldig område angir også feltet og grensene: {"error":{"code":"invalid_steps","message":"...","field":"steps","min":3,"max":30,"got":40}}
| HTTP | Kode | Betydning |
|---|---|---|
| 400 | invalid_steps, invalid_concurrency | Steg eller parallellkjøring utenfor gyldig område; ingenting ble startet og ingen kreditt brukt |
| 400 | invalid_limit, invalid_cursor | En side i kjøringslisten ble spurt med en feil grense eller før |
| 400 | no_personas | Ingen persona valgt, eller en id er ikke på dette nettstedet |
| 400 | invalid_url, invalid_task, unknown_persona, invalid_generate, invalid_report_lang, domain_unreachable | Et nytt nettsted med et feil felt; ingenting ble lagt til |
| 400 | invalid_dry_run, invalid_idempotency_key, invalid_callback_url | En feil dry_run, Idempotency-Key eller callback_url; ingenting ble startet |
| 400 | not_test_host | Testbetalingsmodus trenger en startside på en testvert |
| 401 | unauthorized | Mangler eller ugyldig nøkkel |
| 402 | insufficient_credits | Ikke nok kreditter |
| 403 | domain_not_verified | Domene ikke verifisert |
| 404 | not_found | Ingenting av dette på kontoen din |
| 409 | too_many_runs | For mange kjøringer i køen |
| 409 | site_exists, too_many_sites | Domenet er allerede på kontoen din, eller kontoen har 20 nettsteder |
| 422 | not_verified | Ingen bevis på domenet funnet ennå |
| 502 | generation_failed | Modellen kunne ikke skrive personas; prøv igjen eller velg fra biblioteket |
| 429 | rate_limited | Forespørselsgrense overskredet |
Hva en kjøring gjør med nettstedet ditt
Kun GET-forespørsler til det verifiserte domenet. Skjema sendes ikke, og felt for passord og kort forblir tomme, så en kjøring registrerer seg aldri, logger ikke inn eller betaler. Unntaket er testbetalingsmodus, som du slår på for en testvert. Notatene kommer fra en modell, sjekk dem før du handler.