wearables

Link Callback

OAuth return handler.

The provider redirects the user back here with ?code=<grant>&state=<our_state>. If user denies on provider side, we get ?error=access_denied.

This endpoint is UNAUTHENTICATED — we identify the user from the persisted state row, not from session. That's the whole point of storing state in the DB: the callback must work even across a browser new-tab / in-app-browser flow where cookies don't roundtrip.

Security properties:

  • State must exist, not be consumed, not be expired.
  • State is marked consumed_at on first use → replay-proof.
  • On any error, we DON'T tell the user which specific check failed — generic 'link failed' message with ops detail in the log.
get/api/wearables/link/callback

Request

  • Base URL: https://api.activitia.net (the document declares no server; this is the origin it was published from)
  • URL: https://api.activitia.net/api/wearables/link/callback
  • Auth: none declared

Query parameters

codestring nullable
statestring nullable
errorstring nullable

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.