KEkernel
Browsers

Buy a browser session with a machine payment

Changed on

Buys a stealth headful browser for the duration in the offer with a Machine Payments Protocol (MPP) payment, without a Kernel account. A request without an Authorization: Payment credential gets a 402 challenge; the paid retry returns the browser and a Payment-Receipt header. A challenge can be paid until its expires time, 30 minutes after it is issued by default. A challenge buys one browser. Resending the same paid credential is intentional and safe: it returns the same browser without charging again until the session expires, even after the challenge has expired, so an agent can retry after a timeout. After the session expires it gets a 402 with a fresh challenge and code: session_expired. A different payment for a challenge that was already charged is rejected with a 402 before any charge.

post/mpp/browsers

Request

  • Base URL
    https://api.onkernel.com
  • URL
    https://api.onkernel.com/mpp/browsers
  • Auth
    none required

Request body

emailstring email

Optional address for the Stripe receipt. When omitted, the billing email shared with the payment token is used, if any. A malformed address is rejected with a 400 before any challenge or charge.

Response

The purchased browser session.

browser_live_view_urlstring
cdp_ws_urlstring required
created_atstring date-time required
duration_minutesinteger required
expires_atstring date-time required
headlessboolean required
session_idstring required
stealthboolean required
webdriver_ws_urlstring required

Changes