This quickstart verifies Trace events in a Flask app with the trace_device.flask route decorator.
Before you start
You need a secret key (sk_...) from the dashboard's Keys page and a frontend that sends an eventId (see the Web quickstarts). Send it in the x-trace-event-id header or as eventId in the request body.
- 1
Install the SDK
Terminalpip install trace-deviceTerminalexport TRACE_SECRET_KEY=sk_... export TRACE_ENDPOINT=https://id.example.comThe import name is
trace_devicebecausetraceis a standard-library module. - 2
Guard a route
The decorator reads the event id from the
X-Trace-Event-Idheader, a JSON body or a form post, verifies it, and setsflask.g.traceto the server-verified event.Pythonfrom flask import Flask, g from trace_device.flask import trace_guard app = Flask(__name__) @app.post("/api/signup") @trace_guard(fail_open=True, reject=lambda event: event["suspectScore"] >= 60) def signup(): event = g.trace # None only with fail_open when Trace was unreachable # create the user, and store event["visitorId"] with it for later lookups return {"ok": True}The guard answers 400 for a missing or invalid event, 403 when
rejectreturns true, 503 when Trace cannot be reached and 500 for a bad key or missing configuration.fail_open=Trueonly covers the unreachable case; a wrong key never fails open.Start in shadow mode
For the first week, leave out
rejectand logevent["suspectScore"]andevent["reasons"]instead. Look at who would have been blocked, then pick thresholds you trust.