2020-12-30 11:12:35 +01:00
<!DOCTYPE html>
2022-06-22 20:22:26 +02:00
< html lang = "en" >
2020-12-30 11:12:35 +01:00
< head >
< meta charset = "utf-8" / >
2022-07-27 11:10:29 +02:00
< meta name = "viewport" content = "width=device-width, initial-scale=1.0" / > < meta name = "generator" content = "Docutils 0.19: https://docutils.sourceforge.io/" / >
2021-11-03 12:41:23 +01:00
2023-02-16 11:18:50 +01:00
< title > Authentication — FitTrackee 0.7.12
2020-12-30 11:12:35 +01:00
documentation< / title >
2021-11-06 21:26:02 +01:00
< link rel = "stylesheet" type = "text/css" href = "../_static/pygments.css" / >
< link rel = "stylesheet" type = "text/css" href = "../_static/bootstrap-sphinx.css" / >
2022-11-27 12:06:42 +01:00
< link rel = "stylesheet" type = "text/css" href = "../_static/css/fork-awesome.min.css" / >
< link rel = "stylesheet" type = "text/css" href = "../_static/css/custom.css" / >
2021-11-06 21:26:02 +01:00
< script data-url_root = "../" id = "documentation_options" src = "../_static/documentation_options.js" > < / script >
2020-12-30 11:12:35 +01:00
< script src = "../_static/jquery.js" > < / script >
< script src = "../_static/underscore.js" > < / script >
2022-06-22 20:22:26 +02:00
< script src = "../_static/_sphinx_javascript_frameworks_compat.js" > < / script >
2020-12-30 11:12:35 +01:00
< script src = "../_static/doctools.js" > < / script >
2022-11-01 19:58:12 +01:00
< script src = "../_static/sphinx_highlight.js" > < / script >
2020-12-30 11:12:35 +01:00
< link rel = "index" title = "Index" href = "../genindex.html" / >
< link rel = "search" title = "Search" href = "../search.html" / >
< link rel = "next" title = "Configuration" href = "configuration.html" / >
2021-01-10 11:16:43 +01:00
< link rel = "prev" title = "API documentation" href = "index.html" / >
2020-12-30 11:12:35 +01:00
< meta charset = 'utf-8' >
< meta http-equiv = 'X-UA-Compatible' content = 'IE=edge,chrome=1' >
< meta name = 'viewport' content = 'width=device-width, initial-scale=1.0, maximum-scale=1' >
< meta name = "apple-mobile-web-app-capable" content = "yes" >
2022-02-05 22:09:17 +01:00
< script type = "text/javascript" src = "../_static/js/jquery-1.12.4.min.js" > < / script >
< script type = "text/javascript" src = "../_static/js/jquery-fix.js" > < / script >
< script type = "text/javascript" src = "../_static/bootstrap-3.4.1/js/bootstrap.min.js" > < / script >
< script type = "text/javascript" src = "../_static/bootstrap-sphinx.js" > < / script >
2020-12-30 11:12:35 +01:00
< / head > < body >
< div id = "navbar" class = "navbar navbar-default navbar-fixed-top" >
< div class = "container" >
< div class = "navbar-header" >
<!-- .btn - navbar is used as the toggle for collapsed navbar content -->
< button type = "button" class = "navbar-toggle" data-toggle = "collapse" data-target = ".nav-collapse" >
< span class = "icon-bar" > < / span >
< span class = "icon-bar" > < / span >
< span class = "icon-bar" > < / span >
< / button >
< a class = "navbar-brand" href = "../index.html" >
FitTrackee< / a >
2023-02-16 11:18:50 +01:00
< span class = "navbar-text navbar-version pull-left" > < b > 0.7.12
2020-12-30 11:12:35 +01:00
< / b > < / span >
< / div >
< div class = "collapse navbar-collapse nav-collapse" >
< ul class = "nav navbar-nav" >
< li > < a href = "https://github.com/SamR1/FitTrackee" > GitHub< / a > < / li >
< li class = "dropdown globaltoc-container" >
< a role = "button"
id="dLabelGlobalToc"
data-toggle="dropdown"
data-target="#"
href="../index.html">Docs < b class = "caret" > < / b > < / a >
< ul class = "dropdown-menu globaltoc"
role="menu"
aria-labelledby="dLabelGlobalToc">< ul class = "current" >
< li class = "toctree-l1" > < a class = "reference internal" href = "../features.html" > Features< / a > < / li >
2022-08-27 16:50:29 +02:00
< li class = "toctree-l1" > < a class = "reference internal" href = "../apps.html" > Third-party applications< / a > < / li >
2021-11-29 18:24:22 +01:00
< li class = "toctree-l1" > < a class = "reference internal" href = "../installation.html" > Installation< / a > < / li >
2022-04-24 13:17:38 +02:00
< li class = "toctree-l1" > < a class = "reference internal" href = "../cli.html" > Command line interface< / a > < / li >
2020-12-30 11:12:35 +01:00
< li class = "toctree-l1 current" > < a class = "reference internal" href = "index.html" > API documentation< / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "../troubleshooting/index.html" > Troubleshooting< / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "../changelog.html" > Change log< / a > < / li >
< / ul >
< / ul >
< / li >
< li class = "dropdown" >
< a role = "button"
id="dLabelLocalToc"
data-toggle="dropdown"
data-target="#"
href="#">Page < b class = "caret" > < / b > < / a >
< ul class = "dropdown-menu localtoc"
role="menu"
aria-labelledby="dLabelLocalToc">< ul >
< li > < a class = "reference internal" href = "#" > Authentication< / a > < / li >
< / ul >
< / ul >
< / li >
< li >
2021-01-10 11:16:43 +01:00
< a href = "index.html" title = "Previous Chapter: API documentation" > < span class = "glyphicon glyphicon-chevron-left visible-sm" > < / span > < span class = "hidden-sm hidden-tablet" > « API documentation< / span >
2020-12-30 11:12:35 +01:00
< / a >
< / li >
< li >
< a href = "configuration.html" title = "Next Chapter: Configuration" > < span class = "glyphicon glyphicon-chevron-right visible-sm" > < / span > < span class = "hidden-sm hidden-tablet" > Configuration » < / span >
< / a >
< / li >
< li class = "hidden-sm" >
< div id = "sourcelink" >
< a href = "../_sources/api/auth.rst.txt"
rel="nofollow">Source< / a >
< / div > < / li >
< / ul >
< form class = "navbar-form navbar-right" action = "../search.html" method = "get" >
< div class = "form-group" >
< input type = "text" name = "q" class = "form-control" placeholder = "Search" / >
< / div >
< input type = "hidden" name = "check_keywords" value = "yes" / >
< input type = "hidden" name = "area" value = "default" / >
< / form >
< / div >
< / div >
< / div >
< div class = "container" >
< div class = "row" >
< div class = "body col-md-12 content" role = "main" >
2021-11-06 21:26:02 +01:00
< section id = "authentication" >
2022-06-22 20:22:26 +02:00
< h1 > Authentication< a class = "headerlink" href = "#authentication" title = "Permalink to this heading" > ¶< / a > < / h1 >
2020-12-30 11:12:35 +01:00
< dl class = "http post" >
2021-11-06 21:26:02 +01:00
< dt class = "sig sig-object http" id = "post--api-auth-register" >
< span class = "sig-name descname" > < span class = "pre" > POST< / span > < / span > < span class = "sig-name descname" > < span class = "pre" > /api/auth/register< / span > < / span > < a class = "headerlink" href = "#post--api-auth-register" title = "Permalink to this definition" > ¶< / a > < / dt >
2022-08-27 16:50:29 +02:00
< dd > < p > Register a user and send confirmation email.< / p >
2022-03-26 20:30:37 +01:00
< p > The newly created account is inactive. The user must confirm his email
to activate it.< / p >
2020-12-30 11:12:35 +01:00
< p > < strong > Example request< / strong > :< / p >
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "nf" > POST< / span > < span class = "nn" > /api/auth/register< / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span >
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
< / pre > < / div >
< / div >
< p > < strong > Example responses< / strong > :< / p >
< ul class = "simple" >
2022-03-26 20:30:37 +01:00
< li > < p > success< / p > < / li >
2020-12-30 11:12:35 +01:00
< / ul >
2022-03-26 20:30:37 +01:00
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span > < span class = "m" > 200< / span > < span class = "ne" > SUCCESS< / span >
2020-12-30 11:12:35 +01:00
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
2023-02-16 11:18:50 +01:00
< span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " status" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " success" < / span >
< span class = "p" > }< / span >
2020-12-30 11:12:35 +01:00
< / pre > < / div >
< / div >
< ul class = "simple" >
< li > < p > error on registration< / p > < / li >
< / ul >
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span > < span class = "m" > 400< / span > < span class = "ne" > BAD REQUEST< / span >
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
2023-02-16 11:18:50 +01:00
< span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " message" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " Errors: email: valid email must be provided\n" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " status" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " error" < / span >
< span class = "p" > }< / span >
2020-12-30 11:12:35 +01:00
< / pre > < / div >
< / div >
< dl class = "field-list simple" >
2022-06-22 20:22:26 +02:00
< dt class = "field-odd" > Request JSON Object< span class = "colon" > :< / span > < / dt >
2020-12-30 11:12:35 +01:00
< dd class = "field-odd" > < ul class = "simple" >
2022-03-26 20:30:37 +01:00
< li > < p > < strong > username< / strong > (< em > string< / em > ) – < / p > < / li >
2020-12-30 11:12:35 +01:00
< li > < p > < strong > email< / strong > (< em > string< / em > ) – < / p > < / li >
< li > < p > < strong > password< / strong > (< em > string< / em > ) – < / p > < / li >
2022-07-03 17:27:43 +02:00
< li > < p > < strong > lang< / strong > (< em > string< / em > ) –
fallback to ‘ ’ < / p > < / li >
2020-12-30 11:12:35 +01:00
< / ul >
< / dd >
2022-06-22 20:22:26 +02:00
< dt class = "field-even" > Status Codes< span class = "colon" > :< / span > < / dt >
2020-12-30 11:12:35 +01:00
< dd class = "field-even" > < ul class = "simple" >
2022-03-26 20:30:37 +01:00
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1" > 200 OK< / a > < / span > – < / p > < / li >
2021-11-06 21:26:02 +01:00
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1" > 400 Bad Request< / a > < / span > – < ul >
2021-11-03 12:41:23 +01:00
< li > < p > invalid payload< / p > < / li >
2022-03-26 20:30:37 +01:00
< li > < p > sorry, that username is already taken< / p > < / li >
2020-12-30 11:12:35 +01:00
< li > < dl class = "simple" >
< dt > Errors:< / dt > < dd > < ul >
2022-03-26 20:30:37 +01:00
< li > < p > username: 3 to 30 characters required< / p > < / li >
< li > < p > username:
only alphanumeric characters and the underscore
character “_” allowed< / p > < / li >
2021-11-03 12:41:23 +01:00
< li > < p > email: valid email must be provided< / p > < / li >
< li > < p > password: 8 characters required< / p > < / li >
2020-12-30 11:12:35 +01:00
< / ul >
< / dd >
< / dl >
< / li >
< / ul >
< / p > < / li >
2021-11-06 21:26:02 +01:00
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.4" > 403 Forbidden< / a > < / span > – < / p > < / li >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1" > 500 Internal Server Error< / a > < / span > – < / p > < / li >
2020-12-30 11:12:35 +01:00
< / ul >
< / dd >
< / dl >
< / dd > < / dl >
< dl class = "http post" >
2022-03-26 20:30:37 +01:00
< dt class = "sig sig-object http" id = "post--api-auth-account-confirm" >
< span class = "sig-name descname" > < span class = "pre" > POST< / span > < / span > < span class = "sig-name descname" > < span class = "pre" > /api/auth/account/confirm< / span > < / span > < a class = "headerlink" href = "#post--api-auth-account-confirm" title = "Permalink to this definition" > ¶< / a > < / dt >
2022-08-27 16:50:29 +02:00
< dd > < p > Activate user account after registration.< / p >
2020-12-30 11:12:35 +01:00
< p > < strong > Example request< / strong > :< / p >
2022-03-26 20:30:37 +01:00
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "nf" > POST< / span > < span class = "nn" > /api/auth/account/confirm< / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span >
2020-12-30 11:12:35 +01:00
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
< / pre > < / div >
< / div >
2022-03-26 20:30:37 +01:00
< p > < strong > Example response< / strong > :< / p >
2020-12-30 11:12:35 +01:00
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span > < span class = "m" > 200< / span > < span class = "ne" > OK< / span >
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
2023-02-16 11:18:50 +01:00
< span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " auth_token" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " JSON Web Token" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " message" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " account confirmation successful" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " status" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " success" < / span >
< span class = "p" > }< / span >
2020-12-30 11:12:35 +01:00
< / pre > < / div >
< / div >
2022-03-26 20:30:37 +01:00
< dl class = "field-list simple" >
2022-06-22 20:22:26 +02:00
< dt class = "field-odd" > Request JSON Object< span class = "colon" > :< / span > < / dt >
2022-03-26 20:30:37 +01:00
< dd class = "field-odd" > < ul class = "simple" >
< li > < p > < strong > token< / strong > (< em > string< / em > ) – < / p > < / li >
2020-12-30 11:12:35 +01:00
< / ul >
2022-03-26 20:30:37 +01:00
< / dd >
2022-06-22 20:22:26 +02:00
< dt class = "field-even" > Status Codes< span class = "colon" > :< / span > < / dt >
2022-03-26 20:30:37 +01:00
< dd class = "field-even" > < ul class = "simple" >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1" > 200 OK< / a > < / span > – < / p > < / li >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1" > 400 Bad Request< / a > < / span > – < / p > < / li >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1" > 500 Internal Server Error< / a > < / span > – < / p > < / li >
< / ul >
< / dd >
< / dl >
< / dd > < / dl >
< dl class = "http post" >
< dt class = "sig sig-object http" id = "post--api-auth-account-resend-confirmation" >
< span class = "sig-name descname" > < span class = "pre" > POST< / span > < / span > < span class = "sig-name descname" > < span class = "pre" > /api/auth/account/resend-confirmation< / span > < / span > < a class = "headerlink" href = "#post--api-auth-account-resend-confirmation" title = "Permalink to this definition" > ¶< / a > < / dt >
2022-08-27 16:50:29 +02:00
< dd > < p > Resend email with instructions to confirm account.< / p >
< p > If email sending is disabled, this endpoint is not available.< / p >
2022-03-26 20:30:37 +01:00
< p > < strong > Example request< / strong > :< / p >
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "nf" > POST< / span > < span class = "nn" > /api/auth/account/resend-confirmation< / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span >
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
< / pre > < / div >
< / div >
< p > < strong > Example response< / strong > :< / p >
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span > < span class = "m" > 200< / span > < span class = "ne" > OK< / span >
2020-12-30 11:12:35 +01:00
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
2023-02-16 11:18:50 +01:00
< span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " message" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " confirmation email resent" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " status" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " success" < / span >
< span class = "p" > }< / span >
2020-12-30 11:12:35 +01:00
< / pre > < / div >
< / div >
< dl class = "field-list simple" >
2022-06-22 20:22:26 +02:00
< dt class = "field-odd" > Request JSON Object< span class = "colon" > :< / span > < / dt >
2020-12-30 11:12:35 +01:00
< dd class = "field-odd" > < ul class = "simple" >
< li > < p > < strong > email< / strong > (< em > string< / em > ) – < / p > < / li >
< / ul >
< / dd >
2022-06-22 20:22:26 +02:00
< dt class = "field-even" > Status Codes< span class = "colon" > :< / span > < / dt >
2020-12-30 11:12:35 +01:00
< dd class = "field-even" > < ul class = "simple" >
2022-03-26 20:30:37 +01:00
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1" > 200 OK< / a > < / span > – < / p > < / li >
2021-11-06 21:26:02 +01:00
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1" > 400 Bad Request< / a > < / span > – < / p > < / li >
2022-04-24 13:17:38 +02:00
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.5" > 404 Not Found< / a > < / span > – < / p > < / li >
2021-11-06 21:26:02 +01:00
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1" > 500 Internal Server Error< / a > < / span > – < / p > < / li >
2020-12-30 11:12:35 +01:00
< / ul >
< / dd >
< / dl >
< / dd > < / dl >
2022-03-26 20:30:37 +01:00
< dl class = "http post" >
< dt class = "sig sig-object http" id = "post--api-auth-login" >
< span class = "sig-name descname" > < span class = "pre" > POST< / span > < / span > < span class = "sig-name descname" > < span class = "pre" > /api/auth/login< / span > < / span > < a class = "headerlink" href = "#post--api-auth-login" title = "Permalink to this definition" > ¶< / a > < / dt >
2022-08-27 16:50:29 +02:00
< dd > < p > User login.< / p >
2022-03-26 20:30:37 +01:00
< p > Only user with an active account can log in.< / p >
2020-12-30 11:12:35 +01:00
< p > < strong > Example request< / strong > :< / p >
2022-03-26 20:30:37 +01:00
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "nf" > POST< / span > < span class = "nn" > /api/auth/login< / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span >
2020-12-30 11:12:35 +01:00
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
< / pre > < / div >
< / div >
< p > < strong > Example responses< / strong > :< / p >
< ul class = "simple" >
2022-03-26 20:30:37 +01:00
< li > < p > successful login< / p > < / li >
2020-12-30 11:12:35 +01:00
< / ul >
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span > < span class = "m" > 200< / span > < span class = "ne" > OK< / span >
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
2023-02-16 11:18:50 +01:00
< span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " auth_token" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " JSON Web Token" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " message" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " successfully logged in" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " status" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " success" < / span >
< span class = "p" > }< / span >
2020-12-30 11:12:35 +01:00
< / pre > < / div >
< / div >
< ul class = "simple" >
< li > < p > error on login< / p > < / li >
< / ul >
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span > < span class = "m" > 401< / span > < span class = "ne" > UNAUTHORIZED< / span >
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
2023-02-16 11:18:50 +01:00
< span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " message" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " invalid credentials" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " status" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " error" < / span >
< span class = "p" > }< / span >
2020-12-30 11:12:35 +01:00
< / pre > < / div >
< / div >
< dl class = "field-list simple" >
2022-06-22 20:22:26 +02:00
< dt class = "field-odd" > Request JSON Object< span class = "colon" > :< / span > < / dt >
2020-12-30 11:12:35 +01:00
< dd class = "field-odd" > < ul class = "simple" >
2022-03-26 20:30:37 +01:00
< li > < p > < strong > email< / strong > (< em > string< / em > ) – < / p > < / li >
< li > < p > < strong > password< / strong > (< em > string< / em > ) – < / p > < / li >
2020-12-30 11:12:35 +01:00
< / ul >
< / dd >
2022-06-22 20:22:26 +02:00
< dt class = "field-even" > Status Codes< span class = "colon" > :< / span > < / dt >
2020-12-30 11:12:35 +01:00
< dd class = "field-even" > < ul class = "simple" >
2022-03-26 20:30:37 +01:00
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1" > 200 OK< / a > < / span > – < / p > < / li >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1" > 400 Bad Request< / a > < / span > – < / p > < / li >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.2" > 401 Unauthorized< / a > < / span > – < / p > < / li >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1" > 500 Internal Server Error< / a > < / span > – < / p > < / li >
2020-12-30 11:12:35 +01:00
< / ul >
< / dd >
< / dl >
< / dd > < / dl >
< dl class = "http get" >
2021-11-06 21:26:02 +01:00
< dt class = "sig sig-object http" id = "get--api-auth-profile" >
< span class = "sig-name descname" > < span class = "pre" > GET< / span > < / span > < span class = "sig-name descname" > < span class = "pre" > /api/auth/profile< / span > < / span > < a class = "headerlink" href = "#get--api-auth-profile" title = "Permalink to this definition" > ¶< / a > < / dt >
2022-08-27 16:50:29 +02:00
< dd > < p > Get authenticated user info (profile, account, preferences).< / p >
< p > < strong > Scope< / strong > : < code class = "docutils literal notranslate" > < span class = "pre" > profile:read< / span > < / code > < / p >
2020-12-30 11:12:35 +01:00
< p > < strong > Example request< / strong > :< / p >
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "nf" > GET< / span > < span class = "nn" > /api/auth/profile< / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span >
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
< / pre > < / div >
< / div >
< p > < strong > Example response< / strong > :< / p >
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span > < span class = "m" > 200< / span > < span class = "ne" > OK< / span >
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
2023-02-16 11:18:50 +01:00
< span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " data" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " admin" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > false< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " bio" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > null< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " birth_date" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > null< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " created_at" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " Sun, 14 Jul 2019 14:09:58 GMT" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " display_ascent" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > true< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " email" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " sam@example.com" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " first_name" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > null< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " imperial_units" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > false< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " is_active" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > true< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " language" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " en" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " last_name" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > null< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " location" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > null< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " nb_sports" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 3< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " nb_workouts" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 6< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " picture" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > false< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " records" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "p" > [< / span >
< span class = "w" > < / span > < span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 9< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " record_type" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " AS" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " sport_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 1< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " user" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " sam" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " value" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 18< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_date" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " Sun, 07 Jul 2019 08:00:00 GMT" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " hvYBqYBRa7wwXpaStWR4V2" < / span >
< span class = "w" > < / span > < span class = "p" > },< / span >
< span class = "w" > < / span > < span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 10< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " record_type" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " FD" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " sport_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 1< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " user" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " sam" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " value" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 18< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_date" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " Sun, 07 Jul 2019 08:00:00 GMT" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " hvYBqYBRa7wwXpaStWR4V2" < / span >
< span class = "w" > < / span > < span class = "p" > },< / span >
< span class = "w" > < / span > < span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 13< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " record_type" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " HA" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " sport_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 1< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " user" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " Sam" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " value" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mf" > 43.97< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_date" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " Sun, 07 Jul 2019 08:00:00 GMT" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " hvYBqYBRa7wwXpaStWR4V2" < / span >
< span class = "w" > < / span > < span class = "p" > },< / span >
< span class = "w" > < / span > < span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 11< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " record_type" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " LD" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " sport_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 1< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " user" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " sam" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " value" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " 1:01:00" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_date" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " Sun, 07 Jul 2019 08:00:00 GMT" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " hvYBqYBRa7wwXpaStWR4V2" < / span >
< span class = "w" > < / span > < span class = "p" > },< / span >
< span class = "w" > < / span > < span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 12< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " record_type" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " MS" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " sport_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 1< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " user" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " sam" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " value" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 18< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_date" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " Sun, 07 Jul 2019 08:00:00 GMT" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " hvYBqYBRa7wwXpaStWR4V2" < / span >
< span class = "w" > < / span > < span class = "p" > }< / span >
< span class = "w" > < / span > < span class = "p" > ],< / span >
< span class = "w" > < / span > < span class = "nt" > " sports_list" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "p" > [< / span >
< span class = "w" > < / span > < span class = "mi" > 1< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "mi" > 4< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "mi" > 6< / span >
< span class = "w" > < / span > < span class = "p" > ],< / span >
< span class = "w" > < / span > < span class = "nt" > " timezone" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " Europe/Paris" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " total_distance" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mf" > 67.895< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " total_duration" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " 6:50:27" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " username" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " sam" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " weekm" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > false< / span >
< span class = "w" > < / span > < span class = "p" > },< / span >
< span class = "w" > < / span > < span class = "nt" > " status" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " success" < / span >
< span class = "p" > }< / span >
2020-12-30 11:12:35 +01:00
< / pre > < / div >
< / div >
< dl class = "field-list simple" >
2022-06-22 20:22:26 +02:00
< dt class = "field-odd" > Request Headers< span class = "colon" > :< / span > < / dt >
2020-12-30 11:12:35 +01:00
< dd class = "field-odd" > < ul class = "simple" >
2022-11-27 12:06:42 +01:00
< li > < p > < span > < a class = "reference external" href = "https://www.rfc-editor.org/rfc/rfc7235#section-4.2" > Authorization< / a > < / span > – < / p > < / li >
2020-12-30 11:12:35 +01:00
< / ul >
< / dd >
2022-06-22 20:22:26 +02:00
< dt class = "field-even" > Status Codes< span class = "colon" > :< / span > < / dt >
2020-12-30 11:12:35 +01:00
< dd class = "field-even" > < ul class = "simple" >
2021-11-06 21:26:02 +01:00
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1" > 200 OK< / a > < / span > – < / p > < / li >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.2" > 401 Unauthorized< / a > < / span > – < ul >
2021-11-03 12:41:23 +01:00
< li > < p > provide a valid auth token< / p > < / li >
< li > < p > signature expired, please log in again< / p > < / li >
< li > < p > invalid token, please log in again< / p > < / li >
2020-12-30 11:12:35 +01:00
< / ul >
< / p > < / li >
< / ul >
< / dd >
< / dl >
< / dd > < / dl >
< dl class = "http post" >
2021-11-06 21:26:02 +01:00
< dt class = "sig sig-object http" id = "post--api-auth-profile-edit" >
< span class = "sig-name descname" > < span class = "pre" > POST< / span > < / span > < span class = "sig-name descname" > < span class = "pre" > /api/auth/profile/edit< / span > < / span > < a class = "headerlink" href = "#post--api-auth-profile-edit" title = "Permalink to this definition" > ¶< / a > < / dt >
2022-08-27 16:50:29 +02:00
< dd > < p > Edit authenticated user profile.< / p >
< p > < strong > Scope< / strong > : < code class = "docutils literal notranslate" > < span class = "pre" > profile:write< / span > < / code > < / p >
2020-12-30 11:12:35 +01:00
< p > < strong > Example request< / strong > :< / p >
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "nf" > POST< / span > < span class = "nn" > /api/auth/profile/edit< / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span >
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
< / pre > < / div >
< / div >
< p > < strong > Example response< / strong > :< / p >
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span > < span class = "m" > 200< / span > < span class = "ne" > OK< / span >
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
2023-02-16 11:18:50 +01:00
< span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " data" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " admin" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > false< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " bio" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > null< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " birth_date" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > null< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " created_at" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " Sun, 14 Jul 2019 14:09:58 GMT" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " display_ascent" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > true< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " email" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " sam@example.com" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " first_name" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > null< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " imperial_units" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > false< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " is_active" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > true< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " language" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " en" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " last_name" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > null< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " location" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > null< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " nb_sports" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 3< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " nb_workouts" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 6< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " picture" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > false< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " records" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "p" > [< / span >
< span class = "w" > < / span > < span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 9< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " record_type" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " AS" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " sport_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 1< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " user" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " sam" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " value" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 18< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_date" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " Sun, 07 Jul 2019 08:00:00 GMT" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " hvYBqYBRa7wwXpaStWR4V2" < / span >
< span class = "w" > < / span > < span class = "p" > },< / span >
< span class = "w" > < / span > < span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 10< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " record_type" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " FD" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " sport_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 1< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " user" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " sam" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " value" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 18< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_date" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " Sun, 07 Jul 2019 08:00:00 GMT" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " hvYBqYBRa7wwXpaStWR4V2" < / span >
< span class = "w" > < / span > < span class = "p" > },< / span >
< span class = "w" > < / span > < span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 13< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " record_type" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " HA" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " sport_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 1< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " user" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " Sam" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " value" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mf" > 43.97< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_date" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " Sun, 07 Jul 2019 08:00:00 GMT" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " hvYBqYBRa7wwXpaStWR4V2" < / span >
< span class = "w" > < / span > < span class = "p" > },< / span >
< span class = "w" > < / span > < span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 11< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " record_type" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " LD" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " sport_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 1< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " user" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " sam" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " value" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " 1:01:00" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_date" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " Sun, 07 Jul 2019 08:00:00 GMT" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " hvYBqYBRa7wwXpaStWR4V2" < / span >
< span class = "w" > < / span > < span class = "p" > },< / span >
< span class = "w" > < / span > < span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 12< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " record_type" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " MS" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " sport_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 1< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " user" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " sam" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " value" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 18< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_date" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " Sun, 07 Jul 2019 08:00:00 GMT" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " hvYBqYBRa7wwXpaStWR4V2" < / span >
< span class = "w" > < / span > < span class = "p" > }< / span >
< span class = "w" > < / span > < span class = "p" > ],< / span >
< span class = "w" > < / span > < span class = "nt" > " sports_list" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "p" > [< / span >
< span class = "w" > < / span > < span class = "mi" > 1< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "mi" > 4< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "mi" > 6< / span >
< span class = "w" > < / span > < span class = "p" > ],< / span >
< span class = "w" > < / span > < span class = "nt" > " timezone" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " Europe/Paris" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " total_distance" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mf" > 67.895< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " total_duration" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " 6:50:27" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " username" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "nt" > " sam" < / span >
< span class = "w" > < / span > < span class = "nt" > " weekm" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > true< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "p" > },< / span >
< span class = "w" > < / span > < span class = "nt" > " message" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " user profile updated" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " status" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " success" < / span >
< span class = "p" > }< / span >
2020-12-30 11:12:35 +01:00
< / pre > < / div >
< / div >
< dl class = "field-list simple" >
2022-06-22 20:22:26 +02:00
< dt class = "field-odd" > Request JSON Object< span class = "colon" > :< / span > < / dt >
2020-12-30 11:12:35 +01:00
< dd class = "field-odd" > < ul class = "simple" >
< li > < p > < strong > first_name< / strong > (< em > string< / em > ) – < / p > < / li >
< li > < p > < strong > last_name< / strong > (< em > string< / em > ) – < / p > < / li >
< li > < p > < strong > location< / strong > (< em > string< / em > ) – < / p > < / li >
< li > < p > < strong > bio< / strong > (< em > string< / em > ) – < / p > < / li >
< li > < p > < strong > birth_date< / strong > (< em > string< / em > ) – < code class = "docutils literal notranslate" > < span class = "pre" > %Y-%m-%d< / span > < / code > )< / p > < / li >
< / ul >
< / dd >
2022-06-22 20:22:26 +02:00
< dt class = "field-even" > Request Headers< span class = "colon" > :< / span > < / dt >
2020-12-30 11:12:35 +01:00
< dd class = "field-even" > < ul class = "simple" >
2022-11-27 12:06:42 +01:00
< li > < p > < span > < a class = "reference external" href = "https://www.rfc-editor.org/rfc/rfc7235#section-4.2" > Authorization< / a > < / span > – < / p > < / li >
2020-12-30 11:12:35 +01:00
< / ul >
< / dd >
2022-06-22 20:22:26 +02:00
< dt class = "field-odd" > Status Codes< span class = "colon" > :< / span > < / dt >
2020-12-30 11:12:35 +01:00
< dd class = "field-odd" > < ul class = "simple" >
2021-11-06 21:26:02 +01:00
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1" > 200 OK< / a > < / span > – < / p > < / li >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1" > 400 Bad Request< / a > < / span > – < ul >
2021-11-03 12:41:23 +01:00
< li > < p > invalid payload< / p > < / li >
2020-12-30 11:12:35 +01:00
< / ul >
< / p > < / li >
2021-11-06 21:26:02 +01:00
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.2" > 401 Unauthorized< / a > < / span > – < ul >
2021-11-12 12:22:07 +01:00
< li > < p > provide a valid auth token< / p > < / li >
< li > < p > signature expired, please log in again< / p > < / li >
< li > < p > invalid token, please log in again< / p > < / li >
< / ul >
< / p > < / li >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1" > 500 Internal Server Error< / a > < / span > – < / p > < / li >
< / ul >
< / dd >
< / dl >
< / dd > < / dl >
< dl class = "http post" >
< dt class = "sig sig-object http" id = "post--api-auth-profile-edit-preferences" >
< span class = "sig-name descname" > < span class = "pre" > POST< / span > < / span > < span class = "sig-name descname" > < span class = "pre" > /api/auth/profile/edit/preferences< / span > < / span > < a class = "headerlink" href = "#post--api-auth-profile-edit-preferences" title = "Permalink to this definition" > ¶< / a > < / dt >
2022-08-27 16:50:29 +02:00
< dd > < p > Edit authenticated user preferences.< / p >
2022-11-01 19:58:12 +01:00
< p > Supported date formats:< / p >
< ul class = "simple" >
< li > < p > < code class = "docutils literal notranslate" > < span class = "pre" > MM/dd/yyyy< / span > < / code > (default value)< / p > < / li >
< li > < p > < code class = "docutils literal notranslate" > < span class = "pre" > dd/MM/yyyy< / span > < / code > < / p > < / li >
< li > < p > < code class = "docutils literal notranslate" > < span class = "pre" > yyyy-MM-dd< / span > < / code > < / p > < / li >
< li > < p > < code class = "docutils literal notranslate" > < span class = "pre" > date_string< / span > < / code > , corresponding on client to:< / p >
< ul >
< li > < p > < code class = "docutils literal notranslate" > < span class = "pre" > MMM.< / span > < span class = "pre" > do,< / span > < span class = "pre" > yyyy< / span > < / code > for < code class = "docutils literal notranslate" > < span class = "pre" > en< / span > < / code > locale< / p > < / li >
< li > < p > < code class = "docutils literal notranslate" > < span class = "pre" > d< / span > < span class = "pre" > MMM< / span > < span class = "pre" > yyyy< / span > < / code > for < code class = "docutils literal notranslate" > < span class = "pre" > fr< / span > < / code > locale< / p > < / li >
< li > < p > < code class = "docutils literal notranslate" > < span class = "pre" > do< / span > < span class = "pre" > MMM< / span > < span class = "pre" > yyyy< / span > < / code > for < code class = "docutils literal notranslate" > < span class = "pre" > de< / span > < / code > locale< / p > < / li >
< / ul >
< / li >
< / ul >
2022-08-27 16:50:29 +02:00
< p > < strong > Scope< / strong > : < code class = "docutils literal notranslate" > < span class = "pre" > profile:write< / span > < / code > < / p >
2021-11-12 12:22:07 +01:00
< p > < strong > Example request< / strong > :< / p >
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "nf" > POST< / span > < span class = "nn" > /api/auth/profile/edit/preferences< / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span >
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
< / pre > < / div >
< / div >
< p > < strong > Example response< / strong > :< / p >
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span > < span class = "m" > 200< / span > < span class = "ne" > OK< / span >
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
2023-02-16 11:18:50 +01:00
< span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " data" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " admin" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > false< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " bio" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > null< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " birth_date" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > null< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " created_at" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " Sun, 14 Jul 2019 14:09:58 GMT" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " date_format" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " MM/dd/yyyy" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " display_ascent" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > true< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " email" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " sam@example.com" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " first_name" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > null< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " imperial_units" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > false< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " is_active" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > true< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " language" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " en" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " last_name" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > null< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " location" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > null< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " nb_sports" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 3< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " nb_workouts" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 6< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " picture" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > false< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " records" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "p" > [< / span >
< span class = "w" > < / span > < span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 9< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " record_type" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " AS" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " sport_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 1< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " user" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " sam" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " value" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 18< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_date" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " Sun, 07 Jul 2019 08:00:00 GMT" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " hvYBqYBRa7wwXpaStWR4V2" < / span >
< span class = "w" > < / span > < span class = "p" > },< / span >
< span class = "w" > < / span > < span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 10< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " record_type" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " FD" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " sport_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 1< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " user" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " sam" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " value" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 18< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_date" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " Sun, 07 Jul 2019 08:00:00 GMT" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " hvYBqYBRa7wwXpaStWR4V2" < / span >
< span class = "w" > < / span > < span class = "p" > },< / span >
< span class = "w" > < / span > < span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 13< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " record_type" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " HA" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " sport_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 1< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " user" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " Sam" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " value" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mf" > 43.97< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_date" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " Sun, 07 Jul 2019 08:00:00 GMT" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " hvYBqYBRa7wwXpaStWR4V2" < / span >
< span class = "w" > < / span > < span class = "p" > },< / span >
< span class = "w" > < / span > < span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 11< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " record_type" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " LD" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " sport_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 1< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " user" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " sam" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " value" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " 1:01:00" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_date" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " Sun, 07 Jul 2019 08:00:00 GMT" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " hvYBqYBRa7wwXpaStWR4V2" < / span >
< span class = "w" > < / span > < span class = "p" > },< / span >
< span class = "w" > < / span > < span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 12< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " record_type" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " MS" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " sport_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 1< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " user" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " sam" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " value" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 18< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_date" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " Sun, 07 Jul 2019 08:00:00 GMT" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " hvYBqYBRa7wwXpaStWR4V2" < / span >
< span class = "w" > < / span > < span class = "p" > }< / span >
< span class = "w" > < / span > < span class = "p" > ],< / span >
< span class = "w" > < / span > < span class = "nt" > " sports_list" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "p" > [< / span >
< span class = "w" > < / span > < span class = "mi" > 1< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "mi" > 4< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "mi" > 6< / span >
< span class = "w" > < / span > < span class = "p" > ],< / span >
< span class = "w" > < / span > < span class = "nt" > " timezone" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " Europe/Paris" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " total_distance" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mf" > 67.895< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " total_duration" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " 6:50:27" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " username" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "nt" > " sam" < / span >
< span class = "w" > < / span > < span class = "nt" > " weekm" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > true< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "p" > },< / span >
< span class = "w" > < / span > < span class = "nt" > " message" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " user preferences updated" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " status" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " success" < / span >
< span class = "p" > }< / span >
2021-11-12 12:22:07 +01:00
< / pre > < / div >
< / div >
< dl class = "field-list simple" >
2022-06-22 20:22:26 +02:00
< dt class = "field-odd" > Request JSON Object< span class = "colon" > :< / span > < / dt >
2021-11-12 12:22:07 +01:00
< dd class = "field-odd" > < ul class = "simple" >
2022-11-01 19:58:12 +01:00
< li > < p > < strong > date_format< / strong > (< em > string< / em > ) – < / p > < / li >
2022-07-23 18:19:40 +02:00
< li > < p > < strong > display_ascent< / strong > (< em > boolean< / em > ) – < / p > < / li >
2022-07-23 17:24:31 +02:00
< li > < p > < strong > imperial_units< / strong > (< em > boolean< / em > ) – < / p > < / li >
< li > < p > < strong > language< / strong > (< em > string< / em > ) – < / p > < / li >
2021-11-12 12:22:07 +01:00
< li > < p > < strong > timezone< / strong > (< em > string< / em > ) – < / p > < / li >
2022-04-03 19:47:40 +02:00
< li > < p > < strong > weekm< / strong > (< em > boolean< / em > ) – < / p > < / li >
2021-11-12 12:22:07 +01:00
< / ul >
< / dd >
2022-06-22 20:22:26 +02:00
< dt class = "field-even" > Request Headers< span class = "colon" > :< / span > < / dt >
2021-11-12 12:22:07 +01:00
< dd class = "field-even" > < ul class = "simple" >
2022-11-27 12:06:42 +01:00
< li > < p > < span > < a class = "reference external" href = "https://www.rfc-editor.org/rfc/rfc7235#section-4.2" > Authorization< / a > < / span > – < / p > < / li >
2021-11-12 12:22:07 +01:00
< / ul >
< / dd >
2022-06-22 20:22:26 +02:00
< dt class = "field-odd" > Status Codes< span class = "colon" > :< / span > < / dt >
2021-11-12 12:22:07 +01:00
< dd class = "field-odd" > < ul class = "simple" >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1" > 200 OK< / a > < / span > – < / p > < / li >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1" > 400 Bad Request< / a > < / span > – < ul >
< li > < p > invalid payload< / p > < / li >
< li > < p > password: password and password confirmation don’ < / p > < / li >
< / ul >
< / p > < / li >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.2" > 401 Unauthorized< / a > < / span > – < ul >
< li > < p > provide a valid auth token< / p > < / li >
< li > < p > signature expired, please log in again< / p > < / li >
< li > < p > invalid token, please log in again< / p > < / li >
< / ul >
< / p > < / li >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1" > 500 Internal Server Error< / a > < / span > – < / p > < / li >
< / ul >
< / dd >
< / dl >
< / dd > < / dl >
< dl class = "http post" >
< dt class = "sig sig-object http" id = "post--api-auth-profile-edit-sports" >
< span class = "sig-name descname" > < span class = "pre" > POST< / span > < / span > < span class = "sig-name descname" > < span class = "pre" > /api/auth/profile/edit/sports< / span > < / span > < a class = "headerlink" href = "#post--api-auth-profile-edit-sports" title = "Permalink to this definition" > ¶< / a > < / dt >
2022-08-27 16:50:29 +02:00
< dd > < p > Edit authenticated user sport preferences.< / p >
< p > < strong > Scope< / strong > : < code class = "docutils literal notranslate" > < span class = "pre" > profile:write< / span > < / code > < / p >
2021-11-12 12:22:07 +01:00
< p > < strong > Example request< / strong > :< / p >
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "nf" > POST< / span > < span class = "nn" > /api/auth/profile/edit/sports< / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span >
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
< / pre > < / div >
< / div >
< p > < strong > Example response< / strong > :< / p >
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span > < span class = "m" > 200< / span > < span class = "ne" > OK< / span >
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
2023-02-16 11:18:50 +01:00
< span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " data" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " color" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " #000000" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " is_active" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > true< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " sport_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 1< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " stopped_speed_threshold" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 1< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " user_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 1< / span >
< span class = "w" > < / span > < span class = "p" > },< / span >
< span class = "w" > < / span > < span class = "nt" > " message" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " user sport preferences updated" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " status" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " success" < / span >
< span class = "p" > }< / span >
2021-11-12 12:22:07 +01:00
< / pre > < / div >
< / div >
< dl class = "field-list simple" >
2022-06-22 20:22:26 +02:00
< dt class = "field-odd" > Request JSON Object< span class = "colon" > :< / span > < / dt >
2021-11-12 12:22:07 +01:00
< dd class = "field-odd" > < ul class = "simple" >
< li > < p > < strong > color< / strong > (< em > string< / em > ) – < / p > < / li >
< li > < p > < strong > is_active< / strong > (< em > boolean< / em > ) – < / p > < / li >
< li > < p > < strong > stopped_speed_threshold< / strong > (< em > float< / em > ) – < / p > < / li >
< / ul >
< / dd >
2022-06-22 20:22:26 +02:00
< dt class = "field-even" > Request Headers< span class = "colon" > :< / span > < / dt >
2021-11-12 12:22:07 +01:00
< dd class = "field-even" > < ul class = "simple" >
2022-11-27 12:06:42 +01:00
< li > < p > < span > < a class = "reference external" href = "https://www.rfc-editor.org/rfc/rfc7235#section-4.2" > Authorization< / a > < / span > – < / p > < / li >
2021-11-12 12:22:07 +01:00
< / ul >
< / dd >
2022-06-22 20:22:26 +02:00
< dt class = "field-odd" > Status Codes< span class = "colon" > :< / span > < / dt >
2021-11-12 12:22:07 +01:00
< dd class = "field-odd" > < ul class = "simple" >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1" > 200 OK< / a > < / span > – < / p > < / li >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1" > 400 Bad Request< / a > < / span > – < ul >
< li > < p > invalid payload< / p > < / li >
< li > < p > invalid hexadecimal color< / p > < / li >
< / ul >
< / p > < / li >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.2" > 401 Unauthorized< / a > < / span > – < ul >
2021-11-03 12:41:23 +01:00
< li > < p > provide a valid auth token< / p > < / li >
< li > < p > signature expired, please log in again< / p > < / li >
< li > < p > invalid token, please log in again< / p > < / li >
2020-12-30 11:12:35 +01:00
< / ul >
< / p > < / li >
2021-12-19 12:37:05 +01:00
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.5" > 404 Not Found< / a > < / span > – < ul >
< li > < p > sport does not exist< / p > < / li >
< / ul >
< / p > < / li >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1" > 500 Internal Server Error< / a > < / span > – < / p > < / li >
< / ul >
< / dd >
< / dl >
< / dd > < / dl >
< dl class = "http delete" >
< dt class = "sig sig-object http" id = "delete--api-auth-profile-reset-sports-(sport_id)" >
< span class = "sig-name descname" > < span class = "pre" > DELETE< / span > < / span > < span class = "sig-name descname" > < span class = "pre" > /api/auth/profile/reset/sports/< / span > < / span > < span class = "sig-paren" > (< / span > < em class = "sig-param" > < span class = "pre" > sport_id< / span > < / em > < span class = "sig-paren" > )< / span > < a class = "headerlink" href = "#delete--api-auth-profile-reset-sports-(sport_id)" title = "Permalink to this definition" > ¶< / a > < / dt >
2022-08-27 16:50:29 +02:00
< dd > < p > Reset authenticated user preferences for a given sport.< / p >
< p > < strong > Scope< / strong > : < code class = "docutils literal notranslate" > < span class = "pre" > profile:write< / span > < / code > < / p >
2021-12-19 12:37:05 +01:00
< p > < strong > Example request< / strong > :< / p >
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "nf" > DELETE< / span > < span class = "nn" > /api/auth/profile/reset/sports/1< / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span >
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
< / pre > < / div >
< / div >
< p > < strong > Example response< / strong > :< / p >
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span > < span class = "m" > 204< / span > < span class = "ne" > OK< / span >
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
< / pre > < / div >
< / div >
< dl class = "field-list simple" >
2022-06-22 20:22:26 +02:00
< dt class = "field-odd" > Parameters< span class = "colon" > :< / span > < / dt >
2021-12-19 12:37:05 +01:00
< dd class = "field-odd" > < ul class = "simple" >
< li > < p > < strong > sport_id< / strong > (< em > string< / em > ) – < / p > < / li >
< / ul >
< / dd >
2022-06-22 20:22:26 +02:00
< dt class = "field-even" > Request Headers< span class = "colon" > :< / span > < / dt >
2021-12-19 12:37:05 +01:00
< dd class = "field-even" > < ul class = "simple" >
2022-11-27 12:06:42 +01:00
< li > < p > < span > < a class = "reference external" href = "https://www.rfc-editor.org/rfc/rfc7235#section-4.2" > Authorization< / a > < / span > – < / p > < / li >
2021-12-19 12:37:05 +01:00
< / ul >
< / dd >
2022-06-22 20:22:26 +02:00
< dt class = "field-odd" > Status Codes< span class = "colon" > :< / span > < / dt >
2021-12-19 12:37:05 +01:00
< dd class = "field-odd" > < ul class = "simple" >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.5" > 204 No Content< / a > < / span > – < / p > < / li >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.2" > 401 Unauthorized< / a > < / span > – < ul >
< li > < p > provide a valid auth token< / p > < / li >
< li > < p > signature expired, please log in again< / p > < / li >
< li > < p > invalid token, please log in again< / p > < / li >
< / ul >
< / p > < / li >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.5" > 404 Not Found< / a > < / span > – < ul >
< li > < p > sport does not exist< / p > < / li >
< / ul >
< / p > < / li >
2021-11-06 21:26:02 +01:00
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1" > 500 Internal Server Error< / a > < / span > – < / p > < / li >
2020-12-30 11:12:35 +01:00
< / ul >
< / dd >
< / dl >
< / dd > < / dl >
< dl class = "http post" >
2021-11-06 21:26:02 +01:00
< dt class = "sig sig-object http" id = "post--api-auth-picture" >
< span class = "sig-name descname" > < span class = "pre" > POST< / span > < / span > < span class = "sig-name descname" > < span class = "pre" > /api/auth/picture< / span > < / span > < a class = "headerlink" href = "#post--api-auth-picture" title = "Permalink to this definition" > ¶< / a > < / dt >
2022-08-27 16:50:29 +02:00
< dd > < p > Update authenticated user picture.< / p >
< p > < strong > Scope< / strong > : < code class = "docutils literal notranslate" > < span class = "pre" > profile:write< / span > < / code > < / p >
2020-12-30 11:12:35 +01:00
< p > < strong > Example request< / strong > :< / p >
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "nf" > POST< / span > < span class = "nn" > /api/auth/picture< / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span >
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > multipart/form-data< / span >
< / pre > < / div >
< / div >
< p > < strong > Example response< / strong > :< / p >
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span > < span class = "m" > 200< / span > < span class = "ne" > OK< / span >
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
2023-02-16 11:18:50 +01:00
< span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " message" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " user picture updated" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " status" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " success" < / span >
< span class = "p" > }< / span >
2020-12-30 11:12:35 +01:00
< / pre > < / div >
< / div >
< dl class = "field-list simple" >
2022-06-22 20:22:26 +02:00
< dt class = "field-odd" > Form Parameters< span class = "colon" > :< / span > < / dt >
2020-12-30 11:12:35 +01:00
< dd class = "field-odd" > < ul class = "simple" >
< li > < p > < strong > file< / strong > – < / p > < / li >
< / ul >
< / dd >
2022-06-22 20:22:26 +02:00
< dt class = "field-even" > Request Headers< span class = "colon" > :< / span > < / dt >
2020-12-30 11:12:35 +01:00
< dd class = "field-even" > < ul class = "simple" >
2022-11-27 12:06:42 +01:00
< li > < p > < span > < a class = "reference external" href = "https://www.rfc-editor.org/rfc/rfc7235#section-4.2" > Authorization< / a > < / span > – < / p > < / li >
2020-12-30 11:12:35 +01:00
< / ul >
< / dd >
2022-06-22 20:22:26 +02:00
< dt class = "field-odd" > Status Codes< span class = "colon" > :< / span > < / dt >
2020-12-30 11:12:35 +01:00
< dd class = "field-odd" > < ul class = "simple" >
2021-11-06 21:26:02 +01:00
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1" > 200 OK< / a > < / span > – < / p > < / li >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1" > 400 Bad Request< / a > < / span > – < ul >
2021-11-03 12:41:23 +01:00
< li > < p > invalid payload< / p > < / li >
< li > < p > no file part< / p > < / li >
< li > < p > no selected file< / p > < / li >
< li > < p > file extension not allowed< / p > < / li >
2020-12-30 11:12:35 +01:00
< / ul >
< / p > < / li >
2021-11-06 21:26:02 +01:00
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.2" > 401 Unauthorized< / a > < / span > – < ul >
2021-11-03 12:41:23 +01:00
< li > < p > provide a valid auth token< / p > < / li >
< li > < p > signature expired, please log in again< / p > < / li >
< li > < p > invalid token, please log in again< / p > < / li >
2020-12-30 11:12:35 +01:00
< / ul >
< / p > < / li >
2021-11-06 21:26:02 +01:00
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.14" > 413 Request Entity Too Large< / a > < / span > – < / p > < / li >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1" > 500 Internal Server Error< / a > < / span > – < / p > < / li >
2020-12-30 11:12:35 +01:00
< / ul >
< / dd >
< / dl >
< / dd > < / dl >
< dl class = "http delete" >
2021-11-06 21:26:02 +01:00
< dt class = "sig sig-object http" id = "delete--api-auth-picture" >
< span class = "sig-name descname" > < span class = "pre" > DELETE< / span > < / span > < span class = "sig-name descname" > < span class = "pre" > /api/auth/picture< / span > < / span > < a class = "headerlink" href = "#delete--api-auth-picture" title = "Permalink to this definition" > ¶< / a > < / dt >
2022-08-27 16:50:29 +02:00
< dd > < p > Delete authenticated user picture.< / p >
< p > < strong > Scope< / strong > : < code class = "docutils literal notranslate" > < span class = "pre" > profile:write< / span > < / code > < / p >
2020-12-30 11:12:35 +01:00
< p > < strong > Example request< / strong > :< / p >
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "nf" > DELETE< / span > < span class = "nn" > /api/auth/picture< / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span >
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
< / pre > < / div >
< / div >
< p > < strong > Example response< / strong > :< / p >
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span > < span class = "m" > 204< / span > < span class = "ne" > NO CONTENT< / span >
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
< / pre > < / div >
< / div >
< dl class = "field-list simple" >
2022-06-22 20:22:26 +02:00
< dt class = "field-odd" > Request Headers< span class = "colon" > :< / span > < / dt >
2020-12-30 11:12:35 +01:00
< dd class = "field-odd" > < ul class = "simple" >
2022-11-27 12:06:42 +01:00
< li > < p > < span > < a class = "reference external" href = "https://www.rfc-editor.org/rfc/rfc7235#section-4.2" > Authorization< / a > < / span > – < / p > < / li >
2020-12-30 11:12:35 +01:00
< / ul >
< / dd >
2022-06-22 20:22:26 +02:00
< dt class = "field-even" > Status Codes< span class = "colon" > :< / span > < / dt >
2020-12-30 11:12:35 +01:00
< dd class = "field-even" > < ul class = "simple" >
2021-11-06 21:26:02 +01:00
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.5" > 204 No Content< / a > < / span > – < / p > < / li >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.2" > 401 Unauthorized< / a > < / span > – < ul >
2021-11-03 12:41:23 +01:00
< li > < p > provide a valid auth token< / p > < / li >
< li > < p > signature expired, please log in again< / p > < / li >
< li > < p > invalid token, please log in again< / p > < / li >
2020-12-30 11:12:35 +01:00
< / ul >
< / p > < / li >
2021-11-06 21:26:02 +01:00
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1" > 500 Internal Server Error< / a > < / span > – < / p > < / li >
2020-12-30 11:12:35 +01:00
< / ul >
< / dd >
< / dl >
< / dd > < / dl >
< dl class = "http post" >
2021-11-06 21:26:02 +01:00
< dt class = "sig sig-object http" id = "post--api-auth-password-reset-request" >
< span class = "sig-name descname" > < span class = "pre" > POST< / span > < / span > < span class = "sig-name descname" > < span class = "pre" > /api/auth/password/reset-request< / span > < / span > < a class = "headerlink" href = "#post--api-auth-password-reset-request" title = "Permalink to this definition" > ¶< / a > < / dt >
2022-08-27 16:50:29 +02:00
< dd > < p > Handle password reset request.< / p >
2022-04-24 13:17:38 +02:00
< p > If email sending is disabled, this endpoint is not available< / p >
2020-12-30 11:12:35 +01:00
< p > < strong > Example request< / strong > :< / p >
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "nf" > POST< / span > < span class = "nn" > /api/auth/password/reset-request< / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span >
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
< / pre > < / div >
< / div >
< p > < strong > Example response< / strong > :< / p >
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span > < span class = "m" > 200< / span > < span class = "ne" > OK< / span >
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
2023-02-16 11:18:50 +01:00
< span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " message" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " password reset request processed" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " status" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " success" < / span >
< span class = "p" > }< / span >
2020-12-30 11:12:35 +01:00
< / pre > < / div >
< / div >
< dl class = "field-list simple" >
2022-06-22 20:22:26 +02:00
< dt class = "field-odd" > Request JSON Object< span class = "colon" > :< / span > < / dt >
2020-12-30 11:12:35 +01:00
< dd class = "field-odd" > < ul class = "simple" >
< li > < p > < strong > email< / strong > (< em > string< / em > ) – < / p > < / li >
< / ul >
< / dd >
2022-06-22 20:22:26 +02:00
< dt class = "field-even" > Status Codes< span class = "colon" > :< / span > < / dt >
2020-12-30 11:12:35 +01:00
< dd class = "field-even" > < ul class = "simple" >
2021-11-06 21:26:02 +01:00
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1" > 200 OK< / a > < / span > – < / p > < / li >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1" > 400 Bad Request< / a > < / span > – < / p > < / li >
2022-04-24 13:17:38 +02:00
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.5" > 404 Not Found< / a > < / span > – < / p > < / li >
2020-12-30 11:12:35 +01:00
< / ul >
< / dd >
< / dl >
< / dd > < / dl >
2022-03-26 20:30:37 +01:00
< dl class = "http patch" >
< dt class = "sig sig-object http" id = "patch--api-auth-profile-edit-account" >
< span class = "sig-name descname" > < span class = "pre" > PATCH< / span > < / span > < span class = "sig-name descname" > < span class = "pre" > /api/auth/profile/edit/account< / span > < / span > < a class = "headerlink" href = "#patch--api-auth-profile-edit-account" title = "Permalink to this definition" > ¶< / a > < / dt >
2022-08-27 16:50:29 +02:00
< dd > < p > Update authenticated user email and password.< / p >
2022-04-24 13:17:38 +02:00
< p > It sends emails if sending is enabled:< / p >
2022-03-26 20:30:37 +01:00
< ul class = "simple" >
< li > < p > Password change< / p > < / li >
< li > < p > Email change:< / p >
< ul >
< li > < p > one to the current address to inform user< / p > < / li >
< li > < p > another one to the new address to confirm it.< / p > < / li >
< / ul >
< / li >
< / ul >
2022-08-27 16:50:29 +02:00
< p > < strong > Scope< / strong > : < code class = "docutils literal notranslate" > < span class = "pre" > profile:write< / span > < / code > < / p >
2022-03-26 20:30:37 +01:00
< p > < strong > Example request< / strong > :< / p >
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "nf" > PATCH< / span > < span class = "nn" > /api/auth/profile/edit/account< / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span >
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
< / pre > < / div >
< / div >
< p > < strong > Example response< / strong > :< / p >
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span > < span class = "m" > 200< / span > < span class = "ne" > OK< / span >
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
2023-02-16 11:18:50 +01:00
< span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " data" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " admin" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > false< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " bio" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > null< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " birth_date" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > null< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " created_at" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " Sun, 14 Jul 2019 14:09:58 GMT" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " display_ascent" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > true< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " email" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " sam@example.com" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " first_name" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > null< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " imperial_units" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > false< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " is_active" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > true< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " language" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " en" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " last_name" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > null< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " location" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > null< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " nb_sports" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 3< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " nb_workouts" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 6< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " picture" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > false< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " records" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "p" > [< / span >
< span class = "w" > < / span > < span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 9< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " record_type" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " AS" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " sport_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 1< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " user" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " sam" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " value" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 18< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_date" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " Sun, 07 Jul 2019 08:00:00 GMT" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " hvYBqYBRa7wwXpaStWR4V2" < / span >
< span class = "w" > < / span > < span class = "p" > },< / span >
< span class = "w" > < / span > < span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 10< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " record_type" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " FD" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " sport_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 1< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " user" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " sam" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " value" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 18< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_date" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " Sun, 07 Jul 2019 08:00:00 GMT" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " hvYBqYBRa7wwXpaStWR4V2" < / span >
< span class = "w" > < / span > < span class = "p" > },< / span >
< span class = "w" > < / span > < span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 13< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " record_type" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " HA" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " sport_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 1< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " user" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " Sam" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " value" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mf" > 43.97< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_date" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " Sun, 07 Jul 2019 08:00:00 GMT" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " hvYBqYBRa7wwXpaStWR4V2" < / span >
< span class = "w" > < / span > < span class = "p" > },< / span >
< span class = "w" > < / span > < span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 11< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " record_type" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " LD" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " sport_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 1< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " user" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " sam" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " value" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " 1:01:00" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_date" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " Sun, 07 Jul 2019 08:00:00 GMT" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " hvYBqYBRa7wwXpaStWR4V2" < / span >
< span class = "w" > < / span > < span class = "p" > },< / span >
< span class = "w" > < / span > < span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 12< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " record_type" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " MS" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " sport_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 1< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " user" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " sam" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " value" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mi" > 18< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_date" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " Sun, 07 Jul 2019 08:00:00 GMT" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " workout_id" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " hvYBqYBRa7wwXpaStWR4V2" < / span >
< span class = "w" > < / span > < span class = "p" > }< / span >
< span class = "w" > < / span > < span class = "p" > ],< / span >
< span class = "w" > < / span > < span class = "nt" > " sports_list" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "p" > [< / span >
< span class = "w" > < / span > < span class = "mi" > 1< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "mi" > 4< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "mi" > 6< / span >
< span class = "w" > < / span > < span class = "p" > ],< / span >
< span class = "w" > < / span > < span class = "nt" > " timezone" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " Europe/Paris" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " total_distance" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "mf" > 67.895< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " total_duration" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " 6:50:27" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " username" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "nt" > " sam" < / span >
< span class = "w" > < / span > < span class = "nt" > " weekm" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "kc" > true< / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "p" > },< / span >
< span class = "w" > < / span > < span class = "nt" > " message" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " user account updated" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " status" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " success" < / span >
< span class = "p" > }< / span >
2022-03-26 20:30:37 +01:00
< / pre > < / div >
< / div >
< dl class = "field-list simple" >
2022-06-22 20:22:26 +02:00
< dt class = "field-odd" > Request JSON Object< span class = "colon" > :< / span > < / dt >
2022-03-26 20:30:37 +01:00
< dd class = "field-odd" > < ul class = "simple" >
< li > < p > < strong > email< / strong > (< em > string< / em > ) – < / p > < / li >
< li > < p > < strong > password< / strong > (< em > string< / em > ) – < / p > < / li >
< li > < p > < strong > new_password< / strong > (< em > string< / em > ) – < / p > < / li >
< / ul >
< / dd >
2022-06-22 20:22:26 +02:00
< dt class = "field-even" > Request Headers< span class = "colon" > :< / span > < / dt >
2022-03-26 20:30:37 +01:00
< dd class = "field-even" > < ul class = "simple" >
2022-11-27 12:06:42 +01:00
< li > < p > < span > < a class = "reference external" href = "https://www.rfc-editor.org/rfc/rfc7235#section-4.2" > Authorization< / a > < / span > – < / p > < / li >
2022-03-26 20:30:37 +01:00
< / ul >
< / dd >
2022-06-22 20:22:26 +02:00
< dt class = "field-odd" > Status Codes< span class = "colon" > :< / span > < / dt >
2022-03-26 20:30:37 +01:00
< dd class = "field-odd" > < ul class = "simple" >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1" > 200 OK< / a > < / span > – < / p > < / li >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1" > 400 Bad Request< / a > < / span > – < ul >
< li > < p > invalid payload< / p > < / li >
< li > < p > email is missing< / p > < / li >
< li > < p > current password is missing< / p > < / li >
< li > < p > email: valid email must be provided< / p > < / li >
< li > < p > password: 8 characters required< / p > < / li >
< / ul >
< / p > < / li >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.2" > 401 Unauthorized< / a > < / span > – < ul >
< li > < p > provide a valid auth token< / p > < / li >
< li > < p > signature expired, please log in again< / p > < / li >
< li > < p > invalid token, please log in again< / p > < / li >
< li > < p > invalid credentials< / p > < / li >
< / ul >
< / p > < / li >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1" > 500 Internal Server Error< / a > < / span > – < / p > < / li >
< / ul >
< / dd >
< / dl >
< / dd > < / dl >
2020-12-30 11:12:35 +01:00
< dl class = "http post" >
2021-11-06 21:26:02 +01:00
< dt class = "sig sig-object http" id = "post--api-auth-password-update" >
< span class = "sig-name descname" > < span class = "pre" > POST< / span > < / span > < span class = "sig-name descname" > < span class = "pre" > /api/auth/password/update< / span > < / span > < a class = "headerlink" href = "#post--api-auth-password-update" title = "Permalink to this definition" > ¶< / a > < / dt >
2022-08-27 16:50:29 +02:00
< dd > < p > Update user password after password reset request.< / p >
< p > It sends emails if sending is enabled.< / p >
2020-12-30 11:12:35 +01:00
< p > < strong > Example request< / strong > :< / p >
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "nf" > POST< / span > < span class = "nn" > /api/auth/password/update< / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span >
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
< / pre > < / div >
< / div >
< p > < strong > Example response< / strong > :< / p >
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span > < span class = "m" > 200< / span > < span class = "ne" > OK< / span >
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
2023-02-16 11:18:50 +01:00
< span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " message" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " password updated" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " status" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " success" < / span >
< span class = "p" > }< / span >
2020-12-30 11:12:35 +01:00
< / pre > < / div >
< / div >
< dl class = "field-list simple" >
2022-06-22 20:22:26 +02:00
< dt class = "field-odd" > Request JSON Object< span class = "colon" > :< / span > < / dt >
2020-12-30 11:12:35 +01:00
< dd class = "field-odd" > < ul class = "simple" >
< li > < p > < strong > password< / strong > (< em > string< / em > ) – < / p > < / li >
< li > < p > < strong > token< / strong > (< em > string< / em > ) – < / p > < / li >
< / ul >
< / dd >
2022-06-22 20:22:26 +02:00
< dt class = "field-even" > Status Codes< span class = "colon" > :< / span > < / dt >
2020-12-30 11:12:35 +01:00
< dd class = "field-even" > < ul class = "simple" >
2021-11-06 21:26:02 +01:00
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1" > 200 OK< / a > < / span > – < / p > < / li >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1" > 400 Bad Request< / a > < / span > – < / p > < / li >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.2" > 401 Unauthorized< / a > < / span > – < / p > < / li >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1" > 500 Internal Server Error< / a > < / span > – < / p > < / li >
2020-12-30 11:12:35 +01:00
< / ul >
< / dd >
< / dl >
< / dd > < / dl >
2022-03-26 20:30:37 +01:00
< dl class = "http post" >
< dt class = "sig sig-object http" id = "post--api-auth-email-update" >
< span class = "sig-name descname" > < span class = "pre" > POST< / span > < / span > < span class = "sig-name descname" > < span class = "pre" > /api/auth/email/update< / span > < / span > < a class = "headerlink" href = "#post--api-auth-email-update" title = "Permalink to this definition" > ¶< / a > < / dt >
2022-08-27 16:50:29 +02:00
< dd > < p > Update user email after confirmation.< / p >
2022-03-26 20:30:37 +01:00
< p > < strong > Example request< / strong > :< / p >
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "nf" > POST< / span > < span class = "nn" > /api/auth/email/update< / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span >
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
< / pre > < / div >
< / div >
< p > < strong > Example response< / strong > :< / p >
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span > < span class = "m" > 200< / span > < span class = "ne" > OK< / span >
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
2023-02-16 11:18:50 +01:00
< span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " message" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " email updated" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " status" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " success" < / span >
< span class = "p" > }< / span >
2022-03-26 20:30:37 +01:00
< / pre > < / div >
< / div >
< dl class = "field-list simple" >
2022-06-22 20:22:26 +02:00
< dt class = "field-odd" > Request JSON Object< span class = "colon" > :< / span > < / dt >
2022-03-26 20:30:37 +01:00
< dd class = "field-odd" > < ul class = "simple" >
< li > < p > < strong > token< / strong > (< em > string< / em > ) – < / p > < / li >
< / ul >
< / dd >
2022-06-22 20:22:26 +02:00
< dt class = "field-even" > Status Codes< span class = "colon" > :< / span > < / dt >
2022-03-26 20:30:37 +01:00
< dd class = "field-even" > < ul class = "simple" >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1" > 200 OK< / a > < / span > – < / p > < / li >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1" > 400 Bad Request< / a > < / span > – < / p > < / li >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1" > 500 Internal Server Error< / a > < / span > – < / p > < / li >
< / ul >
< / dd >
< / dl >
< / dd > < / dl >
2022-09-15 16:11:13 +02:00
< dl class = "http post" >
< dt class = "sig sig-object http" id = "post--api-auth-logout" >
< span class = "sig-name descname" > < span class = "pre" > POST< / span > < / span > < span class = "sig-name descname" > < span class = "pre" > /api/auth/logout< / span > < / span > < a class = "headerlink" href = "#post--api-auth-logout" title = "Permalink to this definition" > ¶< / a > < / dt >
< dd > < p > User logout.
If a valid token is provided, it will be blacklisted.< / p >
< p > < strong > Example request< / strong > :< / p >
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "nf" > POST< / span > < span class = "nn" > /api/auth/logout< / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span >
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
< / pre > < / div >
< / div >
< p > < strong > Example responses< / strong > :< / p >
< ul class = "simple" >
< li > < p > successful logout< / p > < / li >
< / ul >
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span > < span class = "m" > 200< / span > < span class = "ne" > OK< / span >
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
2023-02-16 11:18:50 +01:00
< span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " message" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " successfully logged out" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " status" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " success" < / span >
< span class = "p" > }< / span >
2022-09-15 16:11:13 +02:00
< / pre > < / div >
< / div >
< ul class = "simple" >
< li > < p > error on logout< / p > < / li >
< / ul >
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "kr" > HTTP< / span > < span class = "o" > /< / span > < span class = "m" > 1.1< / span > < span class = "m" > 401< / span > < span class = "ne" > UNAUTHORIZED< / span >
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > application/json< / span >
2023-02-16 11:18:50 +01:00
< span class = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " message" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " provide a valid auth token" < / span > < span class = "p" > ,< / span >
< span class = "w" > < / span > < span class = "nt" > " status" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " error" < / span >
< span class = "p" > }< / span >
2022-09-15 16:11:13 +02:00
< / pre > < / div >
< / div >
< dl class = "field-list simple" >
< dt class = "field-odd" > Request Headers< span class = "colon" > :< / span > < / dt >
< dd class = "field-odd" > < ul class = "simple" >
2022-11-27 12:06:42 +01:00
< li > < p > < span > < a class = "reference external" href = "https://www.rfc-editor.org/rfc/rfc7235#section-4.2" > Authorization< / a > < / span > – < / p > < / li >
2022-09-15 16:11:13 +02:00
< / ul >
< / dd >
< dt class = "field-even" > Status Codes< span class = "colon" > :< / span > < / dt >
< dd class = "field-even" > < ul class = "simple" >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1" > 200 OK< / a > < / span > – < / p > < / li >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.2" > 401 Unauthorized< / a > < / span > – < ul >
< li > < p > provide a valid auth token< / p > < / li >
< li > < p > The access token provided is expired, revoked, malformed, or invalid
for other reasons.< / p > < / li >
< / ul >
< / p > < / li >
< li > < p > < span > < a class = "reference external" href = "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1" > 500 Internal Server Error< / a > < / span > – < ul >
< li > < p > error on token blacklist< / p > < / li >
< / ul >
< / p > < / li >
< / ul >
< / dd >
< / dl >
< / dd > < / dl >
2021-11-06 21:26:02 +01:00
< / section >
2020-12-30 11:12:35 +01:00
< / div >
< / div >
< / div >
< footer class = "footer" >
< div class = "container" >
< p class = "pull-right" >
< a href = "#" > Back to top< / a >
< / p >
< p >
2022-11-27 12:06:42 +01:00
© Copyright 2018 - 2022, SamR1 < a rel = "me" href = "https://fosstodon.org/@FitTrackee" > < i class = "fa fa-mastodon" aria-hidden = "true" > < / i > < / a > .
2023-02-16 11:18:50 +01:00
Last updated on Feb 16, 2023.< br / >
2022-11-01 19:58:12 +01:00
Created using < a href = "http://sphinx-doc.org/" > Sphinx< / a > 5.3.0.< br / >
2020-12-30 11:12:35 +01:00
< / p >
< / div >
< / footer >
2022-11-27 12:06:42 +01:00
2020-12-30 11:12:35 +01:00
< / body >
< / html >
