Authentification et compte#

POST /api/auth/register#

Enregistrer un utilisateur et envoyer un courriel de confirmation.

Le compte nouvellement créé est inactif. L’utilisateur doit confirmer son adresse électronique pour l’activer.

Exemple de requête:

POST /api/auth/register HTTP/1.1
Content-Type: application/json

Exemple de réponse:

  • success:

HTTP/1.1 200 SUCCESS
Content-Type: application/json

{
  "status": "success"
}
  • error on registration:

HTTP/1.1 400 BAD REQUEST
Content-Type: application/json

{
  "message": "Errors: email: valid email must be provided\n",
  "status": "error"
}
Objet JSON de requête:
  • username (string) – nom d’utilisateur (3 à 30 caractères requis)

  • email (string) – adresse électronique de l’utilisateur

  • password (string) – mot de passe (8 caractères minimum)

  • lang (string) – préférence de la langue utilisée sur l’interface (si non fournie, la langue utilisée sera l’anglais (“en”)

  • accepted_policy (boolean) – true if user accepted privacy policy

Codes d’état:
  • 200 OKsuccess

  • 400 Bad Request

    • invalid payload

    • sorry, that username is already taken

    • sorry, you must agree privacy policy to register

    • username: 3 to 30 characters required

    • username: only alphanumeric characters and the underscore character "_" allowed

    • email: valid email must be provided

    • password: 8 characters required

  • 403 Forbiddenerror, registration is disabled

  • 500 Internal Server Errorerror, please try again or contact the administrator

POST /api/auth/account/confirm#

Activer le compte utilisateur après l’inscription.

Exemple de requête:

POST /api/auth/account/confirm HTTP/1.1
Content-Type: application/json

Exemple de réponse:

HTTP/1.1 200 OK
Content-Type: application/json

{
  "auth_token": "JSON Web Token",
  "message": "account confirmation successful",
  "status": "success"
}
Objet JSON de requête:
  • token (string) – jeton de confirmation

Codes d’état:
POST /api/auth/account/resend-confirmation#

Renvoyer le courriel avec les instructions pour confirmer le compte.

Si l’envoi des courriels est désactivé, ce point d’accès n’est pas disponible.

Exemple de requête:

POST /api/auth/account/resend-confirmation HTTP/1.1
Content-Type: application/json

Exemple de réponse:

HTTP/1.1 200 OK
Content-Type: application/json

{
  "message": "confirmation email resent",
  "status": "success"
}
Objet JSON de requête:
  • email (string) – adresse électronique de l’utilisateur

Codes d’état:
POST /api/auth/login#

Connexion de l’utilisateur

Seuls les utilisateurs disposant d’un compte actif peuvent se connecter.

Exemple de requête:

POST /api/auth/login HTTP/1.1
Content-Type: application/json

Exemple de réponse:

  • connexion avec succès :

HTTP/1.1 200 OK
Content-Type: application/json

{
  "auth_token": "JSON Web Token",
  "message": "successfully logged in",
  "status": "success"
}
  • erreur à la connexion

HTTP/1.1 401 UNAUTHORIZED
Content-Type: application/json

{
  "message": "invalid credentials",
  "status": "error"
}
Objet JSON de requête:
  • email (string) – adresse électronique de l’utilisateur

  • password (string) – mot de passe

Codes d’état:
GET /api/auth/profile#

Obtenir des informations sur l’utilisateur authentifié (profil, compte, préférences).

Scope: profile:read

Exemple de requête:

GET /api/auth/profile HTTP/1.1
Content-Type: application/json

Exemple de réponse:

HTTP/1.1 200 OK
Content-Type: application/json

{
  "data": {
    "accepted_privacy_policy": true,
    "admin": false,
    "bio": null,
    "birth_date": null,
    "created_at": "Sun, 14 Jul 2019 14:09:58 GMT",
    "date_format": "dd/MM/yyyy",
    "display_ascent": true,
    "email": "sam@example.com",
    "email_to_confirm": null,
    "first_name": null,
    "imperial_units": false,
    "is_active": true,
    "language": "en",
    "last_name": null,
    "location": null,
    "nb_sports": 3,
    "nb_workouts": 6,
    "picture": false,
    "records": [
      {
        "id": 9,
        "record_type": "AS",
        "sport_id": 1,
        "user": "sam",
        "value": 18,
        "workout_date": "Sun, 07 Jul 2019 08:00:00 GMT",
        "workout_id": "hvYBqYBRa7wwXpaStWR4V2"
      },
      {
        "id": 10,
        "record_type": "FD",
        "sport_id": 1,
        "user": "sam",
        "value": 18,
        "workout_date": "Sun, 07 Jul 2019 08:00:00 GMT",
        "workout_id": "hvYBqYBRa7wwXpaStWR4V2"
      },
      {
        "id": 13,
        "record_type": "HA",
        "sport_id": 1,
        "user": "Sam",
        "value": 43.97,
        "workout_date": "Sun, 07 Jul 2019 08:00:00 GMT",
        "workout_id": "hvYBqYBRa7wwXpaStWR4V2"
      },
      {
        "id": 11,
        "record_type": "LD",
        "sport_id": 1,
        "user": "sam",
        "value": "1:01:00",
        "workout_date": "Sun, 07 Jul 2019 08:00:00 GMT",
        "workout_id": "hvYBqYBRa7wwXpaStWR4V2"
      },
      {
        "id": 12,
        "record_type": "MS",
        "sport_id": 1,
        "user": "sam",
        "value": 18,
        "workout_date": "Sun, 07 Jul 2019 08:00:00 GMT",
        "workout_id": "hvYBqYBRa7wwXpaStWR4V2"
      }
    ],
    "sports_list": [
        1,
        4,
        6
    ],
    "start_elevation_at_zero": false,
    "timezone": "Europe/Paris",
    "total_ascent": 720.35,
    "total_distance": 67.895,
    "total_duration": "6:50:27",
    "use_raw_gpx_speed": false,
    "username": "sam",
    "weekm": false
  },
  "status": "success"
}
En-têtes de requête:
Codes d’état:
  • 200 OKsuccess

  • 401 Unauthorized

    • provide a valid auth token

    • signature expired, please log in again

    • invalid token, please log in again

POST /api/auth/profile/edit#

Modifier le profil de l’utilisateur authentifié.

Scope: profile:write

Exemple de requête:

POST /api/auth/profile/edit HTTP/1.1
Content-Type: application/json

Exemple de réponse:

HTTP/1.1 200 OK
Content-Type: application/json

{
  "data": {
    "accepted_privacy_policy": true,
    "admin": false,
    "bio": null,
    "birth_date": null,
    "created_at": "Sun, 14 Jul 2019 14:09:58 GMT",
    "date_format": "dd/MM/yyyy",
    "display_ascent": true,
    "email": "sam@example.com",
    "email_to_confirm": null,
    "first_name": null,
    "imperial_units": false,
    "is_active": true,
    "language": "en",
    "last_name": null,
    "location": null,
    "nb_sports": 3,
    "nb_workouts": 6,
    "picture": false,
    "records": [
      {
        "id": 9,
        "record_type": "AS",
        "sport_id": 1,
        "user": "sam",
        "value": 18,
        "workout_date": "Sun, 07 Jul 2019 08:00:00 GMT",
        "workout_id": "hvYBqYBRa7wwXpaStWR4V2"
      },
      {
        "id": 10,
        "record_type": "FD",
        "sport_id": 1,
        "user": "sam",
        "value": 18,
        "workout_date": "Sun, 07 Jul 2019 08:00:00 GMT",
        "workout_id": "hvYBqYBRa7wwXpaStWR4V2"
      },
      {
        "id": 13,
        "record_type": "HA",
        "sport_id": 1,
        "user": "Sam",
        "value": 43.97,
        "workout_date": "Sun, 07 Jul 2019 08:00:00 GMT",
        "workout_id": "hvYBqYBRa7wwXpaStWR4V2"
      },
      {
        "id": 11,
        "record_type": "LD",
        "sport_id": 1,
        "user": "sam",
        "value": "1:01:00",
        "workout_date": "Sun, 07 Jul 2019 08:00:00 GMT",
        "workout_id": "hvYBqYBRa7wwXpaStWR4V2"
      },
      {
        "id": 12,
        "record_type": "MS",
        "sport_id": 1,
        "user": "sam",
        "value": 18,
        "workout_date": "Sun, 07 Jul 2019 08:00:00 GMT",
        "workout_id": "hvYBqYBRa7wwXpaStWR4V2"
      }
    ],
    "sports_list": [
        1,
        4,
        6
    ],
    "start_elevation_at_zero": false,
    "timezone": "Europe/Paris",
    "total_ascent": 720.35,
    "total_distance": 67.895,
    "total_duration": "6:50:27",
    "use_raw_gpx_speed": false,
    "username": "sam"
    "weekm": true,
  },
  "message": "user profile updated",
  "status": "success"
}
Objet JSON de requête:
  • first_name (string) – prénom de l’utilisateur

  • last_name (string) – nom de l’utilisateur

  • location (string) – localisation de l’utilisateur

  • bio (string) – biographie de l’utilisateur

  • birth_date (string) – date de naissance de l’utilisateur (format: %Y-%m-%d)

En-têtes de requête:
Codes d’état:
POST /api/auth/profile/edit/preferences#

Modifier les préférences de l’utilisateur authentifié.

Formats de date pris en charge :

  • MM/dd/yyyy (valeur par défaut)

  • dd/MM/yyyy

  • yyyy-MM-dd

  • date_string, correspondant sur l’application à :

    • MMM. do, yyyy pour la locale en

    • d MMM yyyy pour les locales es, fr, gl, it et nl

    • do MMM yyyy` pour les locales de et nb

Scope: profile:write

Exemple de requête:

POST /api/auth/profile/edit/preferences HTTP/1.1
Content-Type: application/json

Exemple de réponse:

HTTP/1.1 200 OK
Content-Type: application/json

{
  "data": {
    "accepted_privacy_policy": true,
    "admin": false,
    "bio": null,
    "birth_date": null,
    "created_at": "Sun, 14 Jul 2019 14:09:58 GMT",
    "date_format": "MM/dd/yyyy",
    "display_ascent": true,
    "email": "sam@example.com",
    "email_to_confirm": null,
    "first_name": null,
    "imperial_units": false,
    "is_active": true,
    "language": "en",
    "last_name": null,
    "location": null,
    "nb_sports": 3,
    "nb_workouts": 6,
    "picture": false,
    "records": [
      {
        "id": 9,
        "record_type": "AS",
        "sport_id": 1,
        "user": "sam",
        "value": 18,
        "workout_date": "Sun, 07 Jul 2019 08:00:00 GMT",
        "workout_id": "hvYBqYBRa7wwXpaStWR4V2"
      },
      {
        "id": 10,
        "record_type": "FD",
        "sport_id": 1,
        "user": "sam",
        "value": 18,
        "workout_date": "Sun, 07 Jul 2019 08:00:00 GMT",
        "workout_id": "hvYBqYBRa7wwXpaStWR4V2"
      },
      {
        "id": 13,
        "record_type": "HA",
        "sport_id": 1,
        "user": "Sam",
        "value": 43.97,
        "workout_date": "Sun, 07 Jul 2019 08:00:00 GMT",
        "workout_id": "hvYBqYBRa7wwXpaStWR4V2"
      },
      {
        "id": 11,
        "record_type": "LD",
        "sport_id": 1,
        "user": "sam",
        "value": "1:01:00",
        "workout_date": "Sun, 07 Jul 2019 08:00:00 GMT",
        "workout_id": "hvYBqYBRa7wwXpaStWR4V2"
      },
      {
        "id": 12,
        "record_type": "MS",
        "sport_id": 1,
        "user": "sam",
        "value": 18,
        "workout_date": "Sun, 07 Jul 2019 08:00:00 GMT",
        "workout_id": "hvYBqYBRa7wwXpaStWR4V2"
      }
    ],
    "sports_list": [
        1,
        4,
        6
    ],
    "start_elevation_at_zero": true,
    "timezone": "Europe/Paris",
    "total_ascent": 720.35,
    "total_distance": 67.895,
    "total_duration": "6:50:27",
    "use_raw_gpx_speed": true,
    "username": "sam"
    "weekm": true,
  },
  "message": "user preferences updated",
  "status": "success"
}
Objet JSON de requête:
  • date_format (string) – le format utilisé pour afficher les dates dans l’application

  • display_ascent (boolean) – afficher les records de dénivelé et le total de dénivelé

  • imperial_units (boolean) – afficher la distance en unités impériales

  • language (string) – préférences pour la langue

  • start_elevation_at_zero (boolean) – Les graphiques d’altitude commencent-ils à zéro ?

  • timezone (string) – fuseau horaire de l’utilisateur

  • use_raw_gpx_speed (boolean) – Utiliser des points gpx non filtrés pour calculer les vitesses

  • weekm (boolean) – La semaine commence-t-elle le lundi ?

En-têtes de requête:
Codes d’état:
  • 200 OKuser preferences updated

  • 400 Bad Request

    • invalid payload

    • password: password and password confirmation don't match

  • 401 Unauthorized

    • provide a valid auth token

    • signature expired, please log in again

    • invalid token, please log in again

  • 500 Internal Server Errorerror, please try again or contact the administrator

POST /api/auth/profile/edit/sports#

Modifier les préférences des sports de l’utilisateur authentifié.

Scope: profile:write

Exemple de requête:

POST /api/auth/profile/edit/sports HTTP/1.1
Content-Type: application/json

Exemple de réponse:

HTTP/1.1 200 OK
Content-Type: application/json

{
  "data": {
    "color": "#000000",
    "is_active": true,
    "sport_id": 1,
    "stopped_speed_threshold": 1,
    "user_id": 1
  },
  "message": "user sport preferences updated",
  "status": "success"
}
Objet JSON de requête:
  • color (string) – couleur au format hexadécimale valide

  • is_active (boolean) – le sport est-il disponible lors de l’ajout d’une séance

  • stopped_speed_threshold (float) – seuil de vitesse arrêté utilisé par gpxpy

En-têtes de requête:
Codes d’état:
DELETE /api/auth/profile/reset/sports/(sport_id)#

Réinitialiser les préférences de l’utilisateur authentifié pour un sport donné.

Scope: profile:write

Exemple de requête:

DELETE /api/auth/profile/reset/sports/1 HTTP/1.1
Content-Type: application/json

Exemple de réponse:

HTTP/1.1 204 OK
Content-Type: application/json
Paramètres:
  • sport_id (string) – identifiant du sport

En-têtes de requête:
Codes d’état:
POST /api/auth/picture#

Mise à jour de l’image de l’utilisateur authentifié.

Scope: profile:write

Exemple de requête:

POST /api/auth/picture HTTP/1.1
Content-Type: multipart/form-data

Exemple de réponse:

HTTP/1.1 200 OK
Content-Type: application/json

{
  "message": "user picture updated",
  "status": "success"
}
Paramètres de la forme:
  • file – fichier de l’image (extensions autorisées : .jpg, .png, .gif)

En-têtes de requête:
Codes d’état:
DELETE /api/auth/picture#

Supprimer l’image de l’utilisateur authentifié.

Scope: profile:write

Exemple de requête:

DELETE /api/auth/picture HTTP/1.1
Content-Type: application/json

Exemple de réponse:

HTTP/1.1 204 NO CONTENT
Content-Type: application/json
En-têtes de requête:
Codes d’état:
POST /api/auth/password/reset-request#

Traiter les demandes de réinitialisation de mot de passe.

Si l’envoi de courriels est désactivé, ce point d’accès n’est pas disponible.

Exemple de requête:

POST /api/auth/password/reset-request HTTP/1.1
Content-Type: application/json

Exemple de réponse:

HTTP/1.1 200 OK
Content-Type: application/json

{
  "message": "password reset request processed",
  "status": "success"
}
Objet JSON de requête:
  • email (string) – adresse électronique de l’utilisateur

Codes d’état:
PATCH /api/auth/profile/edit/account#

Mise à jour de l’email et du mot de passe de l’utilisateur authentifié.

Les courriels suivants sont envoyés si l’envoi est activé :

  • Modification de mot de passe

  • Changement d’adresse électronique

    • un à l’adresse actuelle pour informer l’utilisateur

    • un autre à la nouvelle adresse pour la confirmer.

Scope: profile:write

Exemple de requête:

PATCH /api/auth/profile/edit/account HTTP/1.1
Content-Type: application/json

Exemple de réponse:

HTTP/1.1 200 OK
Content-Type: application/json

{
  "data": {
    "accepted_privacy_policy": true,
    "admin": false,
    "bio": null,
    "birth_date": null,
    "created_at": "Sun, 14 Jul 2019 14:09:58 GMT",
    "date_format": "dd/MM/yyyy",
    "display_ascent": true,
    "email": "sam@example.com",
    "email_to_confirm": null,
    "first_name": null,
    "imperial_units": false,
    "is_active": true,
    "language": "en",
    "last_name": null,
    "location": null,
    "nb_sports": 3,
    "nb_workouts": 6,
    "picture": false,
    "records": [
      {
        "id": 9,
        "record_type": "AS",
        "sport_id": 1,
        "user": "sam",
        "value": 18,
        "workout_date": "Sun, 07 Jul 2019 08:00:00 GMT",
        "workout_id": "hvYBqYBRa7wwXpaStWR4V2"
      },
      {
        "id": 10,
        "record_type": "FD",
        "sport_id": 1,
        "user": "sam",
        "value": 18,
        "workout_date": "Sun, 07 Jul 2019 08:00:00 GMT",
        "workout_id": "hvYBqYBRa7wwXpaStWR4V2"
      },
      {
        "id": 13,
        "record_type": "HA",
        "sport_id": 1,
        "user": "Sam",
        "value": 43.97,
        "workout_date": "Sun, 07 Jul 2019 08:00:00 GMT",
        "workout_id": "hvYBqYBRa7wwXpaStWR4V2"
      },
      {
        "id": 11,
        "record_type": "LD",
        "sport_id": 1,
        "user": "sam",
        "value": "1:01:00",
        "workout_date": "Sun, 07 Jul 2019 08:00:00 GMT",
        "workout_id": "hvYBqYBRa7wwXpaStWR4V2"
      },
      {
        "id": 12,
        "record_type": "MS",
        "sport_id": 1,
        "user": "sam",
        "value": 18,
        "workout_date": "Sun, 07 Jul 2019 08:00:00 GMT",
        "workout_id": "hvYBqYBRa7wwXpaStWR4V2"
      }
    ],
    "sports_list": [
        1,
        4,
        6
    ],
    "start_elevation_at_zero": false,
    "timezone": "Europe/Paris",
    "total_ascent": 720.35,
    "total_distance": 67.895,
    "total_duration": "6:50:27",
    "use_raw_gpx_speed": false,
    "username": "sam"
    "weekm": true,
  },
  "message": "user account updated",
  "status": "success"
}
Objet JSON de requête:
  • email (string) – adresse électronique de l’utilisateur

  • password (string) – mot de passe actuel de l’utilisateur

  • new_password (string) – nouveau mot de passe de l’utilisateur

En-têtes de requête:
Codes d’état:
  • 200 OKuser account updated

  • 400 Bad Request

    • invalid payload

    • email is missing

    • current password is missing

    • email: valid email must be provided

    • password: 8 characters required

  • 401 Unauthorized

    • provide a valid auth token

    • signature expired, please log in again

    • invalid token, please log in again

    • invalid credentials

  • 500 Internal Server Errorerror, please try again or contact the administrator

POST /api/auth/password/update#

Mise à jour du mot de passe de l’utilisateur après une demande de réinitialisation du mot de passe.

Uniquement si l’envoi est activé.

Exemple de requête:

POST /api/auth/password/update HTTP/1.1
Content-Type: application/json

Exemple de réponse:

HTTP/1.1 200 OK
Content-Type: application/json

{
  "message": "password updated",
  "status": "success"
}
Objet JSON de requête:
  • password (string) – mot de passe (8 caractères minimum)

  • token (string) – jeton de réinitialisation du mot de passe

Codes d’état:
POST /api/auth/email/update#

Mise à jour de l’adresse électronique de l’utilisateur après confirmation.

Exemple de requête:

POST /api/auth/email/update HTTP/1.1
Content-Type: application/json

Exemple de réponse:

HTTP/1.1 200 OK
Content-Type: application/json

{
  "message": "email updated",
  "status": "success"
}
Objet JSON de requête:
  • token (string) – jeton de réinitialisation du mot de passe

Codes d’état:
POST /api/auth/logout#

Déconnexion de l’utilisateur. Si un jeton valide est fourni, il sera invalidé.

Exemple de requête:

POST /api/auth/logout HTTP/1.1
Content-Type: application/json

Exemple de réponse:

  • déconnexion avec succès :

HTTP/1.1 200 OK
Content-Type: application/json

{
  "message": "successfully logged out",
  "status": "success"
}
  • erreur lors de la déconnexion :

HTTP/1.1 401 UNAUTHORIZED
Content-Type: application/json

{
  "message": "provide a valid auth token",
  "status": "error"
}
En-têtes de requête:
Codes d’état:
POST /api/auth/account/privacy-policy#

L’utilisateur authentifié accepte la politique de confidentialité.

Exemple de requête:

POST /auth/account/privacy-policy HTTP/1.1
Content-Type: application/json

Exemple de réponse:

HTTP/1.1 200 OK
Content-Type: application/json

{
  "status": "success"
}
Objet JSON de requête:
  • accepted_policy (boolean) – true if user accepted privacy policy

En-têtes de requête:
Codes d’état:
GET /api/auth/account/export#

Obtenir l’archive de l’export de données pour l’utilisateur authentifié si une demande existe.

Il renvoie :

  • date de création de l’export

  • état de l’export (in_progress, successful and errored)

  • nom du fichier et sa taille (en octets) lorsque l’export est réussi

Exemple de requête:

GET /auth/account/export HTTP/1.1
Content-Type: application/json

Exemple de réponse:

  • si une requête existe

HTTP/1.1 200 OK
Content-Type: application/json

{
  "status": "success",
  "request": {
      "created_at": "Wed, 01 Mar 2023 12:31:17 GMT",
      "status": "successful",
      "file_name": "archive_rgjsR3fHt295ywNQr5Yp.zip",
      "file_size": 924
  }
}
  • if no request:

HTTP/1.1 200 OK
Content-Type: application/json

{
  "status": "success",
  "request": null
}
En-têtes de requête:
Codes d’état:
  • 200 OKsuccess

  • 401 Unauthorized

    • provide a valid auth token

    • signature expired, please log in again

    • invalid token, please log in again

POST /api/auth/account/export/request#

Demande d’export de données pour un utilisateur authentifié.

Exemple de requête:

POST /auth/account/export/request HTTP/1.1
Content-Type: application/json

Exemple de réponse:

HTTP/1.1 200 OK
Content-Type: application/json

{
  "status": "success",
  "request": {
      "created_at": "Wed, 01 Mar 2023 12:31:17 GMT",
      "status": "in_progress",
      "file_name": null,
      "file_size": null
  }
}
En-têtes de requête:
Codes d’état:
GET /api/auth/account/export/(string: file_name)#

Télécharger une archive d’export de données

Exemple de requête:

GET /auth/account/export/download/archive_rgjsR3fHr5Yp.zip HTTP/1.1
Content-Type: application/json

Exemple de réponse:

HTTP/1.1 200 OK
Content-Type: application/x-gzip
Paramètres:
  • file_name (string) – nom du fichier

En-têtes de requête:
Codes d’état:
  • 200 OKsuccess

  • 401 Unauthorized

    • provide a valid auth token

    • signature expired, please log in again

    • invalid token, please log in again

  • 404 Not Foundfile not found