import json import os import shutil from datetime import datetime, timedelta from typing import Any, Dict, List, Optional, Tuple, Union import requests from fittrackee import appLog, db from fittrackee.responses import ( DataInvalidPayloadErrorResponse, DataNotFoundErrorResponse, HttpResponse, InternalServerErrorResponse, InvalidPayloadErrorResponse, NotFoundErrorResponse, handle_error_and_return_response, ) from flask import Blueprint, Response, current_app, request, send_file from sqlalchemy import exc from ..users.decorators import authenticate from ..users.utils import User, can_view_workout, verify_extension_and_size from .models import Workout from .utils import ( WorkoutException, create_workout, edit_workout, get_absolute_file_path, get_datetime_with_tz, process_files, ) from .utils_format import convert_in_duration from .utils_gpx import ( WorkoutGPXException, extract_segment_from_gpx_file, get_chart_data, ) from .utils_id import decode_short_id workouts_blueprint = Blueprint('workouts', __name__) WORKOUTS_PER_PAGE = 5 @workouts_blueprint.route('/workouts', methods=['GET']) @authenticate def get_workouts(auth_user_id: int) -> Union[Dict, HttpResponse]: """ Get workouts for the authenticated user. **Example requests**: - without parameters .. sourcecode:: http GET /api/workouts/ HTTP/1.1 - with some query parameters .. sourcecode:: http GET /api/workouts?from=2019-07-02&to=2019-07-31&sport_id=1 HTTP/1.1 **Example responses**: - returning at least one workout .. sourcecode:: http HTTP/1.1 200 OK Content-Type: application/json { "data": { "workouts": [ { "ascent": null, "ave_speed": 10.0, "bounds": [], "creation_date": "Sun, 14 Jul 2019 13:51:01 GMT", "descent": null, "distance": 10.0, "duration": "0:17:04", "id": "kjxavSTUrJvoAh2wvCeGEF", "map": null, "max_alt": null, "max_speed": 10.0, "min_alt": null, "modification_date": null, "moving": "0:17:04", "next_workout": 3, "notes": null, "pauses": null, "previous_workout": null, "records": [ { "id": 4, "record_type": "MS", "sport_id": 1, "user": "admin", "value": 10.0, "workout_date": "Mon, 01 Jan 2018 00:00:00 GMT", "workout_id": "kjxavSTUrJvoAh2wvCeGEF" }, { "id": 3, "record_type": "LD", "sport_id": 1, "user": "admin", "value": "0:17:04", "workout_date": "Mon, 01 Jan 2018 00:00:00 GMT", "workout_id": "kjxavSTUrJvoAh2wvCeGEF" }, { "id": 2, "record_type": "FD", "sport_id": 1, "user": "admin", "value": 10.0, "workout_date": "Mon, 01 Jan 2018 00:00:00 GMT", "workout_id": "kjxavSTUrJvoAh2wvCeGEF" }, { "id": 1, "record_type": "AS", "sport_id": 1, "user": "admin", "value": 10.0, "workout_date": "Mon, 01 Jan 2018 00:00:00 GMT", "workout_id": "kjxavSTUrJvoAh2wvCeGEF" } ], "segments": [], "sport_id": 1, "title": null, "user": "admin", "weather_end": null, "weather_start": null, "with_gpx": false, "workout_date": "Mon, 01 Jan 2018 00:00:00 GMT" } ] }, "status": "success" } - returning no workouts .. sourcecode:: http HTTP/1.1 200 OK Content-Type: application/json { "data": { "workouts": [] }, "status": "success" } :param integer auth_user_id: authenticate user id (from JSON Web Token) :query integer page: page if using pagination (default: 1) :query integer per_page: number of workouts per page (default: 5, max: 50) :query integer sport_id: sport id :query string from: start date (format: ``%Y-%m-%d``) :query string to: end date (format: ``%Y-%m-%d``) :query float distance_from: minimal distance :query float distance_to: maximal distance :query string duration_from: minimal duration (format: ``%H:%M``) :query string duration_to: maximal distance (format: ``%H:%M``) :query float ave_speed_from: minimal average speed :query float ave_speed_to: maximal average speed :query float max_speed_from: minimal max. speed :query float max_speed_to: maximal max. speed :query string order: sorting order (default: ``desc``) :reqheader Authorization: OAuth 2.0 Bearer Token :statuscode 200: success :statuscode 401: - Provide a valid auth token. - Signature expired. Please log in again. - Invalid token. Please log in again. :statuscode 500: """ try: user = User.query.filter_by(id=auth_user_id).first() params = request.args.copy() page = 1 if 'page' not in params.keys() else int(params.get('page')) date_from = params.get('from') if date_from: date_from = datetime.strptime(date_from, '%Y-%m-%d') _, date_from = get_datetime_with_tz(user.timezone, date_from) date_to = params.get('to') if date_to: date_to = datetime.strptime( f'{date_to} 23:59:59', '%Y-%m-%d %H:%M:%S' ) _, date_to = get_datetime_with_tz(user.timezone, date_to) distance_from = params.get('distance_from') distance_to = params.get('distance_to') duration_from = params.get('duration_from') duration_to = params.get('duration_to') ave_speed_from = params.get('ave_speed_from') ave_speed_to = params.get('ave_speed_to') max_speed_from = params.get('max_speed_from') max_speed_to = params.get('max_speed_to') order = params.get('order') sport_id = params.get('sport_id') per_page = ( int(params.get('per_page')) if params.get('per_page') else WORKOUTS_PER_PAGE ) if per_page > 50: per_page = 50 workouts = ( Workout.query.filter( Workout.user_id == auth_user_id, Workout.sport_id == sport_id if sport_id else True, Workout.workout_date >= date_from if date_from else True, Workout.workout_date < date_to + timedelta(seconds=1) if date_to else True, Workout.distance >= int(distance_from) if distance_from else True, Workout.distance <= int(distance_to) if distance_to else True, Workout.moving >= convert_in_duration(duration_from) if duration_from else True, Workout.moving <= convert_in_duration(duration_to) if duration_to else True, Workout.ave_speed >= float(ave_speed_from) if ave_speed_from else True, Workout.ave_speed <= float(ave_speed_to) if ave_speed_to else True, Workout.max_speed >= float(max_speed_from) if max_speed_from else True, Workout.max_speed <= float(max_speed_to) if max_speed_to else True, ) .order_by( Workout.workout_date.asc() if order == 'asc' else Workout.workout_date.desc() ) .paginate(page, per_page, False) .items ) return { 'status': 'success', 'data': { 'workouts': [workout.serialize(params) for workout in workouts] }, } except Exception as e: return handle_error_and_return_response(e) @workouts_blueprint.route( '/workouts/', methods=['GET'] ) @authenticate def get_workout( auth_user_id: int, workout_short_id: str ) -> Union[Dict, HttpResponse]: """ Get an workout **Example request**: .. sourcecode:: http GET /api/workouts/kjxavSTUrJvoAh2wvCeGEF HTTP/1.1 **Example responses**: - success .. sourcecode:: http HTTP/1.1 200 OK Content-Type: application/json { "data": { "workouts": [ { "ascent": null, "ave_speed": 16, "bounds": [], "creation_date": "Sun, 14 Jul 2019 18:57:14 GMT", "descent": null, "distance": 12, "duration": "0:45:00", "id": "kjxavSTUrJvoAh2wvCeGEF", "map": null, "max_alt": null, "max_speed": 16, "min_alt": null, "modification_date": "Sun, 14 Jul 2019 18:57:22 GMT", "moving": "0:45:00", "next_workout": 4, "notes": "workout without gpx", "pauses": null, "previous_workout": 3, "records": [], "segments": [], "sport_id": 1, "title": "biking on sunday morning", "user": "admin", "weather_end": null, "weather_start": null, "with_gpx": false, "workout_date": "Sun, 07 Jul 2019 07:00:00 GMT" } ] }, "status": "success" } - acitivity not found: .. sourcecode:: http HTTP/1.1 404 NOT FOUND Content-Type: application/json { "data": { "workouts": [] }, "status": "not found" } :param integer auth_user_id: authenticate user id (from JSON Web Token) :param string workout_short_id: workout short id :reqheader Authorization: OAuth 2.0 Bearer Token :statuscode 200: success :statuscode 401: - Provide a valid auth token. - Signature expired. Please log in again. - Invalid token. Please log in again. :statuscode 403: You do not have permissions. :statuscode 404: workout not found """ workout_uuid = decode_short_id(workout_short_id) workout = Workout.query.filter_by(uuid=workout_uuid).first() if not workout: return DataNotFoundErrorResponse('workouts') error_response = can_view_workout(auth_user_id, workout.user_id) if error_response: return error_response return { 'status': 'success', 'data': {'workouts': [workout.serialize()]}, } def get_workout_data( auth_user_id: int, workout_short_id: str, data_type: str, segment_id: Optional[int] = None, ) -> Union[Dict, HttpResponse]: """Get data from an workout gpx file""" workout_uuid = decode_short_id(workout_short_id) workout = Workout.query.filter_by(uuid=workout_uuid).first() if not workout: return DataNotFoundErrorResponse( data_type=data_type, message=f'Workout not found (id: {workout_short_id})', ) error_response = can_view_workout(auth_user_id, workout.user_id) if error_response: return error_response if not workout.gpx or workout.gpx == '': return NotFoundErrorResponse( f'No gpx file for this workout (id: {workout_short_id})' ) try: absolute_gpx_filepath = get_absolute_file_path(workout.gpx) chart_data_content: Optional[List] = [] if data_type == 'chart_data': chart_data_content = get_chart_data( absolute_gpx_filepath, segment_id ) else: # data_type == 'gpx' with open(absolute_gpx_filepath, encoding='utf-8') as f: gpx_content = f.read() if segment_id is not None: gpx_segment_content = extract_segment_from_gpx_file( gpx_content, segment_id ) except WorkoutGPXException as e: appLog.error(e.message) if e.status == 'not found': return NotFoundErrorResponse(e.message) return InternalServerErrorResponse(e.message) except Exception as e: return handle_error_and_return_response(e) return { 'status': 'success', 'message': '', 'data': ( { data_type: chart_data_content if data_type == 'chart_data' else gpx_content if segment_id is None else gpx_segment_content } ), } @workouts_blueprint.route( '/workouts//gpx', methods=['GET'] ) @authenticate def get_workout_gpx( auth_user_id: int, workout_short_id: str ) -> Union[Dict, HttpResponse]: """ Get gpx file for an workout displayed on map with Leaflet **Example request**: .. sourcecode:: http GET /api/workouts/kjxavSTUrJvoAh2wvCeGEF/gpx HTTP/1.1 Content-Type: application/json **Example response**: .. sourcecode:: http HTTP/1.1 200 OK Content-Type: application/json { "data": { "gpx": "gpx file content" }, "message": "", "status": "success" } :param integer auth_user_id: authenticate user id (from JSON Web Token) :param string workout_short_id: workout short id :reqheader Authorization: OAuth 2.0 Bearer Token :statuscode 200: success :statuscode 401: - Provide a valid auth token. - Signature expired. Please log in again. - Invalid token. Please log in again. :statuscode 404: - workout not found - no gpx file for this workout :statuscode 500: """ return get_workout_data(auth_user_id, workout_short_id, 'gpx') @workouts_blueprint.route( '/workouts//chart_data', methods=['GET'] ) @authenticate def get_workout_chart_data( auth_user_id: int, workout_short_id: str ) -> Union[Dict, HttpResponse]: """ Get chart data from an workout gpx file, to display it with Recharts **Example request**: .. sourcecode:: http GET /api/workouts/kjxavSTUrJvoAh2wvCeGEF/chart HTTP/1.1 Content-Type: application/json **Example response**: .. sourcecode:: http HTTP/1.1 200 OK Content-Type: application/json { "data": { "chart_data": [ { "distance": 0, "duration": 0, "elevation": 279.4, "latitude": 51.5078118, "longitude": -0.1232004, "speed": 8.63, "time": "Fri, 14 Jul 2017 13:44:03 GMT" }, { "distance": 7.5, "duration": 7380, "elevation": 280, "latitude": 51.5079733, "longitude": -0.1234538, "speed": 6.39, "time": "Fri, 14 Jul 2017 15:47:03 GMT" } ] }, "message": "", "status": "success" } :param integer auth_user_id: authenticate user id (from JSON Web Token) :param string workout_short_id: workout short id :reqheader Authorization: OAuth 2.0 Bearer Token :statuscode 200: success :statuscode 401: - Provide a valid auth token. - Signature expired. Please log in again. - Invalid token. Please log in again. :statuscode 404: - workout not found - no gpx file for this workout :statuscode 500: """ return get_workout_data(auth_user_id, workout_short_id, 'chart_data') @workouts_blueprint.route( '/workouts//gpx/segment/', methods=['GET'], ) @authenticate def get_segment_gpx( auth_user_id: int, workout_short_id: str, segment_id: int ) -> Union[Dict, HttpResponse]: """ Get gpx file for an workout segment displayed on map with Leaflet **Example request**: .. sourcecode:: http GET /api/workouts/kjxavSTUrJvoAh2wvCeGEF/gpx/segment/0 HTTP/1.1 Content-Type: application/json **Example response**: .. sourcecode:: http HTTP/1.1 200 OK Content-Type: application/json { "data": { "gpx": "gpx file content" }, "message": "", "status": "success" } :param integer auth_user_id: authenticate user id (from JSON Web Token) :param string workout_short_id: workout short id :param integer segment_id: segment id :reqheader Authorization: OAuth 2.0 Bearer Token :statuscode 200: success :statuscode 400: no gpx file for this workout :statuscode 401: - Provide a valid auth token. - Signature expired. Please log in again. - Invalid token. Please log in again. :statuscode 404: workout not found :statuscode 500: """ return get_workout_data(auth_user_id, workout_short_id, 'gpx', segment_id) @workouts_blueprint.route( '/workouts//chart_data/segment/' '', methods=['GET'], ) @authenticate def get_segment_chart_data( auth_user_id: int, workout_short_id: str, segment_id: int ) -> Union[Dict, HttpResponse]: """ Get chart data from an workout gpx file, to display it with Recharts **Example request**: .. sourcecode:: http GET /api/workouts/kjxavSTUrJvoAh2wvCeGEF/chart/segment/0 HTTP/1.1 Content-Type: application/json **Example response**: .. sourcecode:: http HTTP/1.1 200 OK Content-Type: application/json { "data": { "chart_data": [ { "distance": 0, "duration": 0, "elevation": 279.4, "latitude": 51.5078118, "longitude": -0.1232004, "speed": 8.63, "time": "Fri, 14 Jul 2017 13:44:03 GMT" }, { "distance": 7.5, "duration": 7380, "elevation": 280, "latitude": 51.5079733, "longitude": -0.1234538, "speed": 6.39, "time": "Fri, 14 Jul 2017 15:47:03 GMT" } ] }, "message": "", "status": "success" } :param integer auth_user_id: authenticate user id (from JSON Web Token) :param string workout_short_id: workout short id :param integer segment_id: segment id :reqheader Authorization: OAuth 2.0 Bearer Token :statuscode 200: success :statuscode 400: no gpx file for this workout :statuscode 401: - Provide a valid auth token. - Signature expired. Please log in again. - Invalid token. Please log in again. :statuscode 404: workout not found :statuscode 500: """ return get_workout_data( auth_user_id, workout_short_id, 'chart_data', segment_id ) @workouts_blueprint.route('/workouts/map/', methods=['GET']) def get_map(map_id: int) -> Any: """ Get map image for workouts with gpx **Example request**: .. sourcecode:: http GET /api/workouts/map/fa33f4d996844a5c73ecd1ae24456ab8?1563529507772 HTTP/1.1 **Example response**: .. sourcecode:: http HTTP/1.1 200 OK Content-Type: image/png :param string map_id: workout map id :statuscode 200: success :statuscode 401: - Provide a valid auth token. - Signature expired. Please log in again. - Invalid token. Please log in again. :statuscode 404: map does not exist :statuscode 500: """ try: workout = Workout.query.filter_by(map_id=map_id).first() if not workout: return NotFoundErrorResponse('Map does not exist.') absolute_map_filepath = get_absolute_file_path(workout.map) return send_file(absolute_map_filepath) except Exception as e: return handle_error_and_return_response(e) @workouts_blueprint.route( '/workouts/map_tile////.png', methods=['GET'] ) def get_map_tile(s: str, z: str, x: str, y: str) -> Tuple[Response, int]: """ Get map tile from tile server. **Example request**: .. sourcecode:: http GET /api/workouts/map_tile/c/13/4109/2930.png HTTP/1.1 **Example response**: .. sourcecode:: http HTTP/1.1 200 OK Content-Type: image/png :param string s: subdomain :param string z: zoom :param string x: index of the tile along the map's x axis :param string y: index of the tile along the map's y axis Status codes are status codes returned by tile server """ url = current_app.config['TILE_SERVER']['URL'].format(s=s, z=z, x=x, y=y) headers = {'User-Agent': 'Mozilla/5.0'} response = requests.get(url, headers=headers) return ( Response( response.content, content_type=response.headers['content-type'], ), response.status_code, ) @workouts_blueprint.route('/workouts', methods=['POST']) @authenticate def post_workout(auth_user_id: int) -> Union[Tuple[Dict, int], HttpResponse]: """ Post an workout with a gpx file **Example request**: .. sourcecode:: http POST /api/workouts/ HTTP/1.1 Content-Type: multipart/form-data **Example response**: .. sourcecode:: http HTTP/1.1 201 CREATED Content-Type: application/json { "data": { "workouts": [ { "ascent": null, "ave_speed": 10.0, "bounds": [], "creation_date": "Sun, 14 Jul 2019 13:51:01 GMT", "descent": null, "distance": 10.0, "duration": "0:17:04", "id": "kjxavSTUrJvoAh2wvCeGEF", "map": null, "max_alt": null, "max_speed": 10.0, "min_alt": null, "modification_date": null, "moving": "0:17:04", "next_workout": 3, "notes": null, "pauses": null, "previous_workout": null, "records": [ { "id": 4, "record_type": "MS", "sport_id": 1, "user": "admin", "value": 10., "workout_date": "Mon, 01 Jan 2018 00:00:00 GMT", "workout_id": "kjxavSTUrJvoAh2wvCeGEF" }, { "id": 3, "record_type": "LD", "sport_id": 1, "user": "admin", "value": "0:17:04", "workout_date": "Mon, 01 Jan 2018 00:00:00 GMT", "workout_id": "kjxavSTUrJvoAh2wvCeGEF", }, { "id": 2, "record_type": "FD", "sport_id": 1, "user": "admin", "value": 10.0, "workout_date": "Mon, 01 Jan 2018 00:00:00 GMT", "workout_id": "kjxavSTUrJvoAh2wvCeGEF" }, { "id": 1, "record_type": "AS", "sport_id": 1, "user": "admin", "value": 10.0, "workout_date": "Mon, 01 Jan 2018 00:00:00 GMT", "workout_id": "kjxavSTUrJvoAh2wvCeGEF" } ], "segments": [], "sport_id": 1, "title": null, "user": "admin", "weather_end": null, "weather_start": null, "with_gpx": false, "workout_date": "Mon, 01 Jan 2018 00:00:00 GMT" } ] }, "status": "success" } :param integer auth_user_id: authenticate user id (from JSON Web Token) :form file: gpx file (allowed extensions: .gpx, .zip) :form data: sport id and notes (example: ``{"sport_id": 1, "notes": ""}``) :reqheader Authorization: OAuth 2.0 Bearer Token :statuscode 201: workout created :statuscode 400: - Invalid payload. - No file part. - No selected file. - File extension not allowed. :statuscode 401: - Provide a valid auth token. - Signature expired. Please log in again. - Invalid token. Please log in again. :statuscode 413: Error during picture update: file size exceeds 1.0MB. :statuscode 500: """ error_response = verify_extension_and_size('workout', request) if error_response: return error_response workout_data = json.loads(request.form['data']) if not workout_data or workout_data.get('sport_id') is None: return InvalidPayloadErrorResponse() workout_file = request.files['file'] upload_dir = os.path.join( current_app.config['UPLOAD_FOLDER'], 'workouts', str(auth_user_id) ) folders = { 'extract_dir': os.path.join(upload_dir, 'extract'), 'tmp_dir': os.path.join(upload_dir, 'tmp'), } try: new_workouts = process_files( auth_user_id, workout_data, workout_file, folders ) if len(new_workouts) > 0: response_object = { 'status': 'created', 'data': { 'workouts': [ new_workout.serialize() for new_workout in new_workouts ] }, } else: return DataInvalidPayloadErrorResponse('workouts', 'fail') except WorkoutException as e: db.session.rollback() if e.e: appLog.error(e.e) if e.status == 'error': return InternalServerErrorResponse(e.message) return InvalidPayloadErrorResponse(e.message) shutil.rmtree(folders['extract_dir'], ignore_errors=True) shutil.rmtree(folders['tmp_dir'], ignore_errors=True) return response_object, 201 @workouts_blueprint.route('/workouts/no_gpx', methods=['POST']) @authenticate def post_workout_no_gpx( auth_user_id: int, ) -> Union[Tuple[Dict, int], HttpResponse]: """ Post an workout without gpx file **Example request**: .. sourcecode:: http POST /api/workouts/no_gpx HTTP/1.1 Content-Type: application/json **Example response**: .. sourcecode:: http HTTP/1.1 201 CREATED Content-Type: application/json { "data": { "workouts": [ { "ascent": null, "ave_speed": 10.0, "bounds": [], "creation_date": "Sun, 14 Jul 2019 13:51:01 GMT", "descent": null, "distance": 10.0, "duration": "0:17:04", "map": null, "max_alt": null, "max_speed": 10.0, "min_alt": null, "modification_date": null, "moving": "0:17:04", "next_workout": 3, "notes": null, "pauses": null, "previous_workout": null, "records": [ { "id": 4, "record_type": "MS", "sport_id": 1, "user": "admin", "value": 10., "workout_date": "Mon, 01 Jan 2018 00:00:00 GMT", "workout_id": "kjxavSTUrJvoAh2wvCeGEF" }, { "id": 3, "record_type": "LD", "sport_id": 1, "user": "admin", "value": "0:17:04", "workout_date": "Mon, 01 Jan 2018 00:00:00 GMT", "workout_id": "kjxavSTUrJvoAh2wvCeGEF" }, { "id": 2, "record_type": "FD", "sport_id": 1, "user": "admin", "value": 10.0, "workout_date": "Mon, 01 Jan 2018 00:00:00 GMT", "workout_id": "kjxavSTUrJvoAh2wvCeGEF" }, { "id": 1, "record_type": "AS", "sport_id": 1, "user": "admin", "value": 10.0, "workout_date": "Mon, 01 Jan 2018 00:00:00 GMT", "workout_id": "kjxavSTUrJvoAh2wvCeGEF" } ], "segments": [], "sport_id": 1, "title": null, "user": "admin", "uuid": "kjxavSTUrJvoAh2wvCeGEF" "weather_end": null, "weather_start": null, "with_gpx": false, "workout_date": "Mon, 01 Jan 2018 00:00:00 GMT" } ] }, "status": "success" } :param integer auth_user_id: authenticate user id (from JSON Web Token) :', methods=['PATCH'] ) @authenticate def update_workout( auth_user_id: int, workout_short_id: str ) -> Union[Dict, HttpResponse]: """ Update an workout **Example request**: .. sourcecode:: http PATCH /api/workouts/1 HTTP/1.1 Content-Type: application/json **Example response**: .. sourcecode:: http HTTP/1.1 200 OK Content-Type: application/json { "data": { "workouts": [ { "ascent": null, "ave_speed": 10.0, "bounds": [], "creation_date": "Sun, 14 Jul 2019 13:51:01 GMT", "descent": null, "distance": 10.0, "duration": "0:17:04", "map": null, "max_alt": null, "max_speed": 10.0, "min_alt": null, "modification_date": null, "moving": "0:17:04", "next_workout": 3, "notes": null, "pauses": null, "previous_workout": null, "records": [ { "id": 4, "record_type": "MS", "sport_id": 1, "user": "admin", "value": 10.0, "workout_date": "Mon, 01 Jan 2018 00:00:00 GMT", "workout_id": "kjxavSTUrJvoAh2wvCeGEF" }, { "id": 3, "record_type": "LD", "sport_id": 1, "user": "admin", "value": "0:17:04", "workout_date": "Mon, 01 Jan 2018 00:00:00 GMT", "workout_id": "kjxavSTUrJvoAh2wvCeGEF" }, { "id": 2, "record_type": "FD", "sport_id": 1, "user": "admin", "value": 10.0, "workout_date": "Mon, 01 Jan 2018 00:00:00 GMT", "workout_id": "kjxavSTUrJvoAh2wvCeGEF", }, { "id": 1, "record_type": "AS", "sport_id": 1, "user": "admin", "value": 10.0, "workout_date": "Mon, 01 Jan 2018 00:00:00 GMT", "workout_id": "kjxavSTUrJvoAh2wvCeGEF", } ], "segments": [], "sport_id": 1, "title": null, "user": "admin", "uuid": "kjxavSTUrJvoAh2wvCeGEF" "weather_end": null, "weather_start": null, "with_gpx": false, "workout_date": "Mon, 01 Jan 2018 00:00:00 GMT" } ] }, "status": "success" } :param integer auth_user_id: authenticate user id (from JSON Web Token) :param string workout_short_id: workout short id :', methods=['DELETE'] ) @authenticate def delete_workout( auth_user_id: int, workout_short_id: str ) -> Union[Tuple[Dict, int], HttpResponse]: """ Delete an workout **Example request**: .. sourcecode:: http DELETE /api/workouts/kjxavSTUrJvoAh2wvCeGEF HTTP/1.1 Content-Type: application/json **Example response**: .. sourcecode:: http HTTP/1.1 204 NO CONTENT Content-Type: application/json :param integer auth_user_id: authenticate user id (from JSON Web Token) :param string workout_short_id: workout short id :reqheader Authorization: OAuth 2.0 Bearer Token :statuscode 204: workout deleted :statuscode 401: - Provide a valid auth token. - Signature expired. Please log in again. - Invalid token. Please log in again. :statuscode 404: workout not found :statuscode 500: Error. Please try again or contact the administrator. """ try: workout_uuid = decode_short_id(workout_short_id) workout = Workout.query.filter_by(uuid=workout_uuid).first() if not workout: return DataNotFoundErrorResponse('workouts') error_response = can_view_workout(auth_user_id, workout.user_id) if error_response: return error_response db.session.delete(workout) db.session.commit() return {'status': 'no content'}, 204 except ( exc.IntegrityError, exc.OperationalError, ValueError, OSError, ) as e: return handle_error_and_return_response(e, db=db)