Headless
Migrate from V1.0
See how the three V1.0 server calls become the Headless flow, with the code before and after.
Note:
Formerly V1.2
Headless was called the V1.2 REST API. This page was at /authentication/v1-2/migration; old links still work. The API and its field names are unchanged.
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)
- POST
/transactions-- create transaction - POST
/transactions/activate/{id}-- send OTP - POST
/transactions/verify/{id}-- verify OTP
Headless Flow (3 server calls + 1 client step)
- GET
/v1.2/transactions/challenge-- get PoW challenge - Client: solve PoW + get Turnstile token (Shield SDK)
- POST
/v1.2/transactions/send-- send OTP with proofs and the real end user's IP inx-end-user-ip - POST
/v1.2/transactions/verify-- verify OTP (transactionReqIDin body)
