1. Public.Beacons
Dag Ministry API Docs
  • Default module
    • Public.Product
      • Get the current product (resolved from host)
    • Public.Albums
      • List albums for current product
      • Get album detail
      • /api/albums/{slug}/cover
    • Public.Tracks
      • /api/tracks
      • Live search (landing-page dropdown)
      • /api/tracks/{id}/cover
      • Parsed lyrics for the expanded player, or a downloadable file
    • Public.Stream
      • Audio stream with HTTP Range
    • Public.Beacons
      • /api/track-pageview
      • Play beacon — client fires once per listen at min(30s, 50% of duration)
      • Anonymous like/unlike toggle (CSRF double-submit required)
      • Share beacon — fired after a successful native share / clipboard copy
    • Public.Geo
      • /api/geo
    • Public.Download
      • /api/download/submit
      • /api/download/{token}
    • Admin.Products
      • /api/admin/products
      • /api/admin/products
      • /api/admin/products/{id}
      • /api/admin/products/{id}
      • /api/admin/products/{id}
      • /api/admin/products/{id}/branding
      • /api/admin/products/{id}/legacy-count
    • Admin.Albums
      • /api/admin/products/{productId}/albums
      • /api/admin/products/{productId}/albums
      • /api/admin/albums/{id}
      • /api/admin/albums/{id}
      • /api/admin/albums/{id}
      • /api/admin/albums/{id}/cover
      • /api/admin/albums/{id}/tracks/sync-tags
    • Admin.AlbumTags
      • /api/admin/album-tags
      • /api/admin/album-tags
      • /api/admin/album-tags/{id}
      • /api/admin/album-tags/{id}
    • Admin.Tracks
      • /api/admin/albums/{id}/tracks/upload
      • /api/admin/albums/{id}/tracks/commit
      • /api/admin/albums/{id}/tracks/upload-zip
      • /api/admin/albums/{id}/tracks/import-onedrive-zip
      • /api/admin/import-progress/{importId}
      • /api/admin/tracks/{id}
      • /api/admin/tracks/{id}
      • Raw lyrics text + stored format
      • Save/replace lyrics (format detected server-side by content)
      • /api/admin/tracks/{id}/lyrics
      • /api/admin/tracks/{id}/set-album-cover
      • /api/admin/tracks/{id}/localize
      • /api/admin/tracks/{id}/tags
    • Admin.Maintenance
      • /api/admin/maintenance/migrate-storage-paths
    • Admin.OneDrive
      • /api/admin/albums/{id}/import-onedrive/preview
      • /api/admin/albums/{id}/import-onedrive/commit
    • Admin.Analytics
      • /api/admin/analytics/overview
      • Plays / likes / unlikes / shares time-series (rollup + today's raw)
      • /api/admin/analytics/by-country
      • /api/admin/analytics/export/csv
    • Admin.Contacts
      • /api/admin/contacts
      • /api/admin/contacts/{id}
    • Admin.Users
      • /api/admin/users/invite
    • Admin.Settings
      • /api/admin/settings
      • /api/admin/settings
      • AI translation settings (API key masked)
      • Update AI translation settings
      • AI-translate public UI labels for the product Language tab
      • /api/admin/geoip/upload
    • Auth
      • /api/auth/forgot-password
      • /api/auth/reset-password
      • /api/auth/accept-invite
    • Health
      • /api/health
    • Schemas
      • Error
      • BrandColors
      • PublicProduct
      • AlbumSummary
      • TrackSummary
      • LyricsResponse
      • EngagementByDatePoint
      • AlbumDetail
      • Contact
      • DownloadSubmitRequest
      • DownloadSubmitResponse
      • Geo
      • Health
      • AdminProduct
      • OneDrivePreviewItem
      • AnalyticsOverview
  • Dag Ministry API
    • Public.Product
      • Get the current product (resolved from host)
    • Public.Albums
      • List albums for current product
      • Get album detail
      • /api/albums/{slug}/cover
    • Public.Tracks
      • /api/tracks
      • /api/tracks/{id}/cover
      • Parsed lyrics for the expanded player, or a downloadable file
    • Public.Stream
      • Audio stream with HTTP Range
    • Public.Beacons
      • /api/track-pageview
        POST
      • Play beacon — client fires once per listen at min(30s, 50% of duration)
        POST
      • Anonymous like/unlike toggle (CSRF double-submit required)
        POST
      • Share beacon — fired after a successful native share / clipboard copy
        POST
    • Public.Geo
      • /api/geo
    • Public.Download
      • /api/download/submit
      • /api/download/{token}
    • Admin.Products
      • /api/admin/products
      • /api/admin/products
      • /api/admin/products/{id}
      • /api/admin/products/{id}
      • /api/admin/products/{id}
      • /api/admin/products/{id}/branding
      • /api/admin/products/{id}/legacy-count
    • Admin.Albums
      • /api/admin/products/{productId}/albums
      • /api/admin/products/{productId}/albums
      • /api/admin/albums/{id}
      • /api/admin/albums/{id}
      • /api/admin/albums/{id}
      • /api/admin/albums/{id}/cover
    • Admin.Tracks
      • /api/admin/albums/{id}/tracks/upload
      • /api/admin/albums/{id}/tracks/commit
      • /api/admin/albums/{id}/tracks/upload-zip
      • /api/admin/albums/{id}/tracks/import-onedrive-zip
      • /api/admin/import-progress/{importId}
      • /api/admin/tracks/{id}
      • /api/admin/tracks/{id}
      • Raw lyrics text + stored format
      • Save/replace lyrics (format detected server-side by content)
      • /api/admin/tracks/{id}/lyrics
      • /api/admin/tracks/{id}/set-album-cover
      • /api/admin/tracks/{id}/localize
    • Admin.OneDrive
      • /api/admin/albums/{id}/import-onedrive/preview
      • /api/admin/albums/{id}/import-onedrive/commit
    • Admin.Analytics
      • /api/admin/analytics/overview
      • Plays / likes / unlikes / shares time-series (rollup + today's raw)
      • /api/admin/analytics/by-country
      • /api/admin/analytics/export/csv
    • Admin.Contacts
      • /api/admin/contacts
      • /api/admin/contacts/{id}
    • Admin.Users
      • /api/admin/users/invite
    • Admin.Settings
      • /api/admin/settings
      • /api/admin/settings
      • /api/admin/geoip/upload
    • Auth
      • /api/auth/forgot-password
      • /api/auth/reset-password
      • /api/auth/accept-invite
    • Health
      • /api/health
    • Schemas
      • Error
      • BrandColors
      • PublicProduct
      • AlbumSummary
      • TrackSummary
      • LyricsResponse
      • EngagementByDatePoint
      • AlbumDetail
      • Contact
      • DownloadSubmitRequest
      • DownloadSubmitResponse
      • Geo
      • Health
      • AdminProduct
      • OneDrivePreviewItem
      • AnalyticsOverview
  1. Public.Beacons

Play beacon — client fires once per listen at min(30s, 50% of duration)

POST
/api/track-play

Request

Body Params application/jsonRequired

Examples

Responses

🟢204
Recorded (silent 204 on every failure path too)
This response does not have a body.
🟠429
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/api/track-play' \
--header 'Content-Type: application/json' \
--data '{
    "trackId": "fcc44b18-493c-4040-a803-8be99a8f81ac"
}'
Modified at 2026-07-15 18:04:45
Previous
/api/track-pageview
Next
Anonymous like/unlike toggle (CSRF double-submit required)
Built with