Engage

Get the signed-in fan’s widget snapshot

Changed on

Returns personalized Rank / Fan Rep and HQ Live data. Provide a Clerk session (bearer or cookie) or a widget bearer scoped to widgets:snapshot:read. Request ?include=clubs for up to six favorite or followed clubs. If a game in the returned snapshot is live, the private cache max age is 60 seconds; otherwise it is 3600. A weak ETag ignores updatedAt; a matching If-None-Match returns 304 without a body.

get/api/v1/widgets/snapshot

Request

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

Query parameters

includestring

Comma-separated optional slices. Pass clubs to add up to six favorite or followed clubs. Without it, the clubs field is omitted.

Headers

If-None-Matchstring

Previously returned weak ETag for conditional revalidation.

Response

Personalized widget snapshot

successtrue required

Changes

    • info

      the endpoint scheme security widgetBearerAuth was added to the API

    • info

      added the new optional header request parameter If-None-Match

    • info

      added the new optional query request parameter include

    13 more changes in this revision