Engage

Issue a scoped, revocable widget bearer token

Changed on

Issues an opaque wgt_ bearer token scoped to widgets:snapshot:read. The 201 response returns it once; the API stores only a SHA-256 hash. Issuing again replaces the token for the same user and device. The expiry slides with successful use and is 90 days from issuance or the latest recorded use. The JSON body is capped at 4 KiB.

post/api/v1/widgets/token

Request

  • Base URL
    https://app.d-sports.org
  • Auth
    HTTP bearer

Request body

deviceIdstring required

Per-install client identifier. After trimming, it must be 1–128 characters with no whitespace.

platform'android' | 'ios' required

Response

Widget token issued

successtrue required

Changes