03 – REST API Changelog

Version 1.92.0 – , march 09, 2022

Changed:

The following endpoints have been promoted to the public API:

  • /api/v1/reports/geofencing_stay_time
    • Geofencing stay time endpoint. Provides information about the time that a user or device has spent in a certain geofence.
  • /api/v1/reports/visitors
    • Visitors endpoint. Provides information about the unique visitors in buildings in different time aggregations.
  • /api/v1/reports/raw_data
    • Raw data endpoint. Provides information on the positioning of users in buildings.
  • /api/v1/reports/user_positions
    • User positions endpoint. Provides information about the user’s movement in a building (trajectories).
  • /api/v1/reports/heatmap
    • Heatmap endpoint. Provides information about positioning density in a building.

Improved:

  • api/v1/reports/raw_data and api/v1/reports/user_positions
    • Added time_zone query parameter that allows adjusting the time zone of the response data to a specific time zone.
  • api/v1/reports/heatmap
    • Returns the latitude and longitude of the geohash to simplify representations of the heat map in external GIS applications.

Version 1.91.2 – , february 23, 2022

Removed:

  • REST: Removed deprecated endpoints

Version 1.91.1 – , february 09, 2022

Improved:

  • Added monthly grouping is enabled on the /api/v1/reports/visitors endpoint.
  • Added Monthly, daily and hourly grouping is enabled on the /reports/positioning_time endpoint.
  • Standardization of role usage in all user api methods.

Version 1.90.0 – , January 26, 2021

Improved:

  • Added option to filter pois by building in the /api/v1/pois
  • Improve building_ids and organization_id filters in /api/v1/reports/geofencing_stay_time endpoint

Removed:

  • REST: Removed deprecated analytics reports

Version 1.89.0 – , January 3, 2021
Improved:

  • The GET method of /api/v1/building/{id}/pois now supports query param type to filter between outdoor and indoor pois.

Version 1.88.0 – , December 20, 2021
Improved:

  • The PATCH method /api/v1/users/{id} has been published, which allows making modifications in a simpler way over the users entity.
  • Some documentation errors have been fixed.

Version 1.87.0 – , December 14, 2021
Improved:

  • API Reports’ Improvement. Now the fields organization_id and building_ids are not required. If they are not provided, they will be inferred from the authorization headers. In the case of the building_ids parameter, if it is not provided, it will be completed with all the buildings you have access to.
  • We have deprecated the following endpoints:
    • /api/v1/analytics/raw_pose_data
    • /api/v1/realtime/export/{id}
    • /api/v1/realtime/heatmap/{id}
    • /api/v1/realtime/path
  • In response to this deprecation, we have developed and tested higher performance alternatives that you can check in our beta reports API. These beta endpoints are in a pretty mature state. If you want to use any of them in a productive environment, contact our support team to prioritize their development towards a stable version.

Version 1.86.1 – , September 21, 2021
Fixed:

  • The /api/v1/model endpoint now filters duplicated beacons (in the same account) with matching major and minor ids. This prevents that Situm SDK selects the wrong building when using the WIFI_AND_BLE or BLE building detector.

Version 1.86.0 – , September 20, 2021

Improved:

  • Add from_created_at, to_created_at, from_executed_at, to_executed_at filters in Tasks list endpoint (beta api)

Version 1.85.0 – September 08, 2021

Added:

  • Added remote configuration specification (beta api)

Version 1.84.0 – June 21, 2021

Deprecated:

  • Deprecated the fence_id and duration fields in the endpoint “/api/v1/geofencing/analytics” use matched_fence_id and seconds_in_fence instead

Version 1.83.0 – June 21, 2021

Fixed:

  • Fix an error in /api/v1/geofences POST method specification

Version 1.82.0 – April 06, 2021

Improved:

  • Api key permissions documentation

Version 1.66.0 – February 03, 2021

Added:

  • Publish endpoints for deletion and modification of devices

Version 1.50.1 – December 21, 2020

Added:

  • Added poi_id to volatile attribute

Version 1.50.0 – December 14, 2020

Added:

  • Added the endpoint /api/v1/geofencing/analytics

Version 1.49.1 – November 20, 2020

Added:

  • Added created_at and updated_at fields to Organziation entity response

Version 1.46.2 – August 28, 2020

Added:

  • Publish Users and Groups endpoints

Version 1.40.0 – June 30, 2020

Improved:

  • Publish modification endpoints for buildings, floors, geofences, paths, points of interest and images

Version 1.37.2 – June 15, 2020

Added:

  • Add geofences field in the endpoint GET /api/v1/buildings/{id}

Version 1.29 – May 28, 2020

Added:

  • Now the realtime response retrieves the accuracy of each position.

Fixed:

  • Fix some not working analytics endpoints in swagger to perform valid examples.

Version 1.14 – May 18, 2020

Fixed:

  • Several minor bugfixes in the documentation solved in GET /api/v1/poi_categories/{id} endpoint and in the georeferences object retrieved by some cartography objects.

Version 1.9 – April 06, 2020

Added:

  • Added GET /api/v1/infrastructure endpoint to obtain information of the wifi and bluetooth infrastructure of a building

Version 1.8 – March 17, 2020

Added:

  • Added GET /api/v1/version endpoint to get the current version of the api

Subscribe to our newsletter

BASIC INFORMATION ON DATA PROTECTION

Data controller: SITUM TECHNOLOGIES, S.L.
Contact: Data controller: situm@situm.es
Responsible for protection: dpo@situm.es
Purpose and legal basis: To manage the sending of SITUM newsletters only with consent.
Legitimation: Express consent of the interested party.
Recipients: The data will not be passed on to third parties with the exception of legal obligations.
Retention period: As long as the interested party remains subscribed to the newsletter (a link to unsubscribe will be available in each newsletter sent by Situm).
Rights: The interested party may at any time revoke their consent, as well as exercise their rights of opposition, access, conservation, rectification, limitation, deletion of data and not be subject to a decision based only on automated data processing, by writing to SITUM at the addresses indicated.
Additional Information: You can consult additional and detailed information on Data Protection in our privacy policy.

Please, download your copy here

Thank you for downloading our whitepaper. Please do not hesitate to contact us if you would like to know more about how our solutions can help your business. Download whitepaper


Close window