Skip to main content

Changelog

Version 1.22 (latest)

  • Filter devices by activity (via linked timeframes)

Version 1.21

Version 1.20

  • Retrieve computed data by activity

Version 1.19

  • Add search and ordering capabilities on resource listing endpoints for athletes, devices, JSON schemas, activities and timeframes
  • Add is_managed filter in athlete's list & retrieve endpoints
  • Add with_device, with_athlete and with_activity parameters to include representation of related resource in timeframe's list & retrieve endpoints
  • Filters & search also works on resource retrieve endpoints
  • List and retrieve device ownerships
  • Fixed birthdate filtering on athlete list endpoint
  • Update doc with dates examples instead of datetime

Version 1.18

  • Add nationality & profile_picture in athlete profile

Version 1.17

  • Add immediate_sending parameter for device bluetooth config update

Version 1.16

  • ⚠️ Remove email field from managed athlete
  • ⚠️ Add interval size limit to preprocessed data & preprocessed data ranges, respectively 2 and 14 days
  • ⚠️ Add throttling system to prevent abuse of the API
  • Add webhook system to let client register callback for activity and timeframes changes, see /api/v1/activities/{activity}/webhooks/
  • Add device's custom_name field and filter, see /api/v1/devices/{device}/set-custom-name/
  • Add JsonSchema's type and parent fields and filters, see /api/v1/json-schemas/

Version 1.15

  • Add user's role & extra permissions infos in account endpoint
    • The role is one of MANAGER, ATHLETE or MANUFACTURER
    • Extra permissions is an array of string indicating extra permission for the user. At this time, only can_create_managed_athletes is an extra permission

Version 1.14

Version 1.13

  • Add self registration web page available on https://api.asi.swiss/register
  • Fixed get bluetooth configurations of a device endpoint returning 502 in some cases

Version 1.12

  • Add new endpoint to get bluetooth configurations of a device

Version 1.11

  • Add new endpoint to retrieve the latest preprocessed data of a device

Version 1.10

  • ⚠️ Change URL from /matlab-jobs/ to /jobs/, the old one is still supported but will be deprecated in the future

Version 1.9

  • Many improvements on websocket stability under system load
  • New websockets URLs with versionning, starting with v1 (note that /api/ has been removed from websockets URLs):
    • wss://api.asi.swiss/ws/v1/preprocessed-data/{device}/
    • wss://api.asi.swiss/ws/v1/computed-data/{activity}/
    • wss://api.asi.swiss/ws/v1/computed-data/{activity}/{timeframe}/
  • ⚠️ Legacy websockets URLs will be deprecated in a future version
    • wss://api.asi.swiss/api/ws/preprocessed-data/{device}/
    • wss://api.asi.swiss/api/ws/computed-data/{activity}/
    • wss://api.asi.swiss/api/ws/computed-data/{activity}/{timeframe}/
  • Managed athletes can now be deleted by their manager using a new endpoint /api/v1/athletes/{athlete}/delete-managed/

Version 1.8

  • Added EXPERIMENTAL endpoint for devices bluetooth pairing configurations

Version 1.7

  • Added endpoint to retrieve a device latest timestamp

Version 1.6

  • Fixed sporadic failure of requests affecting timeframes and activities resulting in timeout
  • No more pause needed between requests affecting timeframes and activities

Version 1.5

  • Speed up the preprocessed data queries using cache mechanism, cache is invalidated after 120 seconds
  • Increase max page size of preprocessed data response to 25000 items (default is still 10000)
  • Return 400 bad request instead of 500 server error when passing disallowed parameters in /oauth2/token/ endpoint

Version 1.4.4

  • Same parameters for preprocessed and preprocessed-ranges endpoints
  • Fixed a bug causing server error during creation of manager user

Version 1.4.0

  • Support for params in websockets to enable reordering buffer of messages (checkout the getting started guide!)

Version 1.3.2

  • Fixed a bug where pagination of list of devices was inconsistent by ordering them by id

Version 1.3

  • Improve overall stability of the system
  • Fixed a bug at user creation

Version 1.2.2

  • Fixed a bug preventing users reading some preprocessed data
  • Internal changes

Version 1.2.1

  • Fixed a bug preventing users of creating timeframes

Version 1.2.0

  • Support for ISO date-time format in preprocessed data list endpoint (as an alternavive of timestamp format)
  • Support for ISO date-time format in preprocessed data ranges list endpoint (instead of date only)
  • Internal changes

Version 1.1.2

  • Internal changes

Version 1.1.1

  • Internal changes

Version 1.1.0

  • List device's preprocessed data ranges of activity
  • Internal changes

Version 1.0.2

  • Fixed a bug where taking ownership of an existing device returned 404
  • Internal changes

Version 1.0.1

  • Fixed a bug on user activation page
  • Fixed bugs on websockets streaming
  • Added ASI logo on pages

Version 1.0.0

  • ⚠️ This version has breaking changes, a migration guide is available at https://api.asi.swiss/doc/migration_v1.html
  • Route now contains the API version, currently /api/v1/ is the only one supported
  • Remove some fields on device resource
  • Taking ownership of device is now done on ASI website at https://api.asi.swiss/device-activation/ or via /take-ownership/ endpoint, /own/ is removed
  • Listing of resources now use pagination
  • Pagination of a device's preprocessed data has been updated to match general pagination parameters et response
  • Add some filtering options on listing of Activity, TimeFrame, Device and Athlete resources
  • For streaming of a device's preprocessed data, its id must be specified as path parameter (previously device_name)

Version 0.1.20

  • Internal changes

Version 0.1.19

  • Internal changes
  • Fix a bug where websockets could not be opened (502)

Version 0.1.18

  • Internal changes

Version 0.1.17

  • Internal changes

Version 0.1.16

  • Internal changes

Version 0.1.15

  • Fix a bug where time frames added to an activity after a websocket connection to computed data of this activity were not included to the stream
  • Creation / modification of managed athletes now require the manager to have a specific permission, which is given by the ASI support team if requested

Version 0.1.14

  • Fix incorrect computed data after timeframe or activity update, uuid of this objects are now internal fields so they will soon be removed from API resource representation
  • Fix a bug where a manager could not create managed athletes
  • Fix documentation about jobs
  • Add JSON schema guide

Version 0.1.13

  • Athlete accounts managed by managers
  • Add routes to retrieve athlete or manager by their external ID

Version 0.1.12

  • Timeframe and activity export to file
  • Removed device /activate/ and /deactivate/, replaced by /own/ and /release-ownership/