2023-06-18 15:02:21 +02:00
<!doctype html>
< html class = "no-js" lang = "en" >
< head > < meta charset = "utf-8" / >
< meta name = "viewport" content = "width=device-width,initial-scale=1" / >
< meta name = "color-scheme" content = "light dark" > < meta name = "viewport" content = "width=device-width, initial-scale=1" / >
< link rel = "index" title = "Index" href = "../genindex.html" / > < link rel = "search" title = "Search" href = "../search.html" / > < link rel = "next" title = "Workouts" href = "workouts.html" / > < link rel = "prev" title = "Statistics" href = "stats.html" / >
2020-12-30 11:12:35 +01:00
2023-06-18 15:02:21 +02:00
<!-- Generated with Sphinx 7.0.1 and Furo 2023.05.20 -->
< title > Users - FitTrackee 0.7.17 documentation< / title >
< link rel = "stylesheet" type = "text/css" href = "../_static/pygments.css" / >
< link rel = "stylesheet" type = "text/css" href = "../_static/styles/furo.css?digest=e6660623a769aa55fea372102b9bf3151b292993" / >
< link rel = "stylesheet" type = "text/css" href = "../_static/copybutton.css" / >
< link rel = "stylesheet" type = "text/css" href = "../_static/styles/furo-extensions.css?digest=30d1aed668e5c3a91c3e3bf6a60b675221979f0e" / >
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" / >
2023-06-18 15:02:21 +02:00
< style >
body {
--color-code-background: #eeffcc;
--color-code-foreground: black;
}
@media not print {
body[data-theme="dark"] {
--color-code-background: #272822;
--color-code-foreground: #f8f8f2;
}
@media (prefers-color-scheme: dark) {
body:not([data-theme="light"]) {
--color-code-background: #272822;
--color-code-foreground: #f8f8f2;
}
}
}
< / style > < / head >
< body >
< script >
document.body.dataset.theme = localStorage.getItem("theme") || "auto";
< / script >
< svg xmlns = "http://www.w3.org/2000/svg" style = "display: none;" >
< symbol id = "svg-toc" viewBox = "0 0 24 24" >
< title > Contents< / title >
< svg stroke = "currentColor" fill = "currentColor" stroke-width = "0" viewBox = "0 0 1024 1024" >
< path d = "M408 442h480c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8H408c-4.4 0-8 3.6-8 8v56c0 4.4 3.6 8 8 8zm-8 204c0 4.4 3.6 8 8 8h480c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8H408c-4.4 0-8 3.6-8 8v56zm504-486H120c-4.4 0-8 3.6-8 8v56c0 4.4 3.6 8 8 8h784c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8zm0 632H120c-4.4 0-8 3.6-8 8v56c0 4.4 3.6 8 8 8h784c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8zM115.4 518.9L271.7 642c5.8 4.6 14.4.5 14.4-6.9V388.9c0-7.4-8.5-11.5-14.4-6.9L115.4 505.1a8.74 8.74 0 0 0 0 13.8z" / >
< / svg >
< / symbol >
< symbol id = "svg-menu" viewBox = "0 0 24 24" >
< title > Menu< / title >
< svg xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 24 24" fill = "none" stroke = "currentColor"
stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather-menu">
< line x1 = "3" y1 = "12" x2 = "21" y2 = "12" > < / line >
< line x1 = "3" y1 = "6" x2 = "21" y2 = "6" > < / line >
< line x1 = "3" y1 = "18" x2 = "21" y2 = "18" > < / line >
< / svg >
< / symbol >
< symbol id = "svg-arrow-right" viewBox = "0 0 24 24" >
< title > Expand< / title >
< svg xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 24 24" fill = "none" stroke = "currentColor"
stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather-chevron-right">
< polyline points = "9 18 15 12 9 6" > < / polyline >
< / svg >
< / symbol >
< symbol id = "svg-sun" viewBox = "0 0 24 24" >
< title > Light mode< / title >
< svg xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 24 24" fill = "none" stroke = "currentColor"
stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="feather-sun">
< circle cx = "12" cy = "12" r = "5" > < / circle >
< line x1 = "12" y1 = "1" x2 = "12" y2 = "3" > < / line >
< line x1 = "12" y1 = "21" x2 = "12" y2 = "23" > < / line >
< line x1 = "4.22" y1 = "4.22" x2 = "5.64" y2 = "5.64" > < / line >
< line x1 = "18.36" y1 = "18.36" x2 = "19.78" y2 = "19.78" > < / line >
< line x1 = "1" y1 = "12" x2 = "3" y2 = "12" > < / line >
< line x1 = "21" y1 = "12" x2 = "23" y2 = "12" > < / line >
< line x1 = "4.22" y1 = "19.78" x2 = "5.64" y2 = "18.36" > < / line >
< line x1 = "18.36" y1 = "5.64" x2 = "19.78" y2 = "4.22" > < / line >
< / svg >
< / symbol >
< symbol id = "svg-moon" viewBox = "0 0 24 24" >
< title > Dark mode< / title >
< svg xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 24 24" fill = "none" stroke = "currentColor"
stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="icon-tabler-moon">
< path stroke = "none" d = "M0 0h24v24H0z" fill = "none" / >
< path d = "M12 3c.132 0 .263 0 .393 0a7.5 7.5 0 0 0 7.92 12.446a9 9 0 1 1 -8.313 -12.454z" / >
< / svg >
< / symbol >
< symbol id = "svg-sun-half" viewBox = "0 0 24 24" >
< title > Auto light/dark mode< / title >
< svg xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 24 24" fill = "none" stroke = "currentColor"
stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="icon-tabler-shadow">
< path stroke = "none" d = "M0 0h24v24H0z" fill = "none" / >
< circle cx = "12" cy = "12" r = "9" / >
< path d = "M13 12h5" / >
< path d = "M13 15h4" / >
< path d = "M13 18h1" / >
< path d = "M13 9h4" / >
< path d = "M13 6h1" / >
< / svg >
< / symbol >
< / svg >
< input type = "checkbox" class = "sidebar-toggle" name = "__navigation" id = "__navigation" >
< input type = "checkbox" class = "sidebar-toggle" name = "__toc" id = "__toc" >
< label class = "overlay sidebar-overlay" for = "__navigation" >
< div class = "visually-hidden" > Hide navigation sidebar< / div >
< / label >
< label class = "overlay toc-overlay" for = "__toc" >
< div class = "visually-hidden" > Hide table of contents sidebar< / div >
< / label >
2020-12-30 11:12:35 +01:00
2023-06-18 15:02:21 +02:00
< div class = "page" >
< header class = "mobile-header" >
< div class = "header-left" >
< label class = "nav-overlay-icon" for = "__navigation" >
< div class = "visually-hidden" > Toggle site navigation sidebar< / div >
< i class = "icon" > < svg > < use href = "#svg-menu" > < / use > < / svg > < / i >
< / label >
< / div >
< div class = "header-center" >
< a href = "../index.html" > < div class = "brand" > FitTrackee 0.7.17
documentation< / div > < / a >
< / div >
< div class = "header-right" >
< div class = "theme-toggle-container theme-toggle-header" >
< button class = "theme-toggle" >
< div class = "visually-hidden" > Toggle Light / Dark / Auto color theme< / div >
< svg class = "theme-icon-when-auto" > < use href = "#svg-sun-half" > < / use > < / svg >
< svg class = "theme-icon-when-dark" > < use href = "#svg-moon" > < / use > < / svg >
< svg class = "theme-icon-when-light" > < use href = "#svg-sun" > < / use > < / svg >
2020-12-30 11:12:35 +01:00
< / button >
< / div >
2023-06-18 15:02:21 +02:00
< label class = "toc-overlay-icon toc-header-icon no-toc" for = "__toc" >
< div class = "visually-hidden" > Toggle table of contents sidebar< / div >
< i class = "icon" > < svg > < use href = "#svg-toc" > < / use > < / svg > < / i >
< / label >
< / div >
< / header >
< aside class = "sidebar-drawer" >
< div class = "sidebar-container" >
< div class = "sidebar-sticky" > < a class = "sidebar-brand" href = "../index.html" >
< div class = "sidebar-logo-container" >
< img class = "sidebar-logo" src = "../_static/ft-logo.png" alt = "Logo" / >
< / div >
< span class = "sidebar-brand-text" > FitTrackee 0.7.17
documentation< / span >
< / a > < form class = "sidebar-search-container" method = "get" action = "../search.html" role = "search" >
< input class = "sidebar-search" placeholder = "Search" name = "q" aria-label = "Search" >
< input type = "hidden" name = "check_keywords" value = "yes" >
< input type = "hidden" name = "area" value = "default" >
< / form >
< div id = "searchbox" > < / div > < div class = "sidebar-scroll" > < div class = "sidebar-tree" >
< ul class = "current" >
2020-12-30 11:12:35 +01:00
< li class = "toctree-l1" > < a class = "reference internal" href = "../features.html" > Features< / a > < / li >
2023-04-12 17:32:08 +02:00
< li class = "toctree-l1" > < a class = "reference internal" href = "../oauth.html" > OAuth 2.0< / 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 >
2023-04-12 17:32:08 +02:00
< li class = "toctree-l1" > < a class = "reference internal" href = "../third_party_tools.html" > Third-party tools< / a > < / li >
2023-06-18 15:02:21 +02:00
< li class = "toctree-l1 current has-children" > < a class = "reference internal" href = "index.html" > API documentation< / a > < input checked = "" class = "toctree-checkbox" id = "toctree-checkbox-1" name = "toctree-checkbox-1" role = "switch" type = "checkbox" / > < label for = "toctree-checkbox-1" > < div class = "visually-hidden" > Toggle navigation of API documentation< / div > < i class = "icon" > < svg > < use href = "#svg-arrow-right" > < / use > < / svg > < / i > < / label > < ul class = "current" >
< li class = "toctree-l2" > < a class = "reference internal" href = "auth.html" > Authentication and account< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "configuration.html" > Configuration< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "oauth2.html" > OAuth2< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "records.html" > Records< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "sports.html" > Sports< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "stats.html" > Statistics< / a > < / li >
< li class = "toctree-l2 current current-page" > < a class = "current reference internal" href = "#" > Users< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "workouts.html" > Workouts< / a > < / li >
2020-12-30 11:12:35 +01:00
< / ul >
< / li >
2023-06-18 15:02:21 +02:00
< li class = "toctree-l1 has-children" > < a class = "reference internal" href = "../troubleshooting/index.html" > Troubleshooting< / a > < input class = "toctree-checkbox" id = "toctree-checkbox-2" name = "toctree-checkbox-2" role = "switch" type = "checkbox" / > < label for = "toctree-checkbox-2" > < div class = "visually-hidden" > Toggle navigation of Troubleshooting< / div > < i class = "icon" > < svg > < use href = "#svg-arrow-right" > < / use > < / svg > < / i > < / label > < ul >
< li class = "toctree-l2" > < a class = "reference internal" href = "../troubleshooting/administrator.html" > Administrator< / a > < / li >
2020-12-30 11:12:35 +01:00
< / ul >
< / li >
2023-06-18 15:02:21 +02:00
< li class = "toctree-l1" > < a class = "reference internal" href = "../changelog.html" > Change log< / a > < / li >
< / ul >
2020-12-30 11:12:35 +01:00
2023-06-18 15:02:21 +02:00
< / div >
< / div >
2020-12-30 11:12:35 +01:00
2023-06-18 15:02:21 +02:00
< / div >
2020-12-30 11:12:35 +01:00
2023-06-18 15:02:21 +02:00
< / div >
< / aside >
< div class = "main" >
< div class = "content" >
< div class = "article-container" >
< a href = "#" class = "back-to-top muted-link" >
< svg xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 24 24" >
< path d = "M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8v12z" > < / path >
< / svg >
< span > Back to top< / span >
< / a >
< div class = "content-icon-container" >
< div class = "theme-toggle-container theme-toggle-content" >
< button class = "theme-toggle" >
< div class = "visually-hidden" > Toggle Light / Dark / Auto color theme< / div >
< svg class = "theme-icon-when-auto" > < use href = "#svg-sun-half" > < / use > < / svg >
< svg class = "theme-icon-when-dark" > < use href = "#svg-moon" > < / use > < / svg >
< svg class = "theme-icon-when-light" > < use href = "#svg-sun" > < / use > < / svg >
< / button >
< / div >
< label class = "toc-overlay-icon toc-content-icon no-toc" for = "__toc" >
< div class = "visually-hidden" > Toggle table of contents sidebar< / div >
< i class = "icon" > < svg > < use href = "#svg-toc" > < / use > < / svg > < / i >
< / label >
< / div >
< article role = "main" >
< section id = "users" >
< h1 > Users< a class = "headerlink" href = "#users" title = "Permalink to this heading" > #< / a > < / h1 >
2020-12-30 11:12:35 +01:00
< dl class = "http get" >
2021-11-06 21:26:02 +01:00
< dt class = "sig sig-object http" id = "get--api-users" >
2023-06-18 15:02:21 +02:00
< span class = "sig-name descname" > < span class = "pre" > GET< / span > < / span > < span class = "sig-name descname" > < span class = "pre" > /api/users< / span > < / span > < a class = "headerlink" href = "#get--api-users" title = "Permalink to this definition" > #< / a > < / dt >
2022-03-26 20:30:37 +01:00
< dd > < p > Get all users (regardless their account status), if authenticated user
2022-08-27 16:50:29 +02:00
has admin rights.< / p >
2022-03-26 20:30:37 +01:00
< p > It returns user preferences only for authenticated user.< / p >
2022-08-27 16:50:29 +02:00
< p > < strong > Scope< / strong > : < code class = "docutils literal notranslate" > < span class = "pre" > users:read< / span > < / code > < / p >
2020-12-30 11:12:35 +01:00
< p > < strong > Example request< / strong > :< / p >
< ul class = "simple" >
< li > < p > without parameters< / p > < / li >
< / ul >
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "nf" > GET< / span > < span class = "nn" > /api/users< / 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 >
< ul class = "simple" >
< li > < p > with some query parameters< / p > < / li >
< / ul >
2021-01-10 11:16:43 +01:00
< div class = "highlight-http notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "nf" > GET< / span > < span class = "nn" > /api/users?order_by=workouts_count& par_page=5< / 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 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" > " users" < / 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" > " admin" < / 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" > " 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" > " email" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " admin@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" > " is_admin" < / 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" > " 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" > " 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" > " admin" < / 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" > " admin" < / 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" > " admin" < / 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" > " admin" < / 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" > " admin" < / 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 = "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" > " Sat, 20 Jul 2019 11:27:03 GMT" < / 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" > " is_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" > " language" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " fr" < / 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" > 0< / 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" > 0< / 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 = "nt" > " sports_list" < / span > < span class = "p" > :< / 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 = "mi" > 0< / 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" > " 0:00:00" < / 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 = "w" > < / 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" > " 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" > Query Parameters< span class = "colon" > :< / span > < / dt >
2020-12-30 11:12:35 +01:00
< dd class = "field-odd" > < ul class = "simple" >
< li > < p > < strong > page< / strong > (< em > integer< / em > ) – page if using pagination (default: 1)< / p > < / li >
< li > < p > < strong > per_page< / strong > (< em > integer< / em > ) – number of users per page (default: 10, max: 50)< / p > < / li >
< li > < p > < strong > q< / strong > (< em > string< / em > ) – query on user name< / p > < / li >
2022-10-30 08:50:59 +01:00
< li > < p > < strong > order< / strong > (< em > string< / em > ) – sorting order: < code class = "docutils literal notranslate" > < span class = "pre" > asc< / span > < / code > , < code class = "docutils literal notranslate" > < span class = "pre" > desc< / span > < / code > (default: < code class = "docutils literal notranslate" > < span class = "pre" > asc< / span > < / code > )< / p > < / li >
< li > < p > < strong > order_by< / strong > (< em > string< / em > ) – sorting criteria: < code class = "docutils literal notranslate" > < span class = "pre" > username< / span > < / code > , < code class = "docutils literal notranslate" > < span class = "pre" > created_at< / span > < / code > ,
< code class = "docutils literal notranslate" > < span class = "pre" > workouts_count< / span > < / code > , < code class = "docutils literal notranslate" > < span class = "pre" > admin< / span > < / code > , < code class = "docutils literal notranslate" > < span class = "pre" > is_active< / span > < / code >
(default: < code class = "docutils literal notranslate" > < span class = "pre" > username< / span > < / code > )< / p > < / li >
2020-12-30 11:12:35 +01:00
< / ul >
< / dd >
2022-06-22 20:22:26 +02:00
< dt class = "field-even" > Request Headers< span class = "colon" > :< / span > < / dt >
2021-12-01 19:39:45 +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 > – OAuth 2.0 Bearer Token< / 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 >
2021-12-01 19:39:45 +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 > – success< / 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 get" >
2021-11-06 21:26:02 +01:00
< dt class = "sig sig-object http" id = "get--api-users-(user_name)" >
2023-06-18 15:02:21 +02:00
< span class = "sig-name descname" > < span class = "pre" > GET< / span > < / span > < span class = "sig-name descname" > < span class = "pre" > /api/users/< / span > < / span > < span class = "sig-paren" > (< / span > < em class = "sig-param" > < span class = "pre" > user_name< / span > < / em > < span class = "sig-paren" > )< / span > < a class = "headerlink" href = "#get--api-users-(user_name)" title = "Permalink to this definition" > #< / a > < / dt >
2022-04-03 19:47:40 +02:00
< dd > < p > Get single user details. Only user with admin rights can get other users
details.< / p >
2022-03-26 20:30:37 +01:00
< p > It returns user preferences only for authenticated user.< / p >
2022-08-27 16:50:29 +02:00
< p > < strong > Scope< / strong > : < code class = "docutils literal notranslate" > < span class = "pre" > users: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/users/admin< / 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 = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " admin" < / 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" > " 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" > " email" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " admin@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_admin" < / 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" > " admin" < / 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" > " admin" < / 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" > " admin" < / 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" > " admin" < / 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" > " admin" < / span >
< span class = "w" > < / span > < span class = "p" > }< / 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" > Parameters< span class = "colon" > :< / span > < / dt >
2020-12-30 11:12:35 +01:00
< dd class = "field-odd" > < ul class = "simple" >
< li > < p > < strong > user_name< / strong > (< em > integer< / em > ) – user name< / 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 > – OAuth 2.0 Bearer Token< / 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 > – success< / 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.4.5" > 404 Not Found< / a > < / span > – < ul >
2021-11-03 12:41:23 +01:00
< li > < p > user does not exist< / p > < / li >
2020-12-30 11:12:35 +01:00
< / ul >
< / p > < / li >
< / 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-users-(user_name)-picture" >
2023-06-18 15:02:21 +02:00
< span class = "sig-name descname" > < span class = "pre" > GET< / span > < / span > < span class = "sig-name descname" > < span class = "pre" > /api/users/< / span > < / span > < span class = "sig-paren" > (< / span > < em class = "sig-param" > < span class = "pre" > user_name< / span > < / em > < span class = "sig-paren" > )< / span > < span class = "sig-name descname" > < span class = "pre" > /picture< / span > < / span > < a class = "headerlink" href = "#get--api-users-(user_name)-picture" title = "Permalink to this definition" > #< / a > < / dt >
2020-12-30 11:12:35 +01:00
< dd > < p > get user picture< / p >
< 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/users/admin/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" > 200< / span > < span class = "ne" > OK< / span >
< span class = "na" > Content-Type< / span > < span class = "o" > :< / span > < span class = "l" > image/jpeg< / 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 >
2020-12-30 11:12:35 +01:00
< dd class = "field-odd" > < ul class = "simple" >
< li > < p > < strong > user_name< / strong > (< em > integer< / em > ) – user name< / 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 > – success< / 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 >
2021-11-03 12:41:23 +01:00
< li > < p > user does not exist< / p > < / li >
2020-12-30 11:12:35 +01:00
< li > < p > No picture.< / p > < / li >
< / ul >
< / p > < / li >
< / ul >
< / dd >
< / dl >
< / dd > < / dl >
< dl class = "http patch" >
2021-11-06 21:26:02 +01:00
< dt class = "sig sig-object http" id = "patch--api-users-(user_name)" >
2023-06-18 15:02:21 +02:00
< span class = "sig-name descname" > < span class = "pre" > PATCH< / span > < / span > < span class = "sig-name descname" > < span class = "pre" > /api/users/< / span > < / span > < span class = "sig-paren" > (< / span > < em class = "sig-param" > < span class = "pre" > user_name< / span > < / em > < span class = "sig-paren" > )< / span > < a class = "headerlink" href = "#patch--api-users-(user_name)" title = "Permalink to this definition" > #< / a > < / dt >
2022-08-27 16:50:29 +02:00
< dd > < p > Update user account.< / p >
2022-03-26 20:30:37 +01:00
< ul class = "simple" >
< li > < p > add/remove admin rights (regardless user account status)< / p > < / li >
2022-04-24 13:17:38 +02:00
< li > < p > reset password (and send email to update user password,
if sending enabled)< / p > < / li >
< li > < p > update user email (and send email to new user email, if sending enabled)< / p > < / li >
2022-03-26 20:30:37 +01:00
< li > < p > activate account for an inactive user< / p > < / li >
< / ul >
2022-08-27 16:50:29 +02:00
< p > Only user with admin rights can modify another user.< / p >
< p > < strong > Scope< / strong > : < code class = "docutils literal notranslate" > < span class = "pre" > users:write< / span > < / code > < / 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" > PATCH< / span > < span class = "nn" > /api/users/< user_name> < / 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 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 = "p" > {< / span >
< span class = "w" > < / span > < span class = "nt" > " admin" < / 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" > " 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" > " email" < / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s2" > " admin@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_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" > " 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" > " 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" > " admin" < / 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" > " admin" < / 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" > " admin" < / 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" > " admin" < / 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" > " admin" < / span >
< span class = "w" > < / span > < span class = "p" > }< / 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" > Parameters< span class = "colon" > :< / span > < / dt >
2020-12-30 11:12:35 +01:00
< dd class = "field-odd" > < ul class = "simple" >
< li > < p > < strong > user_name< / strong > (< em > string< / em > ) – user name< / p > < / li >
< / ul >
< / dd >
2022-06-22 20:22:26 +02:00
< dt class = "field-even" > Request JSON Object< 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 > < strong > activate< / strong > (< em > boolean< / em > ) – activate user account< / p > < / li >
2020-12-30 11:12:35 +01:00
< li > < p > < strong > admin< / strong > (< em > boolean< / em > ) – does the user have administrator rights< / p > < / li >
2022-03-26 20:30:37 +01:00
< li > < p > < strong > new_email< / strong > (< em > boolean< / em > ) – new user email< / p > < / li >
< li > < p > < strong > reset_password< / strong > (< em > boolean< / em > ) – reset user password< / p > < / li >
2020-12-30 11:12:35 +01:00
< / ul >
< / dd >
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 > – OAuth 2.0 Bearer Token< / 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 > – success< / p > < / li >
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.4.1" > 400 Bad Request< / a > < / span > – < ul >
< li > < p > invalid payload< / p > < / li >
< li > < p > valid email must be provided< / p > < / li >
< li > < p > new email must be different than curent email< / 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.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.4" > 403 Forbidden< / a > < / span > – you do not have permissions< / 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 >
2021-11-03 12:41:23 +01:00
< li > < p > user does not exist< / 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 delete" >
2021-11-06 21:26:02 +01:00
< dt class = "sig sig-object http" id = "delete--api-users-(user_name)" >
2023-06-18 15:02:21 +02:00
< span class = "sig-name descname" > < span class = "pre" > DELETE< / span > < / span > < span class = "sig-name descname" > < span class = "pre" > /api/users/< / span > < / span > < span class = "sig-paren" > (< / span > < em class = "sig-param" > < span class = "pre" > user_name< / span > < / em > < span class = "sig-paren" > )< / span > < a class = "headerlink" href = "#delete--api-users-(user_name)" title = "Permalink to this definition" > #< / a > < / dt >
2022-08-27 16:50:29 +02:00
< dd > < p > Delete a user account.< / p >
< p > A user can only delete his own account.< / p >
2020-12-30 11:12:35 +01:00
< p > An admin can delete all accounts except his account if he’ s the only
2022-08-27 16:50:29 +02:00
one admin.< / p >
< p > < strong > Scope< / strong > : < code class = "docutils literal notranslate" > < span class = "pre" > users: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/users/john_doe< / 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" > Parameters< span class = "colon" > :< / span > < / dt >
2020-12-30 11:12:35 +01:00
< dd class = "field-odd" > < ul class = "simple" >
< li > < p > < strong > user_name< / strong > (< em > string< / em > ) – user name< / 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 > – OAuth 2.0 Bearer Token< / 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.5" > 204 No Content< / a > < / span > – user account deleted< / 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.4.4" > 403 Forbidden< / a > < / span > – < ul >
2021-11-03 12:41:23 +01:00
< li > < p > you do not have permissions< / p > < / li >
< li > < p > you can not delete your account, no other user has admin rights< / 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.5" > 404 Not Found< / a > < / span > – < ul >
2021-11-03 12:41:23 +01:00
< li > < p > user does not exist< / 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 > – error, please try again or contact the administrator< / p > < / li >
2020-12-30 11:12:35 +01:00
< / ul >
< / dd >
< / dl >
< / dd > < / dl >
2021-11-06 21:26:02 +01:00
< / section >
2020-12-30 11:12:35 +01:00
2023-06-18 15:02:21 +02:00
< / article >
< / div >
< footer >
< div class = "related-pages" >
< a class = "next-page" href = "workouts.html" >
< div class = "page-info" >
< div class = "context" >
< span > Next< / span >
< / div >
< div class = "title" > Workouts< / div >
< / div >
< svg class = "furo-related-icon" > < use href = "#svg-arrow-right" > < / use > < / svg >
< / a >
< a class = "prev-page" href = "stats.html" >
< svg class = "furo-related-icon" > < use href = "#svg-arrow-right" > < / use > < / svg >
< div class = "page-info" >
< div class = "context" >
< span > Previous< / span >
< / div >
< div class = "title" > Statistics< / div >
< / div >
< / a >
< / div >
< div class = "bottom-of-page" >
< div class = "left-details" >
< div class = "copyright" >
Copyright © 2018 - 2023, SamR1
< / div >
Made with < a href = "https://www.sphinx-doc.org/" > Sphinx< / a > and < a class = "muted-link" href = "https://pradyunsg.me" > @pradyunsg< / a > 's
< a href = "https://github.com/pradyunsg/furo" > Furo< / a >
< / div >
< div class = "right-details" >
< div class = "icons" >
< a class = "muted-link fa fa-github fa-lg" href = "https://github.com/SamR1/FitTrackee" aria-label = "GitHub" > < / a >
< a class = "muted-link fa fa-mastodon fa-lg" href = "https://fosstodon.org/@FitTrackee" aria-label = "Mastodon" > < / a >
< / div >
< / div >
< / div >
< / footer >
2020-12-30 11:12:35 +01:00
< / div >
2023-06-18 15:02:21 +02:00
< aside class = "toc-drawer no-toc" >
2020-12-30 11:12:35 +01:00
2023-06-18 15:02:21 +02:00
< / aside >
2020-12-30 11:12:35 +01:00
< / div >
2023-06-18 15:02:21 +02:00
< / div > < script data-url_root = "../" id = "documentation_options" src = "../_static/documentation_options.js" > < / script >
< script src = "../_static/doctools.js" > < / script >
< script src = "../_static/sphinx_highlight.js" > < / script >
< script src = "../_static/scripts/furo.js" > < / script >
< script src = "../_static/clipboard.min.js" > < / script >
< script src = "../_static/copybutton.js" > < / script >
< / body >
2020-12-30 11:12:35 +01:00
< / html >