Skip to content
Akedly
Headless

Migrate from V1.0

See how the three V1.0 server calls become the Headless flow, with the code before and after.

Migration from V1.0

Upgrading from V1.0 to Headless preserves the REST API approach while adding Shield security. The key difference: Headless merges "create" and "activate" into a single "send" call, but adds a prerequisite "get challenge" step.

V1.0 Flow (3 server calls)

  1. POST /transactions -- create transaction
  2. POST /transactions/activate/{id} -- send OTP
  3. POST /transactions/verify/{id} -- verify OTP

Headless Flow (3 server calls + 1 client step)

  1. GET /v1.2/transactions/challenge -- get PoW challenge
  2. Client: solve PoW + get Turnstile token (Shield SDK)
  3. POST /v1.2/transactions/send -- send OTP with proofs and the real end user's IP in x-end-user-ip
  4. POST /v1.2/transactions/verify -- verify OTP (transactionReqID in body)