From 0c55a19cbcb0e3be7f439fe09df8b5c4de9f2e5a Mon Sep 17 00:00:00 2001
From: frankie567 <frankie567@users.noreply.github.com>
Date: Fri, 12 Jul 2024 11:55:17 +0000
Subject: [PATCH] Automated deployment: Fri Jul 12 11:55:17 UTC 2024
 86a239e6bc6b6b7957b2fe25beea56da97c0a610

---
 404.html                                    |   140 +-
 assets/_mkdocstrings.css                    |   119 +
 assets/stylesheets/extra.css                |     9 +
 fastapi/index.html                          |   226 +-
 index.html                                  |   150 +-
 oauth2/index.html                           |  1283 --
 objects.inv                                 |   Bin 0 -> 1157 bytes
 reference/httpx_oauth.clients/index.html    | 12616 ++++++++++++++++++
 reference/httpx_oauth.exceptions/index.html |   766 ++
 reference/httpx_oauth.oauth2/index.html     |  2336 ++++
 search/search_index.json                    |     2 +-
 usage/index.html                            |   810 ++
 12 files changed, 17072 insertions(+), 1385 deletions(-)
 create mode 100644 assets/_mkdocstrings.css
 create mode 100644 assets/stylesheets/extra.css
 delete mode 100644 oauth2/index.html
 create mode 100644 objects.inv
 create mode 100644 reference/httpx_oauth.clients/index.html
 create mode 100644 reference/httpx_oauth.exceptions/index.html
 create mode 100644 reference/httpx_oauth.oauth2/index.html
 create mode 100644 usage/index.html
diff --git a/404.html b/404.html
index 1004a07..a0fbced 100644
--- a/404.html
+++ b/404.html
@@ -44,6 +44,10 @@
       
     
     
+      <link rel="stylesheet" href="/assets/_mkdocstrings.css">
+    
+      <link rel="stylesheet" href="/assets/stylesheets/extra.css">
+    
     <script>__md_scope=new URL("/",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
     
       
@@ -56,10 +60,12 @@
   
     
     
+      
+    
     
     
     
-    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="red">
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo">
   
     
     <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
@@ -107,8 +113,44 @@
     </div>
     
       
+        <form class="md-header__option" data-md-component="palette">
+  
+    
+    
+    
+    <input class="md-option" data-md-color-media="(prefers-color-scheme)" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo"  aria-label="Switch to light mode"  type="radio" name="__palette" id="__palette_0">
+    
+      <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_1" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m14.3 16-.7-2h-3.2l-.7 2H7.8L11 7h2l3.2 9h-1.9M20 8.69V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69m-9.15 3.96h2.3L12 9l-1.15 3.65Z"/></svg>
+      </label>
+    
+  
+    
     
     
+    <input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="blue-grey"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_1">
+    
+      <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_2" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
+      </label>
+    
+  
+    
+    
+    
+    <input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="blue-grey" data-md-color-accent="blue-grey"  aria-label="Switch to light mode"  type="radio" name="__palette" id="__palette_2">
+    
+      <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_0" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12c0-2.42-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
+      </label>
+    
+  
+</form>
+      
+    
+    
+      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
+    
     
     
       <label class="md-header__button md-icon" for="__search">
@@ -235,6 +277,26 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="/usage/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Usage
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+  
     
     
     
@@ -243,24 +305,24 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
+          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
             
   
   <span class="md-ellipsis">
-    Usage
+    Integrations
   </span>
   
 
             <span class="md-nav__icon md-icon"></span>
           </label>
         
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_3">
             <span class="md-nav__icon md-icon"></span>
-            Usage
+            Integrations
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -271,11 +333,11 @@
   
   
     <li class="md-nav__item">
-      <a href="/oauth2/" class="md-nav__link">
+      <a href="/fastapi/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    OAuth2
+    FastAPI
   </span>
   
 
@@ -306,24 +368,24 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
+          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
             
   
   <span class="md-ellipsis">
-    Integrations
+    Reference
   </span>
   
 
             <span class="md-nav__icon md-icon"></span>
           </label>
         
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_3">
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_4">
             <span class="md-nav__icon md-icon"></span>
-            Integrations
+            Reference
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -334,11 +396,53 @@
   
   
     <li class="md-nav__item">
-      <a href="/fastapi/" class="md-nav__link">
+      <a href="/reference/httpx_oauth.clients/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    FastAPI
+    httpx_oauth.clients
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="/reference/httpx_oauth.oauth2/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    httpx_oauth.oauth2
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="/reference/httpx_oauth.exceptions/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    httpx_oauth.exceptions
   </span>
   
 
@@ -418,7 +522,7 @@ <h1>404 - Not found</h1>
     </div>
     
     
-    <script id="__config" type="application/json">{"base": "/", "features": [], "search": "/assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
+    <script id="__config" type="application/json">{"base": "/", "features": ["content.code.copy"], "search": "/assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
       <script src="/assets/javascripts/bundle.fe8b6f2b.min.js"></script>
diff --git a/assets/_mkdocstrings.css b/assets/_mkdocstrings.css
new file mode 100644
index 0000000..85449ec
--- /dev/null
+++ b/assets/_mkdocstrings.css
@@ -0,0 +1,119 @@
+
+/* Avoid breaking parameter names, etc. in table cells. */
+.doc-contents td code {
+  word-break: normal !important;
+}
+
+/* No line break before first paragraph of descriptions. */
+.doc-md-description,
+.doc-md-description>p:first-child {
+  display: inline;
+}
+
+/* Max width for docstring sections tables. */
+.doc .md-typeset__table,
+.doc .md-typeset__table table {
+  display: table !important;
+  width: 100%;
+}
+
+.doc .md-typeset__table tr {
+  display: table-row;
+}
+
+/* Defaults in Spacy table style. */
+.doc-param-default {
+  float: right;
+}
+
+/* Backward-compatibility: docstring section titles in bold. */
+.doc-section-title {
+  font-weight: bold;
+}
+
+/* Symbols in Navigation and ToC. */
+:root,
+[data-md-color-scheme="default"] {
+  --doc-symbol-attribute-fg-color: #953800;
+  --doc-symbol-function-fg-color: #8250df;
+  --doc-symbol-method-fg-color: #8250df;
+  --doc-symbol-class-fg-color: #0550ae;
+  --doc-symbol-module-fg-color: #5cad0f;
+
+  --doc-symbol-attribute-bg-color: #9538001a;
+  --doc-symbol-function-bg-color: #8250df1a;
+  --doc-symbol-method-bg-color: #8250df1a;
+  --doc-symbol-class-bg-color: #0550ae1a;
+  --doc-symbol-module-bg-color: #5cad0f1a;
+}
+
+[data-md-color-scheme="slate"] {
+  --doc-symbol-attribute-fg-color: #ffa657;
+  --doc-symbol-function-fg-color: #d2a8ff;
+  --doc-symbol-method-fg-color: #d2a8ff;
+  --doc-symbol-class-fg-color: #79c0ff;
+  --doc-symbol-module-fg-color: #baff79;
+
+  --doc-symbol-attribute-bg-color: #ffa6571a;
+  --doc-symbol-function-bg-color: #d2a8ff1a;
+  --doc-symbol-method-bg-color: #d2a8ff1a;
+  --doc-symbol-class-bg-color: #79c0ff1a;
+  --doc-symbol-module-bg-color: #baff791a;
+}
+
+code.doc-symbol {
+  border-radius: .1rem;
+  font-size: .85em;
+  padding: 0 .3em;
+  font-weight: bold;
+}
+
+code.doc-symbol-attribute {
+  color: var(--doc-symbol-attribute-fg-color);
+  background-color: var(--doc-symbol-attribute-bg-color);
+}
+
+code.doc-symbol-attribute::after {
+  content: "attr";
+}
+
+code.doc-symbol-function {
+  color: var(--doc-symbol-function-fg-color);
+  background-color: var(--doc-symbol-function-bg-color);
+}
+
+code.doc-symbol-function::after {
+  content: "func";
+}
+
+code.doc-symbol-method {
+  color: var(--doc-symbol-method-fg-color);
+  background-color: var(--doc-symbol-method-bg-color);
+}
+
+code.doc-symbol-method::after {
+  content: "meth";
+}
+
+code.doc-symbol-class {
+  color: var(--doc-symbol-class-fg-color);
+  background-color: var(--doc-symbol-class-bg-color);
+}
+
+code.doc-symbol-class::after {
+  content: "class";
+}
+
+code.doc-symbol-module {
+  color: var(--doc-symbol-module-fg-color);
+  background-color: var(--doc-symbol-module-bg-color);
+}
+
+code.doc-symbol-module::after {
+  content: "mod";
+}
+
+.doc-signature .autorefs {
+  color: inherit;
+  border-bottom: 1px dotted currentcolor;
+}
diff --git a/assets/stylesheets/extra.css b/assets/stylesheets/extra.css
new file mode 100644
index 0000000..f85a0f5
--- /dev/null
+++ b/assets/stylesheets/extra.css
@@ -0,0 +1,9 @@
+.buttons {
+    display: flex;
+    flex-direction: column;
+}
+
+.buttons .md-button {
+    margin-bottom: 0.5rem;
+    text-align: center;
+}
diff --git a/fastapi/index.html b/fastapi/index.html
index 982b138..1791976 100644
--- a/fastapi/index.html
+++ b/fastapi/index.html
@@ -11,9 +11,11 @@
       
       
       
-        <link rel="prev" href="../oauth2/">
+        <link rel="prev" href="../usage/">
       
       
+        <link rel="next" href="../reference/httpx_oauth.clients/">
+      
       
       <link rel="icon" href="../assets/images/favicon.png">
       <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.28">
@@ -46,6 +48,10 @@
       
     
     
+      <link rel="stylesheet" href="../assets/_mkdocstrings.css">
+    
+      <link rel="stylesheet" href="../assets/stylesheets/extra.css">
+    
     <script>__md_scope=new URL("..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
     
       
@@ -58,10 +64,12 @@
   
     
     
+      
+    
     
     
     
-    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="red">
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo">
   
     
     <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
@@ -114,9 +122,45 @@
     </div>
     
       
+        <form class="md-header__option" data-md-component="palette">
+  
     
     
     
+    <input class="md-option" data-md-color-media="(prefers-color-scheme)" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo"  aria-label="Switch to light mode"  type="radio" name="__palette" id="__palette_0">
+    
+      <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_1" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m14.3 16-.7-2h-3.2l-.7 2H7.8L11 7h2l3.2 9h-1.9M20 8.69V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69m-9.15 3.96h2.3L12 9l-1.15 3.65Z"/></svg>
+      </label>
+    
+  
+    
+    
+    
+    <input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="blue-grey"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_1">
+    
+      <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_2" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
+      </label>
+    
+  
+    
+    
+    
+    <input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="blue-grey" data-md-color-accent="blue-grey"  aria-label="Switch to light mode"  type="radio" name="__palette" id="__palette_2">
+    
+      <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_0" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12c0-2.42-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
+      </label>
+    
+  
+</form>
+      
+    
+    
+      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
+    
+    
     
       <label class="md-header__button md-icon" for="__search">
         
@@ -242,47 +286,12 @@
   
   
   
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Usage
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Usage
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
     <li class="md-nav__item">
-      <a href="../oauth2/" class="md-nav__link">
+      <a href="../usage/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    OAuth2
+    Usage
   </span>
   
 
@@ -290,14 +299,6 @@
     </li>
   
 
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
     
       
       
@@ -413,6 +414,111 @@
   
 
     
+      
+      
+  
+  
+  
+  
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
+        
+          
+          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
+            
+  
+  <span class="md-ellipsis">
+    Reference
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_4">
+            <span class="md-nav__icon md-icon"></span>
+            Reference
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../reference/httpx_oauth.clients/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    httpx_oauth.clients
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../reference/httpx_oauth.oauth2/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    httpx_oauth.oauth2
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../reference/httpx_oauth.exceptions/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    httpx_oauth.exceptions
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
   </ul>
 </nav>
                   </div>
@@ -479,18 +585,18 @@ <h2 id="oauth2authorizecallback"><code>OAuth2AuthorizeCallback</code><a class="h
 <p class="admonition-title">Tip</p>
 <p>You should either set <code>route_name</code>, which will automatically reverse the URL, or <code>redirect_url</code>, which is an arbitrary URL you set.</p>
 </div>
-<div class="highlight"><pre><span></span><code><span class="kn">from</span> <span class="nn">fastapi</span> <span class="kn">import</span> <span class="n">FastAPI</span><span class="p">,</span> <span class="n">Depends</span>
-<span class="kn">from</span> <span class="nn">httpx_oauth.integrations.fastapi</span> <span class="kn">import</span> <span class="n">OAuth2AuthorizeCallback</span>
-<span class="kn">from</span> <span class="nn">httpx_oauth.oauth2</span> <span class="kn">import</span> <span class="n">OAuth2</span>
-
-<span class="n">client</span> <span class="o">=</span> <span class="n">OAuth2</span><span class="p">(</span><span class="s2">&quot;CLIENT_ID&quot;</span><span class="p">,</span> <span class="s2">&quot;CLIENT_SECRET&quot;</span><span class="p">,</span> <span class="s2">&quot;AUTHORIZE_ENDPOINT&quot;</span><span class="p">,</span> <span class="s2">&quot;ACCESS_TOKEN_ENDPOINT&quot;</span><span class="p">)</span>
-<span class="n">oauth2_authorize_callback</span> <span class="o">=</span> <span class="n">OAuth2AuthorizeCallback</span><span class="p">(</span><span class="n">client</span><span class="p">,</span> <span class="s2">&quot;oauth-callback&quot;</span><span class="p">)</span>
-<span class="n">app</span> <span class="o">=</span> <span class="n">FastAPI</span><span class="p">()</span>
-
-<span class="nd">@app</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;/oauth-callback&quot;</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="s2">&quot;oauth-callback&quot;</span><span class="p">)</span>
-<span class="k">async</span> <span class="k">def</span> <span class="nf">oauth_callback</span><span class="p">(</span><span class="n">access_token_state</span><span class="o">=</span><span class="n">Depends</span><span class="p">(</span><span class="n">oauth2_authorize_callback</span><span class="p">)):</span>
-    <span class="n">token</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="n">access_token_state</span>
-    <span class="c1"># Do something useful</span>
+<div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="kn">from</span> <span class="nn">fastapi</span> <span class="kn">import</span> <span class="n">FastAPI</span><span class="p">,</span> <span class="n">Depends</span>
+<a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="kn">from</span> <span class="nn">httpx_oauth.integrations.fastapi</span> <span class="kn">import</span> <span class="n">OAuth2AuthorizeCallback</span>
+<a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="kn">from</span> <span class="nn">httpx_oauth.oauth2</span> <span class="kn">import</span> <span class="n">OAuth2</span>
+<a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a>
+<a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="n">client</span> <span class="o">=</span> <span class="n">OAuth2</span><span class="p">(</span><span class="s2">&quot;CLIENT_ID&quot;</span><span class="p">,</span> <span class="s2">&quot;CLIENT_SECRET&quot;</span><span class="p">,</span> <span class="s2">&quot;AUTHORIZE_ENDPOINT&quot;</span><span class="p">,</span> <span class="s2">&quot;ACCESS_TOKEN_ENDPOINT&quot;</span><span class="p">)</span>
+<a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a><span class="n">oauth2_authorize_callback</span> <span class="o">=</span> <span class="n">OAuth2AuthorizeCallback</span><span class="p">(</span><span class="n">client</span><span class="p">,</span> <span class="s2">&quot;oauth-callback&quot;</span><span class="p">)</span>
+<a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a><span class="n">app</span> <span class="o">=</span> <span class="n">FastAPI</span><span class="p">()</span>
+<a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a>
+<a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a><span class="nd">@app</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;/oauth-callback&quot;</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="s2">&quot;oauth-callback&quot;</span><span class="p">)</span>
+<a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="k">async</span> <span class="k">def</span> <span class="nf">oauth_callback</span><span class="p">(</span><span class="n">access_token_state</span><span class="o">=</span><span class="n">Depends</span><span class="p">(</span><span class="n">oauth2_authorize_callback</span><span class="p">)):</span>
+<a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a>    <span class="n">token</span><span class="p">,</span> <span class="n">state</span> <span class="o">=</span> <span class="n">access_token_state</span>
+<a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a>    <span class="c1"># Do something useful</span>
 </code></pre></div>
 
 
@@ -538,7 +644,7 @@ <h2 id="oauth2authorizecallback"><code>OAuth2AuthorizeCallback</code><a class="h
     </div>
     
     
-    <script id="__config" type="application/json">{"base": "..", "features": [], "search": "../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
+    <script id="__config" type="application/json">{"base": "..", "features": ["content.code.copy"], "search": "../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
       <script src="../assets/javascripts/bundle.fe8b6f2b.min.js"></script>
diff --git a/index.html b/index.html
index 0671fca..5a4e741 100644
--- a/index.html
+++ b/index.html
@@ -12,7 +12,7 @@
       
       
       
-        <link rel="next" href="oauth2/">
+        <link rel="next" href="usage/">
       
       
       <link rel="icon" href="assets/images/favicon.png">
@@ -46,6 +46,10 @@
       
     
     
+      <link rel="stylesheet" href="assets/_mkdocstrings.css">
+    
+      <link rel="stylesheet" href="assets/stylesheets/extra.css">
+    
     <script>__md_scope=new URL(".",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
     
       
@@ -58,10 +62,12 @@
   
     
     
+      
+    
     
     
     
-    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="red">
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo">
   
     
     <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
@@ -114,8 +120,44 @@
     </div>
     
       
+        <form class="md-header__option" data-md-component="palette">
+  
+    
+    
+    
+    <input class="md-option" data-md-color-media="(prefers-color-scheme)" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo"  aria-label="Switch to light mode"  type="radio" name="__palette" id="__palette_0">
+    
+      <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_1" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m14.3 16-.7-2h-3.2l-.7 2H7.8L11 7h2l3.2 9h-1.9M20 8.69V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69m-9.15 3.96h2.3L12 9l-1.15 3.65Z"/></svg>
+      </label>
+    
+  
+    
     
     
+    <input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="blue-grey"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_1">
+    
+      <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_2" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
+      </label>
+    
+  
+    
+    
+    
+    <input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="blue-grey" data-md-color-accent="blue-grey"  aria-label="Switch to light mode"  type="radio" name="__palette" id="__palette_2">
+    
+      <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_0" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12c0-2.42-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
+      </label>
+    
+  
+</form>
+      
+    
+    
+      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
+    
     
     
       <label class="md-header__button md-icon" for="__search">
@@ -360,6 +402,26 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="usage/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Usage
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+  
     
     
     
@@ -368,24 +430,24 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
+          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
             
   
   <span class="md-ellipsis">
-    Usage
+    Integrations
   </span>
   
 
             <span class="md-nav__icon md-icon"></span>
           </label>
         
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_2">
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_3">
             <span class="md-nav__icon md-icon"></span>
-            Usage
+            Integrations
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -396,11 +458,11 @@
   
   
     <li class="md-nav__item">
-      <a href="oauth2/" class="md-nav__link">
+      <a href="fastapi/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    OAuth2
+    FastAPI
   </span>
   
 
@@ -431,24 +493,24 @@
       
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
+          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
             
   
   <span class="md-ellipsis">
-    Integrations
+    Reference
   </span>
   
 
             <span class="md-nav__icon md-icon"></span>
           </label>
         
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_3">
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_4">
             <span class="md-nav__icon md-icon"></span>
-            Integrations
+            Reference
           </label>
           <ul class="md-nav__list" data-md-scrollfix>
             
@@ -459,11 +521,53 @@
   
   
     <li class="md-nav__item">
-      <a href="fastapi/" class="md-nav__link">
+      <a href="reference/httpx_oauth.clients/" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    FastAPI
+    httpx_oauth.clients
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="reference/httpx_oauth.oauth2/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    httpx_oauth.oauth2
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="reference/httpx_oauth.exceptions/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    httpx_oauth.exceptions
   </span>
   
 
@@ -625,7 +729,7 @@ <h1 id="httpx-oauth">HTTPX OAuth<a class="headerlink" href="#httpx-oauth" title=
 <p><strong>Source Code</strong>: <a href="https://github.com/frankie567/httpx-oauth" target="_blank">https://github.com/frankie567/httpx-oauth</a></p>
 <hr />
 <h2 id="installation">Installation<a class="headerlink" href="#installation" title="Permanent link">&para;</a></h2>
-<div class="highlight"><pre><span></span><code>pip<span class="w"> </span>install<span class="w"> </span>httpx-oauth
+<div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>pip<span class="w"> </span>install<span class="w"> </span>httpx-oauth
 </code></pre></div>
 <h2 id="contributors">Contributors ✨<a class="headerlink" href="#contributors" title="Permanent link">&para;</a></h2>
 <p>Thanks goes to these wonderful people (<a href="https://allcontributors.org/docs/en/emoji-key">emoji key</a>):</p>
@@ -666,15 +770,15 @@ <h3 id="setup-environment">Setup environment<a class="headerlink" href="#setup-e
 <p>We use <a href="https://hatch.pypa.io/latest/install/">Hatch</a> to manage the development environment and production build. Ensure it's installed on your system.</p>
 <h3 id="run-unit-tests">Run unit tests<a class="headerlink" href="#run-unit-tests" title="Permanent link">&para;</a></h3>
 <p>You can run all the tests with:</p>
-<div class="highlight"><pre><span></span><code>hatch<span class="w"> </span>run<span class="w"> </span><span class="nb">test</span>
+<div class="highlight"><pre><span></span><code><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>hatch<span class="w"> </span>run<span class="w"> </span><span class="nb">test</span>
 </code></pre></div>
 <h3 id="format-the-code">Format the code<a class="headerlink" href="#format-the-code" title="Permanent link">&para;</a></h3>
 <p>Execute the following command to apply <code>isort</code> and <code>black</code> formatting:</p>
-<div class="highlight"><pre><span></span><code>hatch<span class="w"> </span>run<span class="w"> </span>lint
+<div class="highlight"><pre><span></span><code><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>hatch<span class="w"> </span>run<span class="w"> </span>lint
 </code></pre></div>
 <h3 id="serve-the-documentation">Serve the documentation<a class="headerlink" href="#serve-the-documentation" title="Permanent link">&para;</a></h3>
 <p>You can serve the documentation locally with the following command:</p>
-<div class="highlight"><pre><span></span><code>hatch<span class="w"> </span>run<span class="w"> </span>docs
+<div class="highlight"><pre><span></span><code><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>hatch<span class="w"> </span>run<span class="w"> </span>docs
 </code></pre></div>
 <p>The documentation will be available on <a href="http://localhost:8000">http://localhost:8000</a>.</p>
 <h2 id="license">License<a class="headerlink" href="#license" title="Permanent link">&para;</a></h2>
@@ -725,7 +829,7 @@ <h2 id="license">License<a class="headerlink" href="#license" title="Permanent l
     </div>
     
     
-    <script id="__config" type="application/json">{"base": ".", "features": [], "search": "assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
+    <script id="__config" type="application/json">{"base": ".", "features": ["content.code.copy"], "search": "assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
       <script src="assets/javascripts/bundle.fe8b6f2b.min.js"></script>
diff --git a/oauth2/index.html b/oauth2/index.html
deleted file mode 100644
index bedbba0..0000000
--- a/oauth2/index.html
+++ /dev/null
@@ -1,1283 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-        <meta name="description" content="Async OAuth client using HTTPX">
-      
-      
-      
-      
-        <link rel="prev" href="..">
-      
-      
-        <link rel="next" href="../fastapi/">
-      
-      
-      <link rel="icon" href="../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.28">
-    
-    
-      
-        <title>OAuth2 - HTTPX OAuth</title>
-      
-    
-    
-      <link rel="stylesheet" href="../assets/stylesheets/main.6543a935.min.css">
-      
-        
-        <link rel="stylesheet" href="../assets/stylesheets/palette.06af60db.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-    <script>__md_scope=new URL("..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    
-    
-    
-    
-    
-    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="red">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#oauth2" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href=".." title="HTTPX OAuth" class="md-header__button md-logo" aria-label="HTTPX OAuth" data-md-component="logo">
-      
-  
-  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 12h7c-.53 4.11-3.28 7.78-7 8.92V12H5V6.3l7-3.11M12 1 3 5v6c0 5.55 3.84 10.73 9 12 5.16-1.27 9-6.45 9-12V5l-9-4Z"/></svg>
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            HTTPX OAuth
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              OAuth2
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-      
-    
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/frankie567/httpx-oauth" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    frankie567/httpx-oauth
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-          
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-
-<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href=".." title="HTTPX OAuth" class="md-nav__button md-logo" aria-label="HTTPX OAuth" data-md-component="logo">
-      
-  
-  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 12h7c-.53 4.11-3.28 7.78-7 8.92V12H5V6.3l7-3.11M12 1 3 5v6c0 5.55 3.84 10.73 9 12 5.16-1.27 9-6.45 9-12V5l-9-4Z"/></svg>
-
-    </a>
-    HTTPX OAuth
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/frankie567/httpx-oauth" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    frankie567/httpx-oauth
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href=".." class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    About
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Usage
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Usage
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    OAuth2
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    OAuth2
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#generic-client" class="md-nav__link">
-    <span class="md-ellipsis">
-      Generic client
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Generic client">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#available-methods" class="md-nav__link">
-    <span class="md-ellipsis">
-      Available methods
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Available methods">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#get_authorization_url" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_authorization_url
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#get_access_token" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_access_token
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#refresh_token" class="md-nav__link">
-    <span class="md-ellipsis">
-      refresh_token
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#revoke_token" class="md-nav__link">
-    <span class="md-ellipsis">
-      revoke_token
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#get_id_email" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_id_email
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#oauth2token-class" class="md-nav__link">
-    <span class="md-ellipsis">
-      OAuth2Token class
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="OAuth2Token class">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#is_expired" class="md-nav__link">
-    <span class="md-ellipsis">
-      is_expired
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#provided-clients" class="md-nav__link">
-    <span class="md-ellipsis">
-      Provided clients
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Provided clients">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#openid" class="md-nav__link">
-    <span class="md-ellipsis">
-      OpenID
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#discord" class="md-nav__link">
-    <span class="md-ellipsis">
-      Discord
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#facebook" class="md-nav__link">
-    <span class="md-ellipsis">
-      Facebook
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Facebook">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#get_long_lived_access_token" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_long_lived_access_token
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#github" class="md-nav__link">
-    <span class="md-ellipsis">
-      GitHub
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#google" class="md-nav__link">
-    <span class="md-ellipsis">
-      Google
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#kakao" class="md-nav__link">
-    <span class="md-ellipsis">
-      Kakao
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#linkedin" class="md-nav__link">
-    <span class="md-ellipsis">
-      LinkedIn
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#naver" class="md-nav__link">
-    <span class="md-ellipsis">
-      NAVER
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#okta" class="md-nav__link">
-    <span class="md-ellipsis">
-      Okta
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#reddit" class="md-nav__link">
-    <span class="md-ellipsis">
-      Reddit
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#franceconnect" class="md-nav__link">
-    <span class="md-ellipsis">
-      FranceConnect
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#shopify" class="md-nav__link">
-    <span class="md-ellipsis">
-      Shopify
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#customize-httpx-client" class="md-nav__link">
-    <span class="md-ellipsis">
-      Customize HTTPX client
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-  
-  
-    
-    
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
-        
-          
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
-            
-  
-  <span class="md-ellipsis">
-    Integrations
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_3">
-            <span class="md-nav__icon md-icon"></span>
-            Integrations
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../fastapi/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    FastAPI
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#generic-client" class="md-nav__link">
-    <span class="md-ellipsis">
-      Generic client
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Generic client">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#available-methods" class="md-nav__link">
-    <span class="md-ellipsis">
-      Available methods
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Available methods">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#get_authorization_url" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_authorization_url
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#get_access_token" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_access_token
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#refresh_token" class="md-nav__link">
-    <span class="md-ellipsis">
-      refresh_token
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#revoke_token" class="md-nav__link">
-    <span class="md-ellipsis">
-      revoke_token
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#get_id_email" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_id_email
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#oauth2token-class" class="md-nav__link">
-    <span class="md-ellipsis">
-      OAuth2Token class
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="OAuth2Token class">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#is_expired" class="md-nav__link">
-    <span class="md-ellipsis">
-      is_expired
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#provided-clients" class="md-nav__link">
-    <span class="md-ellipsis">
-      Provided clients
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Provided clients">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#openid" class="md-nav__link">
-    <span class="md-ellipsis">
-      OpenID
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#discord" class="md-nav__link">
-    <span class="md-ellipsis">
-      Discord
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#facebook" class="md-nav__link">
-    <span class="md-ellipsis">
-      Facebook
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Facebook">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#get_long_lived_access_token" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_long_lived_access_token
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#github" class="md-nav__link">
-    <span class="md-ellipsis">
-      GitHub
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#google" class="md-nav__link">
-    <span class="md-ellipsis">
-      Google
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#kakao" class="md-nav__link">
-    <span class="md-ellipsis">
-      Kakao
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#linkedin" class="md-nav__link">
-    <span class="md-ellipsis">
-      LinkedIn
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#naver" class="md-nav__link">
-    <span class="md-ellipsis">
-      NAVER
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#okta" class="md-nav__link">
-    <span class="md-ellipsis">
-      Okta
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#reddit" class="md-nav__link">
-    <span class="md-ellipsis">
-      Reddit
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#franceconnect" class="md-nav__link">
-    <span class="md-ellipsis">
-      FranceConnect
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#shopify" class="md-nav__link">
-    <span class="md-ellipsis">
-      Shopify
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#customize-httpx-client" class="md-nav__link">
-    <span class="md-ellipsis">
-      Customize HTTPX client
-    </span>
-  </a>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-
-<h1 id="oauth2">OAuth2<a class="headerlink" href="#oauth2" title="Permanent link">&para;</a></h1>
-<h2 id="generic-client">Generic client<a class="headerlink" href="#generic-client" title="Permanent link">&para;</a></h2>
-<p>A generic OAuth2 class is provided to adapt to any OAuth2-compliant service. You can instantiate it like this:</p>
-<div class="highlight"><pre><span></span><code><span class="kn">from</span> <span class="nn">httpx_oauth.oauth2</span> <span class="kn">import</span> <span class="n">OAuth2</span>
-
-<span class="n">client</span> <span class="o">=</span> <span class="n">OAuth2</span><span class="p">(</span>
-    <span class="s2">&quot;CLIENT_ID&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;CLIENT_SECRET&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;AUTHORIZE_ENDPOINT&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;ACCESS_TOKEN_ENDPOINT&quot;</span><span class="p">,</span>
-    <span class="n">refresh_token_endpoint</span><span class="o">=</span><span class="s2">&quot;REFRESH_TOKEN_ENDPOINT&quot;</span><span class="p">,</span>
-    <span class="n">revoke_token_endpoint</span><span class="o">=</span><span class="s2">&quot;REVOKE_TOKEN_ENDPOINT&quot;</span><span class="p">,</span>
-<span class="p">)</span>
-</code></pre></div>
-<p>Note that <code>refresh_token_endpoint</code> and <code>revoke_token_endpoint</code> are optional since not every services propose to refresh and revoke tokens.</p>
-<h3 id="available-methods">Available methods<a class="headerlink" href="#available-methods" title="Permanent link">&para;</a></h3>
-<h4 id="get_authorization_url"><code>get_authorization_url</code><a class="headerlink" href="#get_authorization_url" title="Permanent link">&para;</a></h4>
-<p>Returns the authorization URL where you should redirect the user to ask for their approval.</p>
-<div class="admonition abstract">
-<p class="admonition-title">Parameters</p>
-<ul>
-<li><code>redirect_uri: str</code>: Your callback URI where the user will be redirected after the service prompt.</li>
-<li><code>state: str = None</code>: Optional string that will be returned back in the callback parameters to allow you to retrieve state information.</li>
-<li><code>scope: Optional[List[str]] = None</code>: Optional list of scopes to ask for.</li>
-<li><code>code_challenge: Optional[str] = None</code>: Optional code_challenge in a <a href="https://datatracker.ietf.org/doc/html/rfc7636">PKCE context</a>.</li>
-<li><code>code_challenge_method: Optional[Literal["plain", "S256"]] = None</code>: Optional code_challenge_method in a <a href="https://datatracker.ietf.org/doc/html/rfc7636">PKCE context</a>.</li>
-<li><code>extras_params: Optional[Dict[str, Any]] = None</code>: Optional dictionary containing parameters specific to the service.</li>
-</ul>
-</div>
-<div class="admonition example">
-<p class="admonition-title">Example</p>
-<div class="highlight"><pre><span></span><code><span class="n">authorization_url</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">get_authorization_url</span><span class="p">(</span>
-    <span class="s2">&quot;https://www.tintagel.bt/oauth-callback&quot;</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;SCOPE1&quot;</span><span class="p">,</span> <span class="s2">&quot;SCOPE2&quot;</span><span class="p">,</span> <span class="s2">&quot;SCOPE3&quot;</span><span class="p">],</span>
-<span class="p">)</span>
-</code></pre></div>
-</div>
-<h4 id="get_access_token"><code>get_access_token</code><a class="headerlink" href="#get_access_token" title="Permanent link">&para;</a></h4>
-<p>Returns an <a href="#oauth2token-class"><code>OAuth2Token</code> object</a> for the service given the authorization code passed in the redirection callback.</p>
-<p>Raises a <code>GetAccessTokenError</code> if an error occurs.</p>
-<div class="admonition abstract">
-<p class="admonition-title">Parameters</p>
-<ul>
-<li><code>code: str</code>: The authorization code passed in the redirection callback.</li>
-<li><code>redirect_uri: str</code>: The exact same <code>redirect_uri</code> you passed to the authorization URL.</li>
-<li><code>code_verifier: Optional[str]</code>: Optional code verifier in a <a href="https://datatracker.ietf.org/doc/html/rfc7636">PKCE context</a>.</li>
-</ul>
-</div>
-<div class="admonition example">
-<p class="admonition-title">Example</p>
-<div class="highlight"><pre><span></span><code><span class="n">access_token</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">get_access_token</span><span class="p">(</span><span class="s2">&quot;CODE&quot;</span><span class="p">,</span> <span class="s2">&quot;https://www.tintagel.bt/oauth-callback&quot;</span><span class="p">)</span>
-</code></pre></div>
-</div>
-<h4 id="refresh_token"><code>refresh_token</code><a class="headerlink" href="#refresh_token" title="Permanent link">&para;</a></h4>
-<p>Returns a fresh <a href="#oauth2token-class"><code>OAuth2Token</code> object</a> for the service given a refresh token.</p>
-<p>Raises a <code>RefreshTokenNotSupportedError</code> if no <code>refresh_token_endpoint</code> was provided.</p>
-<div class="admonition abstract">
-<p class="admonition-title">Parameters</p>
-<ul>
-<li><code>refresh_token: str</code>: A valid refresh token for the service.</li>
-</ul>
-</div>
-<div class="admonition example">
-<p class="admonition-title">Example</p>
-<div class="highlight"><pre><span></span><code><span class="n">access_token</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">refresh_token</span><span class="p">(</span><span class="s2">&quot;REFRESH_TOKEN&quot;</span><span class="p">)</span>
-</code></pre></div>
-</div>
-<h4 id="revoke_token"><code>revoke_token</code><a class="headerlink" href="#revoke_token" title="Permanent link">&para;</a></h4>
-<p>Revokes a token.</p>
-<p>Raises a <code>RevokeTokenNotSupportedError</code> if no <code>revoke_token_endpoint</code> was provided.</p>
-<div class="admonition abstract">
-<p class="admonition-title">Parameters</p>
-<ul>
-<li><code>token: str</code>: A token or refresh token to revoke.</li>
-<li><code>token_type_hint: str = None</code>: Optional hint for the service to help it determine if it's a token or refresh token. Usually either <code>token</code> or <code>refresh_token</code>.</li>
-</ul>
-</div>
-<div class="admonition example">
-<p class="admonition-title">Example</p>
-<div class="highlight"><pre><span></span><code><span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">revoke_token</span><span class="p">(</span><span class="s2">&quot;TOKEN&quot;</span><span class="p">)</span>
-</code></pre></div>
-</div>
-<h4 id="get_id_email"><code>get_id_email</code><a class="headerlink" href="#get_id_email" title="Permanent link">&para;</a></h4>
-<p>Returns the id and the email (if available) of the authenticated user from the API provider. <strong>It assumes you have asked for the required scopes</strong>.</p>
-<p>Raises a <code>GetIdEmailError</code> if an error occurs.</p>
-<div class="admonition abstract">
-<p class="admonition-title">Parameters</p>
-<ul>
-<li><code>token: str</code>: A valid access token.</li>
-</ul>
-</div>
-<div class="admonition example">
-<p class="admonition-title">Example</p>
-<div class="highlight"><pre><span></span><code><span class="n">user_id</span><span class="p">,</span> <span class="n">user_email</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">get_id_email</span><span class="p">(</span><span class="s2">&quot;TOKEN&quot;</span><span class="p">)</span>
-</code></pre></div>
-</div>
-<h3 id="oauth2token-class"><code>OAuth2Token</code> class<a class="headerlink" href="#oauth2token-class" title="Permanent link">&para;</a></h3>
-<p>This class is a wrapper around a standard <code>Dict[str, Any]</code> that bears the response of <code>get_access_token</code>. Properties can vary greatly from a service to another but, usually, you can get access token like this:</p>
-<div class="highlight"><pre><span></span><code><span class="n">access_token</span> <span class="o">=</span> <span class="n">token</span><span class="p">[</span><span class="s2">&quot;access_token&quot;</span><span class="p">]</span>
-</code></pre></div>
-<h4 id="is_expired"><code>is_expired</code><a class="headerlink" href="#is_expired" title="Permanent link">&para;</a></h4>
-<p>A utility method is provided to quickly determine if the token is still valid or needs to be refreshed.</p>
-<div class="admonition example">
-<p class="admonition-title">Example</p>
-<div class="highlight"><pre><span></span><code><span class="k">if</span> <span class="n">token</span><span class="o">.</span><span class="n">is_expired</span><span class="p">():</span>
-    <span class="n">token</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">refresh_token</span><span class="p">(</span><span class="n">token</span><span class="p">[</span><span class="s2">&quot;refresh_token&quot;</span><span class="p">])</span>
-    <span class="c1"># Save token to DB</span>
-
-<span class="n">access_token</span> <span class="o">=</span> <span class="n">token</span><span class="p">[</span><span class="s2">&quot;access_token&quot;</span><span class="p">]</span>
-<span class="c1"># Do something useful with this access token</span>
-</code></pre></div>
-</div>
-<h2 id="provided-clients">Provided clients<a class="headerlink" href="#provided-clients" title="Permanent link">&para;</a></h2>
-<p>We provide several ready-to-use clients for widely used services with configured endpoints and specificites took into account.</p>
-<h3 id="openid">OpenID<a class="headerlink" href="#openid" title="Permanent link">&para;</a></h3>
-<p>Generic client for providers following the <a href="https://openid.net/connect/">OpenID Connect protocol</a>. Besides the Client ID and the Client Secret, you'll have to provide the OpenID configuration endpoint, allowing the client to discover the required endpoints automatically. By convention, it's usually served under the path <code>.well-known/openid-configuration</code>.</p>
-<div class="highlight"><pre><span></span><code><span class="kn">from</span> <span class="nn">httpx_oauth.clients.openid</span> <span class="kn">import</span> <span class="n">OpenID</span>
-
-<span class="n">client</span> <span class="o">=</span> <span class="n">OpenID</span><span class="p">(</span><span class="s2">&quot;CLIENT_ID&quot;</span><span class="p">,</span> <span class="s2">&quot;CLIENT_SECRET&quot;</span><span class="p">,</span> <span class="s2">&quot;https://example.fief.dev/.well-known/openid-configuration&quot;</span><span class="p">)</span>
-</code></pre></div>
-<ul>
-<li>❓ <code>refresh_token</code>: depends if the OpenID provider supports it</li>
-<li>❓ <code>revoke_token</code>: depends if the OpenID provider supports it</li>
-</ul>
-<h3 id="discord">Discord<a class="headerlink" href="#discord" title="Permanent link">&para;</a></h3>
-<div class="highlight"><pre><span></span><code><span class="kn">from</span> <span class="nn">httpx_oauth.clients.discord</span> <span class="kn">import</span> <span class="n">DiscordOAuth2</span>
-
-<span class="n">client</span> <span class="o">=</span> <span class="n">DiscordOAuth2</span><span class="p">(</span><span class="s2">&quot;CLIENT_ID&quot;</span><span class="p">,</span> <span class="s2">&quot;CLIENT_SECRET&quot;</span><span class="p">)</span>
-</code></pre></div>
-<ul>
-<li>✅ <code>refresh_token</code></li>
-<li>✅ <code>revoke_token</code></li>
-</ul>
-<div class="admonition warning">
-<p class="admonition-title">Warning about <code>get_id_email</code></p>
-<p>Email is optional for Discord accounts, so the email might be <code>None</code>.</p>
-</div>
-<h3 id="facebook">Facebook<a class="headerlink" href="#facebook" title="Permanent link">&para;</a></h3>
-<div class="highlight"><pre><span></span><code><span class="kn">from</span> <span class="nn">httpx_oauth.clients.facebook</span> <span class="kn">import</span> <span class="n">FacebookOAuth2</span>
-
-<span class="n">client</span> <span class="o">=</span> <span class="n">FacebookOAuth2</span><span class="p">(</span><span class="s2">&quot;CLIENT_ID&quot;</span><span class="p">,</span> <span class="s2">&quot;CLIENT_SECRET&quot;</span><span class="p">)</span>
-</code></pre></div>
-<ul>
-<li>❌ <code>refresh_token</code></li>
-<li>❌ <code>revoke_token</code></li>
-</ul>
-<h4 id="get_long_lived_access_token"><code>get_long_lived_access_token</code><a class="headerlink" href="#get_long_lived_access_token" title="Permanent link">&para;</a></h4>
-<p>Returns an <a href="#oauth2token-class"><code>OAuth2Token</code> object</a> with a <a href="https://developers.facebook.com/docs/facebook-login/access-tokens/refreshing/"><strong>long-lived access token</strong></a> given a short-lived access token.</p>
-<p>Raises a <code>GetLongLivedAccessTokenError</code> if an error occurs.</p>
-<div class="admonition abstract">
-<p class="admonition-title">Parameters</p>
-<ul>
-<li><code>token: str</code>: A short-lived access token given by <code>get_access_token</code>.</li>
-</ul>
-</div>
-<div class="admonition example">
-<p class="admonition-title">Example</p>
-<div class="highlight"><pre><span></span><code><span class="n">long_lived_access_token</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">get_long_lived_access_token</span><span class="p">(</span><span class="s2">&quot;TOKEN&quot;</span><span class="p">)</span>
-</code></pre></div>
-</div>
-<h3 id="github">GitHub<a class="headerlink" href="#github" title="Permanent link">&para;</a></h3>
-<div class="highlight"><pre><span></span><code><span class="kn">from</span> <span class="nn">httpx_oauth.clients.github</span> <span class="kn">import</span> <span class="n">GitHubOAuth2</span>
-
-<span class="n">client</span> <span class="o">=</span> <span class="n">GitHubOAuth2</span><span class="p">(</span><span class="s2">&quot;CLIENT_ID&quot;</span><span class="p">,</span> <span class="s2">&quot;CLIENT_SECRET&quot;</span><span class="p">)</span>
-</code></pre></div>
-<ul>
-<li>✅ <code>refresh_token</code></li>
-<li>❌ <code>revoke_token</code></li>
-</ul>
-<div class="admonition tip">
-<p class="admonition-title">Tip</p>
-<p>You should enable <strong>Email addresses</strong> permission in the <strong>Permissions &amp; events</strong> section of your GitHub app parameters. You can find it at <a href="https://github.com/settings/apps/{YOUR_APP}/permissions">https://github.com/settings/apps/{YOUR_APP}/permissions</a>.</p>
-</div>
-<div class="admonition warning">
-<p class="admonition-title">Refresh tokens are not enabled by default</p>
-<p>Refresh tokens are currently an optional feature you need to enable in your GitHub app parameters. <a href="https://docs.github.com/en/apps/creating-github-apps/authenticating-with-a-github-app/refreshing-user-access-tokens">Read more</a>.</p>
-</div>
-<h3 id="google">Google<a class="headerlink" href="#google" title="Permanent link">&para;</a></h3>
-<div class="highlight"><pre><span></span><code><span class="kn">from</span> <span class="nn">httpx_oauth.clients.google</span> <span class="kn">import</span> <span class="n">GoogleOAuth2</span>
-
-<span class="n">client</span> <span class="o">=</span> <span class="n">GoogleOAuth2</span><span class="p">(</span><span class="s2">&quot;CLIENT_ID&quot;</span><span class="p">,</span> <span class="s2">&quot;CLIENT_SECRET&quot;</span><span class="p">)</span>
-</code></pre></div>
-<ul>
-<li>✅ <code>refresh_token</code></li>
-<li>✅ <code>revoke_token</code></li>
-</ul>
-<h3 id="kakao">Kakao<a class="headerlink" href="#kakao" title="Permanent link">&para;</a></h3>
-<div class="highlight"><pre><span></span><code><span class="kn">from</span> <span class="nn">httpx_oauth.clients.kakao</span> <span class="kn">import</span> <span class="n">KakaoOAuth2</span>
-
-<span class="n">client</span> <span class="o">=</span> <span class="n">KakaoOAuth2</span><span class="p">(</span><span class="s2">&quot;CLIENT_ID&quot;</span><span class="p">,</span> <span class="s2">&quot;CLIENT_SECRET&quot;</span><span class="p">)</span>
-</code></pre></div>
-<ul>
-<li>✅ <code>refresh_token</code></li>
-<li>✅ <code>revoke_token</code></li>
-</ul>
-<h3 id="linkedin">LinkedIn<a class="headerlink" href="#linkedin" title="Permanent link">&para;</a></h3>
-<div class="highlight"><pre><span></span><code><span class="kn">from</span> <span class="nn">httpx_oauth.clients.linkedin</span> <span class="kn">import</span> <span class="n">LinkedInOAuth2</span>
-
-<span class="n">client</span> <span class="o">=</span> <span class="n">LinkedInOAuth2</span><span class="p">(</span><span class="s2">&quot;CLIENT_ID&quot;</span><span class="p">,</span> <span class="s2">&quot;CLIENT_SECRET&quot;</span><span class="p">)</span>
-</code></pre></div>
-<ul>
-<li>✅ <code>refresh_token</code> (only for <a href="https://docs.microsoft.com/en-us/linkedin/shared/authentication/programmatic-refresh-tokens">selected partners</a>)</li>
-<li>❌ <code>revoke_token</code></li>
-</ul>
-<h3 id="naver">NAVER<a class="headerlink" href="#naver" title="Permanent link">&para;</a></h3>
-<div class="highlight"><pre><span></span><code><span class="kn">from</span> <span class="nn">httpx_oauth.clients.naver</span> <span class="kn">import</span> <span class="n">NaverOAuth2</span>
-
-<span class="n">client</span> <span class="o">=</span> <span class="n">NaverOAuth2</span><span class="p">(</span><span class="s2">&quot;CLIENT_ID&quot;</span><span class="p">,</span> <span class="s2">&quot;CLIENT_SECRET&quot;</span><span class="p">)</span>
-</code></pre></div>
-<ul>
-<li>✅ <code>refresh_token</code></li>
-<li>✅ <code>revoke_token</code></li>
-</ul>
-<h3 id="okta">Okta<a class="headerlink" href="#okta" title="Permanent link">&para;</a></h3>
-<p>Based on the <a href="#openid">OpenID client</a>. You need to provide the domain of your Okta domain for automatically discovering the required endpoints.</p>
-<div class="highlight"><pre><span></span><code><span class="kn">from</span> <span class="nn">httpx_oauth.clients.okta</span> <span class="kn">import</span> <span class="n">OktaOAuth2</span>
-
-<span class="n">client</span> <span class="o">=</span> <span class="n">OktaOAuth2</span><span class="p">(</span><span class="s2">&quot;CLIENT_ID&quot;</span><span class="p">,</span> <span class="s2">&quot;CLIENT_SECRET&quot;</span><span class="p">,</span> <span class="s2">&quot;example.okta.com&quot;</span><span class="p">)</span>
-</code></pre></div>
-<ul>
-<li>✅ <code>refresh_token</code></li>
-<li>✅ <code>revoke_token</code></li>
-</ul>
-<h3 id="reddit">Reddit<a class="headerlink" href="#reddit" title="Permanent link">&para;</a></h3>
-<div class="highlight"><pre><span></span><code><span class="kn">from</span> <span class="nn">httpx_oauth.clients.reddit</span> <span class="kn">import</span> <span class="n">RedditOAuth2</span>
-
-<span class="n">client</span> <span class="o">=</span> <span class="n">RedditOAuth2</span><span class="p">(</span><span class="s2">&quot;CLIENT_ID&quot;</span><span class="p">,</span> <span class="s2">&quot;CLIENT_SECRET&quot;</span><span class="p">)</span>
-</code></pre></div>
-<ul>
-<li>✅ <code>refresh_token</code></li>
-<li>✅ <code>revoke_token</code></li>
-</ul>
-<div class="admonition warning">
-<p class="admonition-title">Warning about <code>get_id_email</code></p>
-<p>Reddit API never return email addresses. Thus, e-mail will <em>always</em> be <code>None</code>.</p>
-</div>
-<h3 id="franceconnect">FranceConnect<a class="headerlink" href="#franceconnect" title="Permanent link">&para;</a></h3>
-<div class="highlight"><pre><span></span><code><span class="kn">from</span> <span class="nn">httpx_oauth.clients.franceconnect</span> <span class="kn">import</span> <span class="n">FranceConnectOAuth2</span>
-
-<span class="n">client</span> <span class="o">=</span> <span class="n">FranceConnectOAuth2</span><span class="p">(</span><span class="s2">&quot;CLIENT_ID&quot;</span><span class="p">,</span> <span class="s2">&quot;CLIENT_SECRET&quot;</span><span class="p">)</span>
-</code></pre></div>
-<ul>
-<li>❌ <code>refresh_token</code></li>
-<li>❌ <code>revoke_token</code></li>
-</ul>
-<div class="admonition tip">
-<p class="admonition-title">Integration server</p>
-<p>Since you need to go through a <a href="https://partenaires.franceconnect.gouv.fr/monprojet/cadrage">heavy validation process</a> before getting your client ID and secret, you can use during development the <a href="https://partenaires.franceconnect.gouv.fr/fcp/fournisseur-service">integration server with demo credentials</a>. You can enable this mode by setting the <code>integration</code> flag to <code>True</code>.</p>
-<div class="highlight"><pre><span></span><code><span class="kn">from</span> <span class="nn">httpx_oauth.clients.franceconnect</span> <span class="kn">import</span> <span class="n">FranceConnectOAuth2</span>
-
-<span class="n">client</span> <span class="o">=</span> <span class="n">FranceConnectOAuth2</span><span class="p">(</span><span class="s2">&quot;CLIENT_ID&quot;</span><span class="p">,</span> <span class="s2">&quot;CLIENT_SECRET&quot;</span><span class="p">,</span> <span class="n">integration</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-</code></pre></div>
-</div>
-<h3 id="shopify">Shopify<a class="headerlink" href="#shopify" title="Permanent link">&para;</a></h3>
-<p>The OAuth2 client for Shopify allows you to authenticate shop owners so your app can make calls to the <a href="https://shopify.dev/docs/api/admin">Shopify Admin API</a>. Besides the Client ID and Secret, you'll need the <strong>shop subdomain</strong> of the shop you need to access.</p>
-<div class="highlight"><pre><span></span><code><span class="kn">from</span> <span class="nn">httpx_oauth.clients.shopify</span> <span class="kn">import</span> <span class="n">ShopifyOAuth2</span>
-
-<span class="n">client</span> <span class="o">=</span> <span class="n">ShopifyOAuth2</span><span class="p">(</span><span class="s2">&quot;CLIENT_ID&quot;</span><span class="p">,</span> <span class="s2">&quot;CLIENT_SECRET&quot;</span><span class="p">,</span> <span class="s2">&quot;my-shop&quot;</span><span class="p">)</span>
-</code></pre></div>
-<ul>
-<li>❌ <code>refresh_token</code></li>
-<li>❌ <code>revoke_token</code></li>
-</ul>
-<div class="admonition warning">
-<p class="admonition-title"><code>get_id_email</code> is based on the <code>Shop</code> resource</p>
-<p>The implementation of <code>get_id_email</code> calls the <a href="https://shopify.dev/docs/api/admin-rest/2023-04/resources/shop#get-shop">Get Shop endpoint</a> of the Shopify Admin API. It means that it'll return you the <strong>ID of the shop</strong> and the <strong>email of the shop owner</strong>.</p>
-</div>
-<h2 id="customize-httpx-client">Customize HTTPX client<a class="headerlink" href="#customize-httpx-client" title="Permanent link">&para;</a></h2>
-<p>By default, requests are made using <a href="https://www.python-httpx.org/api/#asyncclient"><code>httpx.AsyncClient</code></a> with default parameters. If you wish to customize settings, like setting timeout or proxies, you can do this by overloading the <code>get_httpx_client</code> method.</p>
-<div class="highlight"><pre><span></span><code><span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">AsyncContextManager</span>
-
-<span class="kn">import</span> <span class="nn">httpx</span>
-<span class="kn">from</span> <span class="nn">httpx_oauth.oauth2</span> <span class="kn">import</span> <span class="n">OAuth2</span>
-
-
-<span class="k">class</span> <span class="nc">OAuth2CustomTimeout</span><span class="p">(</span><span class="n">OAuth2</span><span class="p">):</span>
-    <span class="k">def</span> <span class="nf">get_httpx_client</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">AsyncContextManager</span><span class="p">[</span><span class="n">httpx</span><span class="o">.</span><span class="n">AsyncClient</span><span class="p">]:</span>
-        <span class="k">return</span> <span class="n">httpx</span><span class="o">.</span><span class="n">AsyncClient</span><span class="p">(</span><span class="n">timeout</span><span class="o">=</span><span class="mf">10.0</span><span class="p">)</span>  <span class="c1"># Use a default 10s timeout everywhere.</span>
-
-
-<span class="n">client</span> <span class="o">=</span> <span class="n">OAuth2CustomTimeout</span><span class="p">(</span>
-    <span class="s2">&quot;CLIENT_ID&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;CLIENT_SECRET&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;AUTHORIZE_ENDPOINT&quot;</span><span class="p">,</span>
-    <span class="s2">&quot;ACCESS_TOKEN_ENDPOINT&quot;</span><span class="p">,</span>
-    <span class="n">refresh_token_endpoint</span><span class="o">=</span><span class="s2">&quot;REFRESH_TOKEN_ENDPOINT&quot;</span><span class="p">,</span>
-    <span class="n">revoke_token_endpoint</span><span class="o">=</span><span class="s2">&quot;REVOKE_TOKEN_ENDPOINT&quot;</span><span class="p">,</span>
-<span class="p">)</span>
-</code></pre></div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-      </main>
-      
-        <footer class="md-footer">
-  
-  <div class="md-footer-meta md-typeset">
-    <div class="md-footer-meta__inner md-grid">
-      <div class="md-copyright">
-  
-  
-    Made with
-    <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
-      Material for MkDocs
-    </a>
-  
-</div>
-      
-    </div>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "..", "features": [], "search": "../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
-    
-    
-      <script src="../assets/javascripts/bundle.fe8b6f2b.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/objects.inv b/objects.inv
new file mode 100644
index 0000000000000000000000000000000000000000..460668ffe40b02dd4823ac740b1cf3cd8c4adb6b
GIT binary patch
literal 1157
zcmV;01bX`;AX9K?X>NERX>N99Zgg*Qc_4OWa&u{KZXhxWBOp+6Z)#;@bUGkNR8&w{
zAWuPcbZ81AAXa5^b7^mGIv_AEFfK3(BOp|0Wgv28ZDDC{WMy(7Z)PBLXlZjGW@&6?
zAZc?TV{dJ6a%FRKWn>_Ab7^j8AbM<RVlE1J+QphrQ=32>hVT6pnX%X6)MIZ}tvapR
zQ4hT_2%E5z$kN@#(SG^@3;6@PgoO787hqz1pJm~FASAKY>ANq2Ovhfh;w;h1i?|Af
zjArS_w^tEmD>nN&lWfi;OG0)UxBuhx<n!#yr`R3keGe3SIM4rbR-}fjK&jc8BeYze
zou0H`+m7kxU7B?hIe0&Iay{SY3D>?~0OnZ|YAzBqW5Ki^gdtPP*J8;Ma#p@2B>xu_
z06&u}Y9Nn%_8M?fP97$iis@%ivbP*T!MSGoHo7V%>Pku>_t%KMhb%4FYPU+8*ISwP
z5zK>-y$G>H_@K@jO$ck?k7@&^1V=Jh3N8wb7CLD(V(3C*)zC#+iDcog_#2BxoK*rV
zxlw2@tx401$um3o$o^(b>7JwLkcuU)*8raD*&RqWId<fN>o|KssMsWpCgKV=-PuwP
zfa{y=1$Gs%q=K&iHUf?Pog^CbyKq?R+b9I$wPVoItteyb#(OjqR=#t%U)yO8xDbon
za0u6xN#nWB;3jlkHGp!3b6q<X?K%sA$aO9fk?R~du<I-o3fEaNXxA-+WgrmcFM~$w
zzM)N5eZ&7*EMdiOWrAzp&ZjB8gF{n!I}BU+HiMw<HVC@xE1oP_#1ll{>#Wf#zXnd%
z`t=Zgl^eGStox2+umM~Y8V_{RXl&4h#5%!6A~1s+MdgPPKl;4#PzojH8sVgM*l1GP
z5T~=!W(;@r*0l`M7$&D~0N7D`U^J@g1En!m4>DF<dw>M~+Dk-hED7G2MEIl(8qFn!
zHl0Td|Grql)X~ZW+oGLMBM1kF#tC*9Rs(GYLGx`8lCpb`WiIT=X(P-|7E2u<EK}ro
z5BUPtx<(?nbIo*`##t#eeY2skZEF$;y4FUZn`Q_pOKvas*K3_-P0B-fRA)J8<$ECg
zGPJQS;}veY>v%o86MbF3dvF0V+s;F)Y$uyYWNikK##$h-#CGy26xIO11-6}kA(A;?
zWU@R6jd~nSkSvNg<WYu68ckXiE*H#sSpd+Tlr3-H04B0#HGuJ+d{w~5as|8fv!sHZ
zX(P~>(@CQ7rwfO*sEtD4Qac81R27Sq&p!~ttD;6TUd@}%IQ0mg%o?TuYc5y<b_R_G
zI#@I!a09U_uyY7x-~yp^usQX6m|(j<?jUzB2j<>9KmYzy&Hy0S$fn0m*QT-uSfw{O
z>afc9k3Fj82gV;&?86ubb-91^;q^Tv`@qKTiSE4JKQi-<E5(z=)-%*%>~}0bpb>^}
zFZ5HErb22Kp|dw7i~=1DOSvd@xfvlQ6}g}GheLxR8=stpXL(%t>^<fA4K3o7@A!>1
XAaVQDM5VjF*ccu-aJ2scyls~q(U})E

literal 0
HcmV?d00001

diff --git a/reference/httpx_oauth.clients/index.html b/reference/httpx_oauth.clients/index.html
new file mode 100644
index 0000000..4613b8d
--- /dev/null
+++ b/reference/httpx_oauth.clients/index.html
@@ -0,0 +1,12616 @@
+
+<!doctype html>
+<html lang="en" class="no-js">
+  <head>
+    
+      <meta charset="utf-8">
+      <meta name="viewport" content="width=device-width,initial-scale=1">
+      
+        <meta name="description" content="Async OAuth client using HTTPX">
+      
+      
+      
+      
+        <link rel="prev" href="../../fastapi/">
+      
+      
+        <link rel="next" href="../httpx_oauth.oauth2/">
+      
+      
+      <link rel="icon" href="../../assets/images/favicon.png">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.28">
+    
+    
+      
+        <title>httpx_oauth.clients - HTTPX OAuth</title>
+      
+    
+    
+      <link rel="stylesheet" href="../../assets/stylesheets/main.6543a935.min.css">
+      
+        
+        <link rel="stylesheet" href="../../assets/stylesheets/palette.06af60db.min.css">
+      
+      
+
+
+    
+    
+      
+    
+    
+      
+        
+        
+        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
+        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
+      
+    
+    
+      <link rel="stylesheet" href="../../assets/_mkdocstrings.css">
+    
+      <link rel="stylesheet" href="../../assets/stylesheets/extra.css">
+    
+    <script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
+    
+      
+
+    
+    
+    
+  </head>
+  
+  
+    
+    
+      
+    
+    
+    
+    
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo">
+  
+    
+    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
+    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
+    <label class="md-overlay" for="__drawer"></label>
+    <div data-md-component="skip">
+      
+        
+        <a href="#reference-clients" class="md-skip">
+          Skip to content
+        </a>
+      
+    </div>
+    <div data-md-component="announce">
+      
+    </div>
+    
+    
+      
+
+  
+
+<header class="md-header md-header--shadow" data-md-component="header">
+  <nav class="md-header__inner md-grid" aria-label="Header">
+    <a href="../.." title="HTTPX OAuth" class="md-header__button md-logo" aria-label="HTTPX OAuth" data-md-component="logo">
+      
+  
+  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 12h7c-.53 4.11-3.28 7.78-7 8.92V12H5V6.3l7-3.11M12 1 3 5v6c0 5.55 3.84 10.73 9 12 5.16-1.27 9-6.45 9-12V5l-9-4Z"/></svg>
+
+    </a>
+    <label class="md-header__button md-icon" for="__drawer">
+      
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
+    </label>
+    <div class="md-header__title" data-md-component="header-title">
+      <div class="md-header__ellipsis">
+        <div class="md-header__topic">
+          <span class="md-ellipsis">
+            HTTPX OAuth
+          </span>
+        </div>
+        <div class="md-header__topic" data-md-component="header-topic">
+          <span class="md-ellipsis">
+            
+              httpx_oauth.clients
+            
+          </span>
+        </div>
+      </div>
+    </div>
+    
+      
+        <form class="md-header__option" data-md-component="palette">
+  
+    
+    
+    
+    <input class="md-option" data-md-color-media="(prefers-color-scheme)" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo"  aria-label="Switch to light mode"  type="radio" name="__palette" id="__palette_0">
+    
+      <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_1" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m14.3 16-.7-2h-3.2l-.7 2H7.8L11 7h2l3.2 9h-1.9M20 8.69V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69m-9.15 3.96h2.3L12 9l-1.15 3.65Z"/></svg>
+      </label>
+    
+  
+    
+    
+    
+    <input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="blue-grey"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_1">
+    
+      <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_2" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
+      </label>
+    
+  
+    
+    
+    
+    <input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="blue-grey" data-md-color-accent="blue-grey"  aria-label="Switch to light mode"  type="radio" name="__palette" id="__palette_2">
+    
+      <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_0" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12c0-2.42-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
+      </label>
+    
+  
+</form>
+      
+    
+    
+      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
+    
+    
+    
+      <label class="md-header__button md-icon" for="__search">
+        
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
+      </label>
+      <div class="md-search" data-md-component="search" role="dialog">
+  <label class="md-search__overlay" for="__search"></label>
+  <div class="md-search__inner" role="search">
+    <form class="md-search__form" name="search">
+      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
+      <label class="md-search__icon md-icon" for="__search">
+        
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
+        
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
+      </label>
+      <nav class="md-search__options" aria-label="Search">
+        
+        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
+          
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
+        </button>
+      </nav>
+      
+    </form>
+    <div class="md-search__output">
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
+        <div class="md-search-result" data-md-component="search-result">
+          <div class="md-search-result__meta">
+            Initializing search
+          </div>
+          <ol class="md-search-result__list" role="presentation"></ol>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>
+    
+    
+      <div class="md-header__source">
+        <a href="https://github.com/frankie567/httpx-oauth" title="Go to repository" class="md-source" data-md-component="source">
+  <div class="md-source__icon md-icon">
+    
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
+  </div>
+  <div class="md-source__repository">
+    frankie567/httpx-oauth
+  </div>
+</a>
+      </div>
+    
+  </nav>
+  
+</header>
+    
+    <div class="md-container" data-md-component="container">
+      
+      
+        
+          
+        
+      
+      <main class="md-main" data-md-component="main">
+        <div class="md-main__inner md-grid">
+          
+            
+              
+              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+                    
+
+
+
+<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
+  <label class="md-nav__title" for="__drawer">
+    <a href="../.." title="HTTPX OAuth" class="md-nav__button md-logo" aria-label="HTTPX OAuth" data-md-component="logo">
+      
+  
+  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 12h7c-.53 4.11-3.28 7.78-7 8.92V12H5V6.3l7-3.11M12 1 3 5v6c0 5.55 3.84 10.73 9 12 5.16-1.27 9-6.45 9-12V5l-9-4Z"/></svg>
+
+    </a>
+    HTTPX OAuth
+  </label>
+  
+    <div class="md-nav__source">
+      <a href="https://github.com/frankie567/httpx-oauth" title="Go to repository" class="md-source" data-md-component="source">
+  <div class="md-source__icon md-icon">
+    
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
+  </div>
+  <div class="md-source__repository">
+    frankie567/httpx-oauth
+  </div>
+</a>
+    </div>
+  
+  <ul class="md-nav__list" data-md-scrollfix>
+    
+      
+      
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../.." class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    About
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../usage/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Usage
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+  
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
+        
+          
+          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
+            
+  
+  <span class="md-ellipsis">
+    Integrations
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_3">
+            <span class="md-nav__icon md-icon"></span>
+            Integrations
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../fastapi/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    FastAPI
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+    
+  
+  
+  
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" checked>
+        
+          
+          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
+            
+  
+  <span class="md-ellipsis">
+    Reference
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_4">
+            <span class="md-nav__icon md-icon"></span>
+            Reference
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+    
+  
+  
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+        
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    httpx_oauth.clients
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
+        
+  
+  <span class="md-ellipsis">
+    httpx_oauth.clients
+  </span>
+  
+
+      </a>
+      
+        
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+    
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#discord" class="md-nav__link">
+    <span class="md-ellipsis">
+      Discord
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Discord">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.discord" class="md-nav__link">
+    <span class="md-ellipsis">
+      discord
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.discord.DiscordOAuth2" class="md-nav__link">
+    <span class="md-ellipsis">
+      DiscordOAuth2
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="DiscordOAuth2">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.discord.DiscordOAuth2.__init__" class="md-nav__link">
+    <span class="md-ellipsis">
+      __init__
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.discord.DiscordOAuth2.get_access_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_access_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.discord.DiscordOAuth2.get_authorization_url" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_authorization_url
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.discord.DiscordOAuth2.get_id_email" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_id_email
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.discord.DiscordOAuth2.refresh_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      refresh_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.discord.DiscordOAuth2.revoke_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      revoke_token
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#facebook" class="md-nav__link">
+    <span class="md-ellipsis">
+      Facebook
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Facebook">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.facebook" class="md-nav__link">
+    <span class="md-ellipsis">
+      facebook
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="facebook">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.facebook.FacebookOAuth2" class="md-nav__link">
+    <span class="md-ellipsis">
+      FacebookOAuth2
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="FacebookOAuth2">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.facebook.FacebookOAuth2.__init__" class="md-nav__link">
+    <span class="md-ellipsis">
+      __init__
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.facebook.FacebookOAuth2.get_access_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_access_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.facebook.FacebookOAuth2.get_authorization_url" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_authorization_url
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.facebook.FacebookOAuth2.get_id_email" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_id_email
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.facebook.FacebookOAuth2.get_long_lived_access_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_long_lived_access_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.facebook.FacebookOAuth2.refresh_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      refresh_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.facebook.FacebookOAuth2.revoke_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      revoke_token
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#github" class="md-nav__link">
+    <span class="md-ellipsis">
+      GitHub
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="GitHub">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.github" class="md-nav__link">
+    <span class="md-ellipsis">
+      github
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="github">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.github.GitHubOAuth2" class="md-nav__link">
+    <span class="md-ellipsis">
+      GitHubOAuth2
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="GitHubOAuth2">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.github.GitHubOAuth2.__init__" class="md-nav__link">
+    <span class="md-ellipsis">
+      __init__
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.github.GitHubOAuth2.get_access_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_access_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.github.GitHubOAuth2.get_authorization_url" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_authorization_url
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.github.GitHubOAuth2.get_id_email" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_id_email
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.github.GitHubOAuth2.refresh_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      refresh_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.github.GitHubOAuth2.revoke_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      revoke_token
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#google" class="md-nav__link">
+    <span class="md-ellipsis">
+      Google
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Google">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.google" class="md-nav__link">
+    <span class="md-ellipsis">
+      google
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="google">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.google.GoogleOAuth2" class="md-nav__link">
+    <span class="md-ellipsis">
+      GoogleOAuth2
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="GoogleOAuth2">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.google.GoogleOAuth2.__init__" class="md-nav__link">
+    <span class="md-ellipsis">
+      __init__
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.google.GoogleOAuth2.get_access_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_access_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.google.GoogleOAuth2.get_authorization_url" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_authorization_url
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.google.GoogleOAuth2.get_id_email" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_id_email
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.google.GoogleOAuth2.refresh_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      refresh_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.google.GoogleOAuth2.revoke_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      revoke_token
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#kakao" class="md-nav__link">
+    <span class="md-ellipsis">
+      Kakao
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Kakao">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.kakao" class="md-nav__link">
+    <span class="md-ellipsis">
+      kakao
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="kakao">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.kakao.KakaoOAuth2" class="md-nav__link">
+    <span class="md-ellipsis">
+      KakaoOAuth2
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="KakaoOAuth2">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.kakao.KakaoOAuth2.__init__" class="md-nav__link">
+    <span class="md-ellipsis">
+      __init__
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.kakao.KakaoOAuth2.get_access_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_access_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.kakao.KakaoOAuth2.get_authorization_url" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_authorization_url
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.kakao.KakaoOAuth2.get_id_email" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_id_email
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.kakao.KakaoOAuth2.refresh_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      refresh_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.kakao.KakaoOAuth2.revoke_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      revoke_token
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#linkedin" class="md-nav__link">
+    <span class="md-ellipsis">
+      LinkedIn
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="LinkedIn">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.linkedin" class="md-nav__link">
+    <span class="md-ellipsis">
+      linkedin
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="linkedin">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.linkedin.LinkedInOAuth2" class="md-nav__link">
+    <span class="md-ellipsis">
+      LinkedInOAuth2
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="LinkedInOAuth2">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.linkedin.LinkedInOAuth2.__init__" class="md-nav__link">
+    <span class="md-ellipsis">
+      __init__
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.linkedin.LinkedInOAuth2.get_access_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_access_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.linkedin.LinkedInOAuth2.get_authorization_url" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_authorization_url
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.linkedin.LinkedInOAuth2.get_id_email" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_id_email
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.linkedin.LinkedInOAuth2.refresh_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      refresh_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.linkedin.LinkedInOAuth2.revoke_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      revoke_token
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#microsoft" class="md-nav__link">
+    <span class="md-ellipsis">
+      Microsoft
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Microsoft">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.microsoft" class="md-nav__link">
+    <span class="md-ellipsis">
+      microsoft
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="microsoft">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2" class="md-nav__link">
+    <span class="md-ellipsis">
+      MicrosoftGraphOAuth2
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="MicrosoftGraphOAuth2">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2.__init__" class="md-nav__link">
+    <span class="md-ellipsis">
+      __init__
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2.get_access_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_access_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2.get_authorization_url" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_authorization_url
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2.get_id_email" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_id_email
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2.refresh_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      refresh_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2.revoke_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      revoke_token
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#naver" class="md-nav__link">
+    <span class="md-ellipsis">
+      Naver
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Naver">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.naver" class="md-nav__link">
+    <span class="md-ellipsis">
+      naver
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="naver">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.naver.NaverOAuth2" class="md-nav__link">
+    <span class="md-ellipsis">
+      NaverOAuth2
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="NaverOAuth2">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.naver.NaverOAuth2.__init__" class="md-nav__link">
+    <span class="md-ellipsis">
+      __init__
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.naver.NaverOAuth2.get_access_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_access_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.naver.NaverOAuth2.get_authorization_url" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_authorization_url
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.naver.NaverOAuth2.get_id_email" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_id_email
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.naver.NaverOAuth2.refresh_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      refresh_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.naver.NaverOAuth2.revoke_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      revoke_token
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#okta" class="md-nav__link">
+    <span class="md-ellipsis">
+      Okta
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Okta">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.okta" class="md-nav__link">
+    <span class="md-ellipsis">
+      okta
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="okta">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.okta.OktaOAuth2" class="md-nav__link">
+    <span class="md-ellipsis">
+      OktaOAuth2
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="OktaOAuth2">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.okta.OktaOAuth2.__init__" class="md-nav__link">
+    <span class="md-ellipsis">
+      __init__
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.okta.OktaOAuth2.get_access_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_access_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.okta.OktaOAuth2.get_authorization_url" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_authorization_url
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.okta.OktaOAuth2.get_id_email" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_id_email
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.okta.OktaOAuth2.refresh_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      refresh_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.okta.OktaOAuth2.revoke_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      revoke_token
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#openid" class="md-nav__link">
+    <span class="md-ellipsis">
+      OpenID
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="OpenID">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.openid" class="md-nav__link">
+    <span class="md-ellipsis">
+      openid
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="openid">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.openid.OpenID" class="md-nav__link">
+    <span class="md-ellipsis">
+      OpenID
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="OpenID">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.openid.OpenID.__init__" class="md-nav__link">
+    <span class="md-ellipsis">
+      __init__
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.openid.OpenID.get_access_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_access_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.openid.OpenID.get_authorization_url" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_authorization_url
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.openid.OpenID.get_id_email" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_id_email
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.openid.OpenID.refresh_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      refresh_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.openid.OpenID.revoke_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      revoke_token
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.openid.OpenIDConfigurationError" class="md-nav__link">
+    <span class="md-ellipsis">
+      OpenIDConfigurationError
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#reddit" class="md-nav__link">
+    <span class="md-ellipsis">
+      Reddit
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Reddit">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.reddit" class="md-nav__link">
+    <span class="md-ellipsis">
+      reddit
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="reddit">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.reddit.RedditOAuth2" class="md-nav__link">
+    <span class="md-ellipsis">
+      RedditOAuth2
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="RedditOAuth2">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.reddit.RedditOAuth2.__init__" class="md-nav__link">
+    <span class="md-ellipsis">
+      __init__
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.reddit.RedditOAuth2.get_access_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_access_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.reddit.RedditOAuth2.get_authorization_url" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_authorization_url
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.reddit.RedditOAuth2.get_id_email" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_id_email
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.reddit.RedditOAuth2.refresh_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      refresh_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.reddit.RedditOAuth2.revoke_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      revoke_token
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#shopify" class="md-nav__link">
+    <span class="md-ellipsis">
+      Shopify
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Shopify">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.shopify" class="md-nav__link">
+    <span class="md-ellipsis">
+      shopify
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="shopify">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.shopify.ShopifyOAuth2" class="md-nav__link">
+    <span class="md-ellipsis">
+      ShopifyOAuth2
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="ShopifyOAuth2">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.shopify.ShopifyOAuth2.__init__" class="md-nav__link">
+    <span class="md-ellipsis">
+      __init__
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.shopify.ShopifyOAuth2.get_access_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_access_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.shopify.ShopifyOAuth2.get_authorization_url" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_authorization_url
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.shopify.ShopifyOAuth2.get_id_email" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_id_email
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.shopify.ShopifyOAuth2.refresh_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      refresh_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.shopify.ShopifyOAuth2.revoke_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      revoke_token
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../httpx_oauth.oauth2/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    httpx_oauth.oauth2
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../httpx_oauth.exceptions/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    httpx_oauth.exceptions
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+  </ul>
+</nav>
+                  </div>
+                </div>
+              </div>
+            
+            
+              
+              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+                    
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+    
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#discord" class="md-nav__link">
+    <span class="md-ellipsis">
+      Discord
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Discord">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.discord" class="md-nav__link">
+    <span class="md-ellipsis">
+      discord
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.discord.DiscordOAuth2" class="md-nav__link">
+    <span class="md-ellipsis">
+      DiscordOAuth2
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="DiscordOAuth2">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.discord.DiscordOAuth2.__init__" class="md-nav__link">
+    <span class="md-ellipsis">
+      __init__
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.discord.DiscordOAuth2.get_access_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_access_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.discord.DiscordOAuth2.get_authorization_url" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_authorization_url
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.discord.DiscordOAuth2.get_id_email" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_id_email
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.discord.DiscordOAuth2.refresh_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      refresh_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.discord.DiscordOAuth2.revoke_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      revoke_token
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#facebook" class="md-nav__link">
+    <span class="md-ellipsis">
+      Facebook
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Facebook">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.facebook" class="md-nav__link">
+    <span class="md-ellipsis">
+      facebook
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="facebook">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.facebook.FacebookOAuth2" class="md-nav__link">
+    <span class="md-ellipsis">
+      FacebookOAuth2
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="FacebookOAuth2">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.facebook.FacebookOAuth2.__init__" class="md-nav__link">
+    <span class="md-ellipsis">
+      __init__
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.facebook.FacebookOAuth2.get_access_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_access_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.facebook.FacebookOAuth2.get_authorization_url" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_authorization_url
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.facebook.FacebookOAuth2.get_id_email" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_id_email
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.facebook.FacebookOAuth2.get_long_lived_access_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_long_lived_access_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.facebook.FacebookOAuth2.refresh_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      refresh_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.facebook.FacebookOAuth2.revoke_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      revoke_token
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#github" class="md-nav__link">
+    <span class="md-ellipsis">
+      GitHub
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="GitHub">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.github" class="md-nav__link">
+    <span class="md-ellipsis">
+      github
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="github">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.github.GitHubOAuth2" class="md-nav__link">
+    <span class="md-ellipsis">
+      GitHubOAuth2
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="GitHubOAuth2">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.github.GitHubOAuth2.__init__" class="md-nav__link">
+    <span class="md-ellipsis">
+      __init__
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.github.GitHubOAuth2.get_access_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_access_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.github.GitHubOAuth2.get_authorization_url" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_authorization_url
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.github.GitHubOAuth2.get_id_email" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_id_email
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.github.GitHubOAuth2.refresh_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      refresh_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.github.GitHubOAuth2.revoke_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      revoke_token
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#google" class="md-nav__link">
+    <span class="md-ellipsis">
+      Google
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Google">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.google" class="md-nav__link">
+    <span class="md-ellipsis">
+      google
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="google">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.google.GoogleOAuth2" class="md-nav__link">
+    <span class="md-ellipsis">
+      GoogleOAuth2
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="GoogleOAuth2">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.google.GoogleOAuth2.__init__" class="md-nav__link">
+    <span class="md-ellipsis">
+      __init__
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.google.GoogleOAuth2.get_access_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_access_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.google.GoogleOAuth2.get_authorization_url" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_authorization_url
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.google.GoogleOAuth2.get_id_email" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_id_email
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.google.GoogleOAuth2.refresh_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      refresh_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.google.GoogleOAuth2.revoke_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      revoke_token
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#kakao" class="md-nav__link">
+    <span class="md-ellipsis">
+      Kakao
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Kakao">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.kakao" class="md-nav__link">
+    <span class="md-ellipsis">
+      kakao
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="kakao">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.kakao.KakaoOAuth2" class="md-nav__link">
+    <span class="md-ellipsis">
+      KakaoOAuth2
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="KakaoOAuth2">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.kakao.KakaoOAuth2.__init__" class="md-nav__link">
+    <span class="md-ellipsis">
+      __init__
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.kakao.KakaoOAuth2.get_access_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_access_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.kakao.KakaoOAuth2.get_authorization_url" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_authorization_url
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.kakao.KakaoOAuth2.get_id_email" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_id_email
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.kakao.KakaoOAuth2.refresh_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      refresh_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.kakao.KakaoOAuth2.revoke_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      revoke_token
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#linkedin" class="md-nav__link">
+    <span class="md-ellipsis">
+      LinkedIn
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="LinkedIn">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.linkedin" class="md-nav__link">
+    <span class="md-ellipsis">
+      linkedin
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="linkedin">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.linkedin.LinkedInOAuth2" class="md-nav__link">
+    <span class="md-ellipsis">
+      LinkedInOAuth2
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="LinkedInOAuth2">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.linkedin.LinkedInOAuth2.__init__" class="md-nav__link">
+    <span class="md-ellipsis">
+      __init__
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.linkedin.LinkedInOAuth2.get_access_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_access_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.linkedin.LinkedInOAuth2.get_authorization_url" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_authorization_url
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.linkedin.LinkedInOAuth2.get_id_email" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_id_email
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.linkedin.LinkedInOAuth2.refresh_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      refresh_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.linkedin.LinkedInOAuth2.revoke_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      revoke_token
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#microsoft" class="md-nav__link">
+    <span class="md-ellipsis">
+      Microsoft
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Microsoft">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.microsoft" class="md-nav__link">
+    <span class="md-ellipsis">
+      microsoft
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="microsoft">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2" class="md-nav__link">
+    <span class="md-ellipsis">
+      MicrosoftGraphOAuth2
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="MicrosoftGraphOAuth2">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2.__init__" class="md-nav__link">
+    <span class="md-ellipsis">
+      __init__
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2.get_access_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_access_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2.get_authorization_url" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_authorization_url
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2.get_id_email" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_id_email
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2.refresh_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      refresh_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2.revoke_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      revoke_token
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#naver" class="md-nav__link">
+    <span class="md-ellipsis">
+      Naver
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Naver">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.naver" class="md-nav__link">
+    <span class="md-ellipsis">
+      naver
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="naver">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.naver.NaverOAuth2" class="md-nav__link">
+    <span class="md-ellipsis">
+      NaverOAuth2
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="NaverOAuth2">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.naver.NaverOAuth2.__init__" class="md-nav__link">
+    <span class="md-ellipsis">
+      __init__
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.naver.NaverOAuth2.get_access_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_access_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.naver.NaverOAuth2.get_authorization_url" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_authorization_url
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.naver.NaverOAuth2.get_id_email" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_id_email
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.naver.NaverOAuth2.refresh_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      refresh_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.naver.NaverOAuth2.revoke_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      revoke_token
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#okta" class="md-nav__link">
+    <span class="md-ellipsis">
+      Okta
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Okta">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.okta" class="md-nav__link">
+    <span class="md-ellipsis">
+      okta
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="okta">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.okta.OktaOAuth2" class="md-nav__link">
+    <span class="md-ellipsis">
+      OktaOAuth2
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="OktaOAuth2">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.okta.OktaOAuth2.__init__" class="md-nav__link">
+    <span class="md-ellipsis">
+      __init__
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.okta.OktaOAuth2.get_access_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_access_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.okta.OktaOAuth2.get_authorization_url" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_authorization_url
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.okta.OktaOAuth2.get_id_email" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_id_email
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.okta.OktaOAuth2.refresh_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      refresh_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.okta.OktaOAuth2.revoke_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      revoke_token
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#openid" class="md-nav__link">
+    <span class="md-ellipsis">
+      OpenID
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="OpenID">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.openid" class="md-nav__link">
+    <span class="md-ellipsis">
+      openid
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="openid">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.openid.OpenID" class="md-nav__link">
+    <span class="md-ellipsis">
+      OpenID
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="OpenID">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.openid.OpenID.__init__" class="md-nav__link">
+    <span class="md-ellipsis">
+      __init__
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.openid.OpenID.get_access_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_access_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.openid.OpenID.get_authorization_url" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_authorization_url
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.openid.OpenID.get_id_email" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_id_email
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.openid.OpenID.refresh_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      refresh_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.openid.OpenID.revoke_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      revoke_token
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.openid.OpenIDConfigurationError" class="md-nav__link">
+    <span class="md-ellipsis">
+      OpenIDConfigurationError
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#reddit" class="md-nav__link">
+    <span class="md-ellipsis">
+      Reddit
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Reddit">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.reddit" class="md-nav__link">
+    <span class="md-ellipsis">
+      reddit
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="reddit">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.reddit.RedditOAuth2" class="md-nav__link">
+    <span class="md-ellipsis">
+      RedditOAuth2
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="RedditOAuth2">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.reddit.RedditOAuth2.__init__" class="md-nav__link">
+    <span class="md-ellipsis">
+      __init__
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.reddit.RedditOAuth2.get_access_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_access_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.reddit.RedditOAuth2.get_authorization_url" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_authorization_url
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.reddit.RedditOAuth2.get_id_email" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_id_email
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.reddit.RedditOAuth2.refresh_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      refresh_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.reddit.RedditOAuth2.revoke_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      revoke_token
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#shopify" class="md-nav__link">
+    <span class="md-ellipsis">
+      Shopify
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Shopify">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.shopify" class="md-nav__link">
+    <span class="md-ellipsis">
+      shopify
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="shopify">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.shopify.ShopifyOAuth2" class="md-nav__link">
+    <span class="md-ellipsis">
+      ShopifyOAuth2
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="ShopifyOAuth2">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.shopify.ShopifyOAuth2.__init__" class="md-nav__link">
+    <span class="md-ellipsis">
+      __init__
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.shopify.ShopifyOAuth2.get_access_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_access_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.shopify.ShopifyOAuth2.get_authorization_url" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_authorization_url
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.shopify.ShopifyOAuth2.get_id_email" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_id_email
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.shopify.ShopifyOAuth2.refresh_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      refresh_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.clients.shopify.ShopifyOAuth2.revoke_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      revoke_token
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+                  </div>
+                </div>
+              </div>
+            
+          
+          
+            <div class="md-content" data-md-component="content">
+              <article class="md-content__inner md-typeset">
+                
+                  
+
+
+<h1 id="reference-clients">Reference - Clients<a class="headerlink" href="#reference-clients" title="Permanent link">&para;</a></h1>
+<h2 id="discord">Discord<a class="headerlink" href="#discord" title="Permanent link">&para;</a></h2>
+
+
+<div class="doc doc-object doc-module">
+
+
+
+<a id="httpx_oauth.clients.discord"></a>
+    <div class="doc doc-contents first">
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+<div class="doc doc-object doc-class">
+
+
+
+<h3 id="httpx_oauth.clients.discord.DiscordOAuth2" class="doc doc-heading">
+            <code>DiscordOAuth2</code>
+
+
+<a href="#httpx_oauth.clients.discord.DiscordOAuth2" class="headerlink" title="Permanent link">&para;</a></h3>
+
+
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.BaseOAuth2" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.BaseOAuth2">BaseOAuth2</a>[<a class="autorefs autorefs-external" title="typing.Dict" href="https://docs.python.org/3.8/library/typing.html#typing.Dict">Dict</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>, <a class="autorefs autorefs-external" title="typing.Any" href="https://docs.python.org/3.8/library/typing.html#typing.Any">Any</a>]]</code></p>
+
+
+      <p>OAuth2 client for Discord.</p>
+
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+
+<div class="doc doc-object doc-function">
+
+
+<h4 id="httpx_oauth.clients.discord.DiscordOAuth2.__init__" class="doc doc-heading">
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">client_id</span><span class="p">,</span> <span class="n">client_secret</span><span class="p">,</span> <span class="n">scopes</span><span class="o">=</span><span class="n">BASE_SCOPES</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="s1">&#39;discord&#39;</span><span class="p">)</span></code>
+
+<a href="#httpx_oauth.clients.discord.DiscordOAuth2.__init__" class="headerlink" title="Permanent link">&para;</a></h4>
+
+
+    <div class="doc doc-contents ">
+
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>client_id</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The client ID provided by the OAuth2 provider.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>client_secret</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The client secret provided by the OAuth2 provider.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>scopes</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.List" href="https://docs.python.org/3.8/library/typing.html#typing.List">List</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The default scopes to be used in the authorization URL.</p>
+              </div>
+            </td>
+            <td>
+                  <code><span title="httpx_oauth.clients.discord.BASE_SCOPES">BASE_SCOPES</span></code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>name</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A unique name for the OAuth2 client.</p>
+              </div>
+            </td>
+            <td>
+                  <code>&#39;discord&#39;</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h4 id="httpx_oauth.clients.discord.DiscordOAuth2.get_access_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_access_token</span><span class="p">(</span><span class="n">code</span><span class="p">,</span> <span class="n">redirect_uri</span><span class="p">,</span> <span class="n">code_verifier</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.discord.DiscordOAuth2.get_access_token" class="headerlink" title="Permanent link">&para;</a></h4>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Requests an access token using the authorization code obtained
+after the user has authorized the application.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>code</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The authorization code.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>redirect_uri</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The URL where the user was redirected after authorization.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_verifier</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional code verifier used
+in the <a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> flow.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2Token" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.OAuth2Token">OAuth2Token</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An access token response dictionary.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.GetAccessTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.GetAccessTokenError">GetAccessTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while getting the access token.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">access_token</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">get_access_token</span><span class="p">(</span><span class="s2">&quot;CODE&quot;</span><span class="p">,</span> <span class="s2">&quot;https://www.tintagel.bt/oauth-callback&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h4 id="httpx_oauth.clients.discord.DiscordOAuth2.get_authorization_url" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_authorization_url</span><span class="p">(</span><span class="n">redirect_uri</span><span class="p">,</span> <span class="n">state</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">code_challenge</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">code_challenge_method</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">extras_params</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.discord.DiscordOAuth2.get_authorization_url" class="headerlink" title="Permanent link">&para;</a></h4>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Builds the authorization URL
+where the user should be redirected to authorize the application.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>redirect_uri</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The URL where the user will be redirected after authorization.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>state</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An opaque value used by the client to maintain state</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>scope</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.List" href="https://docs.python.org/3.8/library/typing.html#typing.List">List</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The scopes to be requested.
+If not provided, <code>base_scopes</code> will be used.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_challenge</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional
+<a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> code challenge.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_challenge_method</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.Literal" href="https://docs.python.org/3.8/library/typing.html#typing.Literal">Literal</a>[&#39;plain&#39;, &#39;S256&#39;]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional
+<a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> code challenge
+method.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>extras_params</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<span title="httpx_oauth.oauth2.T">T</span>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional extra parameters specific to the service.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The authorization URL.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <p><code>py
+authorization_url = await client.get_authorization_url(
+    "https://www.tintagel.bt/oauth-callback", scope=["SCOPE1", "SCOPE2", "SCOPE3"],
+)</code>py</p>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h4 id="httpx_oauth.clients.discord.DiscordOAuth2.get_id_email" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_id_email</span><span class="p">(</span><span class="n">token</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.discord.DiscordOAuth2.get_id_email" class="headerlink" title="Permanent link">&para;</a></h4>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Returns the id and the email (if available) of the authenticated user
+from the API provider.</p>
+<p><strong>It assumes you have asked for the required scopes</strong>.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The access token.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Tuple" href="https://docs.python.org/3.8/library/typing.html#typing.Tuple">Tuple</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>, <a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A tuple with the id and the email of the authenticated user.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.exceptions.GetIdEmailError" href="../httpx_oauth.exceptions/#httpx_oauth.exceptions.GetIdEmailError">GetIdEmailError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while getting the id and email.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">user_id</span><span class="p">,</span> <span class="n">user_email</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">get_id_email</span><span class="p">(</span><span class="s2">&quot;TOKEN&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h4 id="httpx_oauth.clients.discord.DiscordOAuth2.refresh_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">refresh_token</span><span class="p">(</span><span class="n">refresh_token</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.discord.DiscordOAuth2.refresh_token" class="headerlink" title="Permanent link">&para;</a></h4>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Requests a new access token using a refresh token.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>refresh_token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The refresh token.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2Token" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.OAuth2Token">OAuth2Token</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An access token response dictionary.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RefreshTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RefreshTokenError">RefreshTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while refreshing the token.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RefreshTokenNotSupportedError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RefreshTokenNotSupportedError">RefreshTokenNotSupportedError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The provider does not support token refresh.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">access_token</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">refresh_token</span><span class="p">(</span><span class="s2">&quot;REFRESH_TOKEN&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h4 id="httpx_oauth.clients.discord.DiscordOAuth2.revoke_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">revoke_token</span><span class="p">(</span><span class="n">token</span><span class="p">,</span> <span class="n">token_type_hint</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.discord.DiscordOAuth2.revoke_token" class="headerlink" title="Permanent link">&para;</a></h4>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Revokes a token.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A token or refresh token to revoke.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>token_type_hint</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional hint for the service to help it determine
+if it's a token or refresh token.
+Usually either <code>token</code> or <code>refresh_token</code>.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code>None</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>None</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RevokeTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RevokeTokenError">RevokeTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while revoking the token.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RevokeTokenNotSupportedError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RevokeTokenNotSupportedError">RevokeTokenNotSupportedError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The provider does not support token revoke.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+    </div>
+
+</div>
+
+
+
+  </div>
+
+    </div>
+
+</div>
+
+
+
+
+  </div>
+
+    </div>
+
+</div><h2 id="facebook">Facebook<a class="headerlink" href="#facebook" title="Permanent link">&para;</a></h2>
+
+
+<div class="doc doc-object doc-module">
+
+
+
+<h3 id="httpx_oauth.clients.facebook" class="doc doc-heading">
+            <code>httpx_oauth.clients.facebook</code>
+
+
+<a href="#httpx_oauth.clients.facebook" class="headerlink" title="Permanent link">&para;</a></h3>
+
+    <div class="doc doc-contents first">
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+<div class="doc doc-object doc-class">
+
+
+
+<h4 id="httpx_oauth.clients.facebook.FacebookOAuth2" class="doc doc-heading">
+            <code>FacebookOAuth2</code>
+
+
+<a href="#httpx_oauth.clients.facebook.FacebookOAuth2" class="headerlink" title="Permanent link">&para;</a></h4>
+
+
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.BaseOAuth2" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.BaseOAuth2">BaseOAuth2</a>[<a class="autorefs autorefs-external" title="typing.Dict" href="https://docs.python.org/3.8/library/typing.html#typing.Dict">Dict</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>, <a class="autorefs autorefs-external" title="typing.Any" href="https://docs.python.org/3.8/library/typing.html#typing.Any">Any</a>]]</code></p>
+
+
+      <p>OAuth2 client for Facebook.</p>
+
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.facebook.FacebookOAuth2.__init__" class="doc doc-heading">
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">client_id</span><span class="p">,</span> <span class="n">client_secret</span><span class="p">,</span> <span class="n">scopes</span><span class="o">=</span><span class="n">BASE_SCOPES</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="s1">&#39;facebook&#39;</span><span class="p">)</span></code>
+
+<a href="#httpx_oauth.clients.facebook.FacebookOAuth2.__init__" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>client_id</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The client ID provided by the OAuth2 provider.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>client_secret</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The client secret provided by the OAuth2 provider.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>scopes</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.List" href="https://docs.python.org/3.8/library/typing.html#typing.List">List</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The default scopes to be used in the authorization URL.</p>
+              </div>
+            </td>
+            <td>
+                  <code><span title="httpx_oauth.clients.facebook.BASE_SCOPES">BASE_SCOPES</span></code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>name</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A unique name for the OAuth2 client.</p>
+              </div>
+            </td>
+            <td>
+                  <code>&#39;facebook&#39;</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.facebook.FacebookOAuth2.get_access_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_access_token</span><span class="p">(</span><span class="n">code</span><span class="p">,</span> <span class="n">redirect_uri</span><span class="p">,</span> <span class="n">code_verifier</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.facebook.FacebookOAuth2.get_access_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Requests an access token using the authorization code obtained
+after the user has authorized the application.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>code</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The authorization code.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>redirect_uri</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The URL where the user was redirected after authorization.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_verifier</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional code verifier used
+in the <a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> flow.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2Token" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.OAuth2Token">OAuth2Token</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An access token response dictionary.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.GetAccessTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.GetAccessTokenError">GetAccessTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while getting the access token.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">access_token</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">get_access_token</span><span class="p">(</span><span class="s2">&quot;CODE&quot;</span><span class="p">,</span> <span class="s2">&quot;https://www.tintagel.bt/oauth-callback&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.facebook.FacebookOAuth2.get_authorization_url" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_authorization_url</span><span class="p">(</span><span class="n">redirect_uri</span><span class="p">,</span> <span class="n">state</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">code_challenge</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">code_challenge_method</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">extras_params</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.facebook.FacebookOAuth2.get_authorization_url" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Builds the authorization URL
+where the user should be redirected to authorize the application.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>redirect_uri</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The URL where the user will be redirected after authorization.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>state</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An opaque value used by the client to maintain state</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>scope</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.List" href="https://docs.python.org/3.8/library/typing.html#typing.List">List</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The scopes to be requested.
+If not provided, <code>base_scopes</code> will be used.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_challenge</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional
+<a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> code challenge.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_challenge_method</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.Literal" href="https://docs.python.org/3.8/library/typing.html#typing.Literal">Literal</a>[&#39;plain&#39;, &#39;S256&#39;]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional
+<a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> code challenge
+method.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>extras_params</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<span title="httpx_oauth.oauth2.T">T</span>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional extra parameters specific to the service.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The authorization URL.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <p><code>py
+authorization_url = await client.get_authorization_url(
+    "https://www.tintagel.bt/oauth-callback", scope=["SCOPE1", "SCOPE2", "SCOPE3"],
+)</code>py</p>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.facebook.FacebookOAuth2.get_id_email" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_id_email</span><span class="p">(</span><span class="n">token</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.facebook.FacebookOAuth2.get_id_email" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Returns the id and the email (if available) of the authenticated user
+from the API provider.</p>
+<p><strong>It assumes you have asked for the required scopes</strong>.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The access token.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Tuple" href="https://docs.python.org/3.8/library/typing.html#typing.Tuple">Tuple</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>, <a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A tuple with the id and the email of the authenticated user.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.exceptions.GetIdEmailError" href="../httpx_oauth.exceptions/#httpx_oauth.exceptions.GetIdEmailError">GetIdEmailError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while getting the id and email.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">user_id</span><span class="p">,</span> <span class="n">user_email</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">get_id_email</span><span class="p">(</span><span class="s2">&quot;TOKEN&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.facebook.FacebookOAuth2.get_long_lived_access_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_long_lived_access_token</span><span class="p">(</span><span class="n">token</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.facebook.FacebookOAuth2.get_long_lived_access_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Request a <a href="https://developers.facebook.com/docs/facebook-login/access-tokens/refreshing/">long-lived access token</a>
+given a short-lived access token.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The short-lived access token.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2Token" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.OAuth2Token">OAuth2Token</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An access token response dictionary.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><span title="httpx_oauth.clients.facebook.GetLongLivedAccessTokenError">GetLongLivedAccessTokenError</span></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while requesting</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">long_lived_access_token</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">get_long_lived_access_token</span><span class="p">(</span><span class="s2">&quot;TOKEN&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.facebook.FacebookOAuth2.refresh_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">refresh_token</span><span class="p">(</span><span class="n">refresh_token</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.facebook.FacebookOAuth2.refresh_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Requests a new access token using a refresh token.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>refresh_token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The refresh token.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2Token" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.OAuth2Token">OAuth2Token</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An access token response dictionary.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RefreshTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RefreshTokenError">RefreshTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while refreshing the token.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RefreshTokenNotSupportedError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RefreshTokenNotSupportedError">RefreshTokenNotSupportedError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The provider does not support token refresh.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">access_token</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">refresh_token</span><span class="p">(</span><span class="s2">&quot;REFRESH_TOKEN&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.facebook.FacebookOAuth2.revoke_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">revoke_token</span><span class="p">(</span><span class="n">token</span><span class="p">,</span> <span class="n">token_type_hint</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.facebook.FacebookOAuth2.revoke_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Revokes a token.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A token or refresh token to revoke.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>token_type_hint</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional hint for the service to help it determine
+if it's a token or refresh token.
+Usually either <code>token</code> or <code>refresh_token</code>.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code>None</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>None</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RevokeTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RevokeTokenError">RevokeTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while revoking the token.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RevokeTokenNotSupportedError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RevokeTokenNotSupportedError">RevokeTokenNotSupportedError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The provider does not support token revoke.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+    </div>
+
+</div>
+
+
+
+  </div>
+
+    </div>
+
+</div>
+
+
+
+
+  </div>
+
+    </div>
+
+</div><h2 id="github">GitHub<a class="headerlink" href="#github" title="Permanent link">&para;</a></h2>
+
+
+<div class="doc doc-object doc-module">
+
+
+
+<h3 id="httpx_oauth.clients.github" class="doc doc-heading">
+            <code>httpx_oauth.clients.github</code>
+
+
+<a href="#httpx_oauth.clients.github" class="headerlink" title="Permanent link">&para;</a></h3>
+
+    <div class="doc doc-contents first">
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+<div class="doc doc-object doc-class">
+
+
+
+<h4 id="httpx_oauth.clients.github.GitHubOAuth2" class="doc doc-heading">
+            <code>GitHubOAuth2</code>
+
+
+<a href="#httpx_oauth.clients.github.GitHubOAuth2" class="headerlink" title="Permanent link">&para;</a></h4>
+
+
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.BaseOAuth2" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.BaseOAuth2">BaseOAuth2</a>[<span title="httpx_oauth.clients.github.GitHubOAuth2AuthorizeParams">GitHubOAuth2AuthorizeParams</span>]</code></p>
+
+
+      <p>OAuth2 client for GitHub.</p>
+
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.github.GitHubOAuth2.__init__" class="doc doc-heading">
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">client_id</span><span class="p">,</span> <span class="n">client_secret</span><span class="p">,</span> <span class="n">scopes</span><span class="o">=</span><span class="n">BASE_SCOPES</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="s1">&#39;github&#39;</span><span class="p">)</span></code>
+
+<a href="#httpx_oauth.clients.github.GitHubOAuth2.__init__" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>client_id</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The client ID provided by the OAuth2 provider.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>client_secret</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The client secret provided by the OAuth2 provider.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>scopes</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.List" href="https://docs.python.org/3.8/library/typing.html#typing.List">List</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The default scopes to be used in the authorization URL.</p>
+              </div>
+            </td>
+            <td>
+                  <code><span title="httpx_oauth.clients.github.BASE_SCOPES">BASE_SCOPES</span></code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>name</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A unique name for the OAuth2 client.</p>
+              </div>
+            </td>
+            <td>
+                  <code>&#39;github&#39;</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.github.GitHubOAuth2.get_access_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_access_token</span><span class="p">(</span><span class="n">code</span><span class="p">,</span> <span class="n">redirect_uri</span><span class="p">,</span> <span class="n">code_verifier</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.github.GitHubOAuth2.get_access_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Requests an access token using the authorization code obtained
+after the user has authorized the application.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>code</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The authorization code.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>redirect_uri</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The URL where the user was redirected after authorization.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_verifier</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional code verifier used
+in the <a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> flow.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2Token" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.OAuth2Token">OAuth2Token</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An access token response dictionary.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.GetAccessTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.GetAccessTokenError">GetAccessTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while getting the access token.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">access_token</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">get_access_token</span><span class="p">(</span><span class="s2">&quot;CODE&quot;</span><span class="p">,</span> <span class="s2">&quot;https://www.tintagel.bt/oauth-callback&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.github.GitHubOAuth2.get_authorization_url" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_authorization_url</span><span class="p">(</span><span class="n">redirect_uri</span><span class="p">,</span> <span class="n">state</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">code_challenge</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">code_challenge_method</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">extras_params</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.github.GitHubOAuth2.get_authorization_url" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Builds the authorization URL
+where the user should be redirected to authorize the application.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>redirect_uri</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The URL where the user will be redirected after authorization.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>state</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An opaque value used by the client to maintain state</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>scope</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.List" href="https://docs.python.org/3.8/library/typing.html#typing.List">List</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The scopes to be requested.
+If not provided, <code>base_scopes</code> will be used.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_challenge</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional
+<a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> code challenge.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_challenge_method</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.Literal" href="https://docs.python.org/3.8/library/typing.html#typing.Literal">Literal</a>[&#39;plain&#39;, &#39;S256&#39;]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional
+<a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> code challenge
+method.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>extras_params</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<span title="httpx_oauth.oauth2.T">T</span>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional extra parameters specific to the service.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The authorization URL.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <p><code>py
+authorization_url = await client.get_authorization_url(
+    "https://www.tintagel.bt/oauth-callback", scope=["SCOPE1", "SCOPE2", "SCOPE3"],
+)</code>py</p>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.github.GitHubOAuth2.get_id_email" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_id_email</span><span class="p">(</span><span class="n">token</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.github.GitHubOAuth2.get_id_email" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Returns the id and the email (if available) of the authenticated user
+from the API provider.</p>
+<div class="admonition tip">
+<p class="admonition-title">Tip</p>
+<p>You should enable <strong>Email addresses</strong> permission
+in the <strong>Permissions &amp; events</strong> section of your GitHub app parameters.
+You can find it at <a href="https://github.com/settings/apps/{YOUR_APP}/permissions">https://github.com/settings/apps/{YOUR_APP}/permissions</a>.</p>
+</div>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The access token.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Tuple" href="https://docs.python.org/3.8/library/typing.html#typing.Tuple">Tuple</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>, <a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A tuple with the id and the email of the authenticated user.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.exceptions.GetIdEmailError" href="../httpx_oauth.exceptions/#httpx_oauth.exceptions.GetIdEmailError">GetIdEmailError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while getting the id and email.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">user_id</span><span class="p">,</span> <span class="n">user_email</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">get_id_email</span><span class="p">(</span><span class="s2">&quot;TOKEN&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.github.GitHubOAuth2.refresh_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">refresh_token</span><span class="p">(</span><span class="n">refresh_token</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.github.GitHubOAuth2.refresh_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Requests a new access token using a refresh token.</p>
+<div class="admonition warning">
+<p class="admonition-title">Refresh tokens are not enabled by default</p>
+<p>Refresh tokens are currently an optional feature you need to enable in your GitHub app parameters.
+<a href="https://docs.github.com/en/apps/creating-github-apps/authenticating-with-a-github-app/refreshing-user-access-tokens">Read more</a>.</p>
+</div>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>refresh_token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The refresh token.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An access token response dictionary.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RefreshTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RefreshTokenError">RefreshTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while refreshing the token.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code>RefreshTokenNotSupportedError</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The provider does not support token refresh.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">access_token</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">refresh_token</span><span class="p">(</span><span class="s2">&quot;REFRESH_TOKEN&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.github.GitHubOAuth2.revoke_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">revoke_token</span><span class="p">(</span><span class="n">token</span><span class="p">,</span> <span class="n">token_type_hint</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.github.GitHubOAuth2.revoke_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Revokes a token.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A token or refresh token to revoke.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>token_type_hint</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional hint for the service to help it determine
+if it's a token or refresh token.
+Usually either <code>token</code> or <code>refresh_token</code>.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code>None</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>None</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RevokeTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RevokeTokenError">RevokeTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while revoking the token.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RevokeTokenNotSupportedError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RevokeTokenNotSupportedError">RevokeTokenNotSupportedError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The provider does not support token revoke.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+    </div>
+
+</div>
+
+
+
+  </div>
+
+    </div>
+
+</div>
+
+
+
+
+  </div>
+
+    </div>
+
+</div><h2 id="google">Google<a class="headerlink" href="#google" title="Permanent link">&para;</a></h2>
+
+
+<div class="doc doc-object doc-module">
+
+
+
+<h3 id="httpx_oauth.clients.google" class="doc doc-heading">
+            <code>httpx_oauth.clients.google</code>
+
+
+<a href="#httpx_oauth.clients.google" class="headerlink" title="Permanent link">&para;</a></h3>
+
+    <div class="doc doc-contents first">
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+<div class="doc doc-object doc-class">
+
+
+
+<h4 id="httpx_oauth.clients.google.GoogleOAuth2" class="doc doc-heading">
+            <code>GoogleOAuth2</code>
+
+
+<a href="#httpx_oauth.clients.google.GoogleOAuth2" class="headerlink" title="Permanent link">&para;</a></h4>
+
+
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.BaseOAuth2" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.BaseOAuth2">BaseOAuth2</a>[<span title="httpx_oauth.clients.google.GoogleOAuth2AuthorizeParams">GoogleOAuth2AuthorizeParams</span>]</code></p>
+
+
+      <p>OAuth2 client for Google.</p>
+
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.google.GoogleOAuth2.__init__" class="doc doc-heading">
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">client_id</span><span class="p">,</span> <span class="n">client_secret</span><span class="p">,</span> <span class="n">scopes</span><span class="o">=</span><span class="n">BASE_SCOPES</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="s1">&#39;google&#39;</span><span class="p">)</span></code>
+
+<a href="#httpx_oauth.clients.google.GoogleOAuth2.__init__" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>client_id</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The client ID provided by the OAuth2 provider.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>client_secret</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The client secret provided by the OAuth2 provider.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>scopes</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.List" href="https://docs.python.org/3.8/library/typing.html#typing.List">List</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The default scopes to be used in the authorization URL.</p>
+              </div>
+            </td>
+            <td>
+                  <code><span title="httpx_oauth.clients.google.BASE_SCOPES">BASE_SCOPES</span></code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>name</code></td>
+            <td>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A unique name for the OAuth2 client.</p>
+              </div>
+            </td>
+            <td>
+                  <code>&#39;google&#39;</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.google.GoogleOAuth2.get_access_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_access_token</span><span class="p">(</span><span class="n">code</span><span class="p">,</span> <span class="n">redirect_uri</span><span class="p">,</span> <span class="n">code_verifier</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.google.GoogleOAuth2.get_access_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Requests an access token using the authorization code obtained
+after the user has authorized the application.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>code</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The authorization code.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>redirect_uri</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The URL where the user was redirected after authorization.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_verifier</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional code verifier used
+in the <a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> flow.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2Token" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.OAuth2Token">OAuth2Token</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An access token response dictionary.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.GetAccessTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.GetAccessTokenError">GetAccessTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while getting the access token.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">access_token</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">get_access_token</span><span class="p">(</span><span class="s2">&quot;CODE&quot;</span><span class="p">,</span> <span class="s2">&quot;https://www.tintagel.bt/oauth-callback&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.google.GoogleOAuth2.get_authorization_url" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_authorization_url</span><span class="p">(</span><span class="n">redirect_uri</span><span class="p">,</span> <span class="n">state</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">code_challenge</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">code_challenge_method</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">extras_params</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.google.GoogleOAuth2.get_authorization_url" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Builds the authorization URL
+where the user should be redirected to authorize the application.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>redirect_uri</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The URL where the user will be redirected after authorization.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>state</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An opaque value used by the client to maintain state</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>scope</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.List" href="https://docs.python.org/3.8/library/typing.html#typing.List">List</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The scopes to be requested.
+If not provided, <code>base_scopes</code> will be used.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_challenge</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional
+<a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> code challenge.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_challenge_method</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.Literal" href="https://docs.python.org/3.8/library/typing.html#typing.Literal">Literal</a>[&#39;plain&#39;, &#39;S256&#39;]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional
+<a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> code challenge
+method.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>extras_params</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<span title="httpx_oauth.oauth2.T">T</span>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional extra parameters specific to the service.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The authorization URL.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <p><code>py
+authorization_url = await client.get_authorization_url(
+    "https://www.tintagel.bt/oauth-callback", scope=["SCOPE1", "SCOPE2", "SCOPE3"],
+)</code>py</p>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.google.GoogleOAuth2.get_id_email" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_id_email</span><span class="p">(</span><span class="n">token</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.google.GoogleOAuth2.get_id_email" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Returns the id and the email (if available) of the authenticated user
+from the API provider.</p>
+<p><strong>It assumes you have asked for the required scopes</strong>.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The access token.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Tuple" href="https://docs.python.org/3.8/library/typing.html#typing.Tuple">Tuple</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>, <a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A tuple with the id and the email of the authenticated user.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.exceptions.GetIdEmailError" href="../httpx_oauth.exceptions/#httpx_oauth.exceptions.GetIdEmailError">GetIdEmailError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while getting the id and email.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">user_id</span><span class="p">,</span> <span class="n">user_email</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">get_id_email</span><span class="p">(</span><span class="s2">&quot;TOKEN&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.google.GoogleOAuth2.refresh_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">refresh_token</span><span class="p">(</span><span class="n">refresh_token</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.google.GoogleOAuth2.refresh_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Requests a new access token using a refresh token.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>refresh_token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The refresh token.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2Token" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.OAuth2Token">OAuth2Token</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An access token response dictionary.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RefreshTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RefreshTokenError">RefreshTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while refreshing the token.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RefreshTokenNotSupportedError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RefreshTokenNotSupportedError">RefreshTokenNotSupportedError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The provider does not support token refresh.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">access_token</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">refresh_token</span><span class="p">(</span><span class="s2">&quot;REFRESH_TOKEN&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.google.GoogleOAuth2.revoke_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">revoke_token</span><span class="p">(</span><span class="n">token</span><span class="p">,</span> <span class="n">token_type_hint</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.google.GoogleOAuth2.revoke_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Revokes a token.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A token or refresh token to revoke.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>token_type_hint</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional hint for the service to help it determine
+if it's a token or refresh token.
+Usually either <code>token</code> or <code>refresh_token</code>.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code>None</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>None</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RevokeTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RevokeTokenError">RevokeTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while revoking the token.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RevokeTokenNotSupportedError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RevokeTokenNotSupportedError">RevokeTokenNotSupportedError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The provider does not support token revoke.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+    </div>
+
+</div>
+
+
+
+  </div>
+
+    </div>
+
+</div>
+
+
+
+
+  </div>
+
+    </div>
+
+</div><h2 id="kakao">Kakao<a class="headerlink" href="#kakao" title="Permanent link">&para;</a></h2>
+
+
+<div class="doc doc-object doc-module">
+
+
+
+<h3 id="httpx_oauth.clients.kakao" class="doc doc-heading">
+            <code>httpx_oauth.clients.kakao</code>
+
+
+<a href="#httpx_oauth.clients.kakao" class="headerlink" title="Permanent link">&para;</a></h3>
+
+    <div class="doc doc-contents first">
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+<div class="doc doc-object doc-class">
+
+
+
+<h4 id="httpx_oauth.clients.kakao.KakaoOAuth2" class="doc doc-heading">
+            <code>KakaoOAuth2</code>
+
+
+<a href="#httpx_oauth.clients.kakao.KakaoOAuth2" class="headerlink" title="Permanent link">&para;</a></h4>
+
+
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.BaseOAuth2" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.BaseOAuth2">BaseOAuth2</a>[<a class="autorefs autorefs-external" title="typing.Dict" href="https://docs.python.org/3.8/library/typing.html#typing.Dict">Dict</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>, <a class="autorefs autorefs-external" title="typing.Any" href="https://docs.python.org/3.8/library/typing.html#typing.Any">Any</a>]]</code></p>
+
+
+      <p>OAuth2 client for Kakao.</p>
+
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.kakao.KakaoOAuth2.__init__" class="doc doc-heading">
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">client_id</span><span class="p">,</span> <span class="n">client_secret</span><span class="p">,</span> <span class="n">scopes</span><span class="o">=</span><span class="n">BASE_SCOPES</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="s1">&#39;kakao&#39;</span><span class="p">)</span></code>
+
+<a href="#httpx_oauth.clients.kakao.KakaoOAuth2.__init__" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>client_id</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The client ID provided by the OAuth2 provider.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>client_secret</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The client secret provided by the OAuth2 provider.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>scopes</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.List" href="https://docs.python.org/3.8/library/typing.html#typing.List">List</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The default scopes to be used in the authorization URL.</p>
+              </div>
+            </td>
+            <td>
+                  <code><span title="httpx_oauth.clients.kakao.BASE_SCOPES">BASE_SCOPES</span></code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>name</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A unique name for the OAuth2 client.</p>
+              </div>
+            </td>
+            <td>
+                  <code>&#39;kakao&#39;</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.kakao.KakaoOAuth2.get_access_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_access_token</span><span class="p">(</span><span class="n">code</span><span class="p">,</span> <span class="n">redirect_uri</span><span class="p">,</span> <span class="n">code_verifier</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.kakao.KakaoOAuth2.get_access_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Requests an access token using the authorization code obtained
+after the user has authorized the application.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>code</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The authorization code.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>redirect_uri</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The URL where the user was redirected after authorization.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_verifier</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional code verifier used
+in the <a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> flow.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2Token" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.OAuth2Token">OAuth2Token</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An access token response dictionary.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.GetAccessTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.GetAccessTokenError">GetAccessTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while getting the access token.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">access_token</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">get_access_token</span><span class="p">(</span><span class="s2">&quot;CODE&quot;</span><span class="p">,</span> <span class="s2">&quot;https://www.tintagel.bt/oauth-callback&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.kakao.KakaoOAuth2.get_authorization_url" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_authorization_url</span><span class="p">(</span><span class="n">redirect_uri</span><span class="p">,</span> <span class="n">state</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">code_challenge</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">code_challenge_method</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">extras_params</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.kakao.KakaoOAuth2.get_authorization_url" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Builds the authorization URL
+where the user should be redirected to authorize the application.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>redirect_uri</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The URL where the user will be redirected after authorization.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>state</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An opaque value used by the client to maintain state</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>scope</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.List" href="https://docs.python.org/3.8/library/typing.html#typing.List">List</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The scopes to be requested.
+If not provided, <code>base_scopes</code> will be used.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_challenge</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional
+<a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> code challenge.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_challenge_method</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.Literal" href="https://docs.python.org/3.8/library/typing.html#typing.Literal">Literal</a>[&#39;plain&#39;, &#39;S256&#39;]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional
+<a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> code challenge
+method.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>extras_params</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<span title="httpx_oauth.oauth2.T">T</span>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional extra parameters specific to the service.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The authorization URL.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <p><code>py
+authorization_url = await client.get_authorization_url(
+    "https://www.tintagel.bt/oauth-callback", scope=["SCOPE1", "SCOPE2", "SCOPE3"],
+)</code>py</p>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.kakao.KakaoOAuth2.get_id_email" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_id_email</span><span class="p">(</span><span class="n">token</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.kakao.KakaoOAuth2.get_id_email" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Returns the id and the email (if available) of the authenticated user
+from the API provider.</p>
+<p><strong>It assumes you have asked for the required scopes</strong>.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The access token.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Tuple" href="https://docs.python.org/3.8/library/typing.html#typing.Tuple">Tuple</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>, <a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A tuple with the id and the email of the authenticated user.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.exceptions.GetIdEmailError" href="../httpx_oauth.exceptions/#httpx_oauth.exceptions.GetIdEmailError">GetIdEmailError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while getting the id and email.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">user_id</span><span class="p">,</span> <span class="n">user_email</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">get_id_email</span><span class="p">(</span><span class="s2">&quot;TOKEN&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.kakao.KakaoOAuth2.refresh_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">refresh_token</span><span class="p">(</span><span class="n">refresh_token</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.kakao.KakaoOAuth2.refresh_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Requests a new access token using a refresh token.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>refresh_token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The refresh token.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2Token" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.OAuth2Token">OAuth2Token</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An access token response dictionary.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RefreshTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RefreshTokenError">RefreshTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while refreshing the token.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RefreshTokenNotSupportedError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RefreshTokenNotSupportedError">RefreshTokenNotSupportedError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The provider does not support token refresh.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">access_token</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">refresh_token</span><span class="p">(</span><span class="s2">&quot;REFRESH_TOKEN&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.kakao.KakaoOAuth2.revoke_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">revoke_token</span><span class="p">(</span><span class="n">token</span><span class="p">,</span> <span class="n">token_type_hint</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.kakao.KakaoOAuth2.revoke_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Revokes a token.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A token or refresh token to revoke.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>token_type_hint</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional hint for the service to help it determine
+if it's a token or refresh token.
+Usually either <code>token</code> or <code>refresh_token</code>.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code>None</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>None</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RevokeTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RevokeTokenError">RevokeTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while revoking the token.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RevokeTokenNotSupportedError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RevokeTokenNotSupportedError">RevokeTokenNotSupportedError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The provider does not support token revoke.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+    </div>
+
+</div>
+
+
+
+  </div>
+
+    </div>
+
+</div>
+
+
+
+
+  </div>
+
+    </div>
+
+</div><h2 id="linkedin">LinkedIn<a class="headerlink" href="#linkedin" title="Permanent link">&para;</a></h2>
+
+
+<div class="doc doc-object doc-module">
+
+
+
+<h3 id="httpx_oauth.clients.linkedin" class="doc doc-heading">
+            <code>httpx_oauth.clients.linkedin</code>
+
+
+<a href="#httpx_oauth.clients.linkedin" class="headerlink" title="Permanent link">&para;</a></h3>
+
+    <div class="doc doc-contents first">
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+<div class="doc doc-object doc-class">
+
+
+
+<h4 id="httpx_oauth.clients.linkedin.LinkedInOAuth2" class="doc doc-heading">
+            <code>LinkedInOAuth2</code>
+
+
+<a href="#httpx_oauth.clients.linkedin.LinkedInOAuth2" class="headerlink" title="Permanent link">&para;</a></h4>
+
+
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.BaseOAuth2" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.BaseOAuth2">BaseOAuth2</a>[<a class="autorefs autorefs-external" title="typing.Dict" href="https://docs.python.org/3.8/library/typing.html#typing.Dict">Dict</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>, <a class="autorefs autorefs-external" title="typing.Any" href="https://docs.python.org/3.8/library/typing.html#typing.Any">Any</a>]]</code></p>
+
+
+      <p>OAuth2 client for LinkedIn.</p>
+
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.linkedin.LinkedInOAuth2.__init__" class="doc doc-heading">
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">client_id</span><span class="p">,</span> <span class="n">client_secret</span><span class="p">,</span> <span class="n">scopes</span><span class="o">=</span><span class="n">BASE_SCOPES</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="s1">&#39;linkedin&#39;</span><span class="p">)</span></code>
+
+<a href="#httpx_oauth.clients.linkedin.LinkedInOAuth2.__init__" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>client_id</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The client ID provided by the OAuth2 provider.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>client_secret</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The client secret provided by the OAuth2 provider.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>scopes</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.List" href="https://docs.python.org/3.8/library/typing.html#typing.List">List</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The default scopes to be used in the authorization URL.</p>
+              </div>
+            </td>
+            <td>
+                  <code><span title="httpx_oauth.clients.linkedin.BASE_SCOPES">BASE_SCOPES</span></code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>name</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A unique name for the OAuth2 client.</p>
+              </div>
+            </td>
+            <td>
+                  <code>&#39;linkedin&#39;</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.linkedin.LinkedInOAuth2.get_access_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_access_token</span><span class="p">(</span><span class="n">code</span><span class="p">,</span> <span class="n">redirect_uri</span><span class="p">,</span> <span class="n">code_verifier</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.linkedin.LinkedInOAuth2.get_access_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Requests an access token using the authorization code obtained
+after the user has authorized the application.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>code</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The authorization code.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>redirect_uri</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The URL where the user was redirected after authorization.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_verifier</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional code verifier used
+in the <a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> flow.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2Token" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.OAuth2Token">OAuth2Token</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An access token response dictionary.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.GetAccessTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.GetAccessTokenError">GetAccessTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while getting the access token.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">access_token</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">get_access_token</span><span class="p">(</span><span class="s2">&quot;CODE&quot;</span><span class="p">,</span> <span class="s2">&quot;https://www.tintagel.bt/oauth-callback&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.linkedin.LinkedInOAuth2.get_authorization_url" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_authorization_url</span><span class="p">(</span><span class="n">redirect_uri</span><span class="p">,</span> <span class="n">state</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">code_challenge</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">code_challenge_method</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">extras_params</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.linkedin.LinkedInOAuth2.get_authorization_url" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Builds the authorization URL
+where the user should be redirected to authorize the application.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>redirect_uri</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The URL where the user will be redirected after authorization.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>state</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An opaque value used by the client to maintain state</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>scope</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.List" href="https://docs.python.org/3.8/library/typing.html#typing.List">List</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The scopes to be requested.
+If not provided, <code>base_scopes</code> will be used.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_challenge</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional
+<a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> code challenge.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_challenge_method</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.Literal" href="https://docs.python.org/3.8/library/typing.html#typing.Literal">Literal</a>[&#39;plain&#39;, &#39;S256&#39;]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional
+<a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> code challenge
+method.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>extras_params</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<span title="httpx_oauth.oauth2.T">T</span>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional extra parameters specific to the service.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The authorization URL.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <p><code>py
+authorization_url = await client.get_authorization_url(
+    "https://www.tintagel.bt/oauth-callback", scope=["SCOPE1", "SCOPE2", "SCOPE3"],
+)</code>py</p>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.linkedin.LinkedInOAuth2.get_id_email" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_id_email</span><span class="p">(</span><span class="n">token</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.linkedin.LinkedInOAuth2.get_id_email" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Returns the id and the email (if available) of the authenticated user
+from the API provider.</p>
+<p><strong>It assumes you have asked for the required scopes</strong>.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The access token.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Tuple" href="https://docs.python.org/3.8/library/typing.html#typing.Tuple">Tuple</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>, <a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A tuple with the id and the email of the authenticated user.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.exceptions.GetIdEmailError" href="../httpx_oauth.exceptions/#httpx_oauth.exceptions.GetIdEmailError">GetIdEmailError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while getting the id and email.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">user_id</span><span class="p">,</span> <span class="n">user_email</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">get_id_email</span><span class="p">(</span><span class="s2">&quot;TOKEN&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.linkedin.LinkedInOAuth2.refresh_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">refresh_token</span><span class="p">(</span><span class="n">refresh_token</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.linkedin.LinkedInOAuth2.refresh_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Requests a new access token using a refresh token.</p>
+<div class="admonition warning">
+<p class="admonition-title">Warning</p>
+<p>Only available for <a href="https://docs.microsoft.com/en-us/linkedin/shared/authentication/programmatic-refresh-tokens">selected partners</a>.</p>
+</div>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>refresh_token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The refresh token.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2Token" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.OAuth2Token">OAuth2Token</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An access token response dictionary.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code>RefreshTokenError</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while refreshing the token.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code>RefreshTokenNotSupportedError</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The provider does not support token refresh.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">access_token</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">refresh_token</span><span class="p">(</span><span class="s2">&quot;REFRESH_TOKEN&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.linkedin.LinkedInOAuth2.revoke_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">revoke_token</span><span class="p">(</span><span class="n">token</span><span class="p">,</span> <span class="n">token_type_hint</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.linkedin.LinkedInOAuth2.revoke_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Revokes a token.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A token or refresh token to revoke.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>token_type_hint</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional hint for the service to help it determine
+if it's a token or refresh token.
+Usually either <code>token</code> or <code>refresh_token</code>.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code>None</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>None</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RevokeTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RevokeTokenError">RevokeTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while revoking the token.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RevokeTokenNotSupportedError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RevokeTokenNotSupportedError">RevokeTokenNotSupportedError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The provider does not support token revoke.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+    </div>
+
+</div>
+
+
+
+  </div>
+
+    </div>
+
+</div>
+
+
+
+
+  </div>
+
+    </div>
+
+</div><h2 id="microsoft">Microsoft<a class="headerlink" href="#microsoft" title="Permanent link">&para;</a></h2>
+
+
+<div class="doc doc-object doc-module">
+
+
+
+<h3 id="httpx_oauth.clients.microsoft" class="doc doc-heading">
+            <code>httpx_oauth.clients.microsoft</code>
+
+
+<a href="#httpx_oauth.clients.microsoft" class="headerlink" title="Permanent link">&para;</a></h3>
+
+    <div class="doc doc-contents first">
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+<div class="doc doc-object doc-class">
+
+
+
+<h4 id="httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2" class="doc doc-heading">
+            <code>MicrosoftGraphOAuth2</code>
+
+
+<a href="#httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2" class="headerlink" title="Permanent link">&para;</a></h4>
+
+
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.BaseOAuth2" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.BaseOAuth2">BaseOAuth2</a>[<a class="autorefs autorefs-external" title="typing.Dict" href="https://docs.python.org/3.8/library/typing.html#typing.Dict">Dict</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>, <a class="autorefs autorefs-external" title="typing.Any" href="https://docs.python.org/3.8/library/typing.html#typing.Any">Any</a>]]</code></p>
+
+
+      <p>OAuth2 client for Microsoft Graph API.</p>
+
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2.__init__" class="doc doc-heading">
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">client_id</span><span class="p">,</span> <span class="n">client_secret</span><span class="p">,</span> <span class="n">tenant</span><span class="o">=</span><span class="s1">&#39;common&#39;</span><span class="p">,</span> <span class="n">scopes</span><span class="o">=</span><span class="n">BASE_SCOPES</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="s1">&#39;microsoft&#39;</span><span class="p">)</span></code>
+
+<a href="#httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2.__init__" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>client_id</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The client ID provided by the OAuth2 provider.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>client_secret</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The client secret provided by the OAuth2 provider.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>tenant</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The tenant to use for the authorization URL.</p>
+              </div>
+            </td>
+            <td>
+                  <code>&#39;common&#39;</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>scopes</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.List" href="https://docs.python.org/3.8/library/typing.html#typing.List">List</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The default scopes to be used in the authorization URL.</p>
+              </div>
+            </td>
+            <td>
+                  <code><span title="httpx_oauth.clients.microsoft.BASE_SCOPES">BASE_SCOPES</span></code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>name</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A unique name for the OAuth2 client.</p>
+              </div>
+            </td>
+            <td>
+                  <code>&#39;microsoft&#39;</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2.get_access_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_access_token</span><span class="p">(</span><span class="n">code</span><span class="p">,</span> <span class="n">redirect_uri</span><span class="p">,</span> <span class="n">code_verifier</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2.get_access_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Requests an access token using the authorization code obtained
+after the user has authorized the application.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>code</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The authorization code.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>redirect_uri</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The URL where the user was redirected after authorization.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_verifier</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional code verifier used
+in the <a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> flow.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2Token" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.OAuth2Token">OAuth2Token</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An access token response dictionary.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.GetAccessTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.GetAccessTokenError">GetAccessTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while getting the access token.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">access_token</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">get_access_token</span><span class="p">(</span><span class="s2">&quot;CODE&quot;</span><span class="p">,</span> <span class="s2">&quot;https://www.tintagel.bt/oauth-callback&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2.get_authorization_url" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_authorization_url</span><span class="p">(</span><span class="n">redirect_uri</span><span class="p">,</span> <span class="n">state</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">extras_params</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+<a href="#httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2.get_authorization_url" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Builds the authorization URL
+where the user should be redirected to authorize the application.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>redirect_uri</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The URL where the user will be redirected after authorization.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>state</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An opaque value used by the client to maintain state</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>scope</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.List" href="https://docs.python.org/3.8/library/typing.html#typing.List">List</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The scopes to be requested.
+If not provided, <code>base_scopes</code> will be used.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_challenge</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional
+<a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> code challenge.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_challenge_method</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.Literal" href="https://docs.python.org/3.8/library/typing.html#typing.Literal">Literal</a>[&#39;plain&#39;, &#39;S256&#39;]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional
+<a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> code challenge
+method.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>extras_params</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<span title="httpx_oauth.oauth2.T">T</span>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional extra parameters specific to the service.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The authorization URL.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <p><code>py
+authorization_url = await client.get_authorization_url(
+    "https://www.tintagel.bt/oauth-callback", scope=["SCOPE1", "SCOPE2", "SCOPE3"],
+)</code>py</p>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2.get_id_email" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_id_email</span><span class="p">(</span><span class="n">token</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2.get_id_email" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Returns the id and the email (if available) of the authenticated user
+from the API provider.</p>
+<p><strong>It assumes you have asked for the required scopes</strong>.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The access token.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Tuple" href="https://docs.python.org/3.8/library/typing.html#typing.Tuple">Tuple</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>, <a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A tuple with the id and the email of the authenticated user.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.exceptions.GetIdEmailError" href="../httpx_oauth.exceptions/#httpx_oauth.exceptions.GetIdEmailError">GetIdEmailError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while getting the id and email.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">user_id</span><span class="p">,</span> <span class="n">user_email</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">get_id_email</span><span class="p">(</span><span class="s2">&quot;TOKEN&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2.refresh_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">refresh_token</span><span class="p">(</span><span class="n">refresh_token</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2.refresh_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Requests a new access token using a refresh token.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>refresh_token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The refresh token.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2Token" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.OAuth2Token">OAuth2Token</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An access token response dictionary.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RefreshTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RefreshTokenError">RefreshTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while refreshing the token.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RefreshTokenNotSupportedError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RefreshTokenNotSupportedError">RefreshTokenNotSupportedError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The provider does not support token refresh.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">access_token</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">refresh_token</span><span class="p">(</span><span class="s2">&quot;REFRESH_TOKEN&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2.revoke_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">revoke_token</span><span class="p">(</span><span class="n">token</span><span class="p">,</span> <span class="n">token_type_hint</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2.revoke_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Revokes a token.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A token or refresh token to revoke.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>token_type_hint</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional hint for the service to help it determine
+if it's a token or refresh token.
+Usually either <code>token</code> or <code>refresh_token</code>.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code>None</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>None</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RevokeTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RevokeTokenError">RevokeTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while revoking the token.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RevokeTokenNotSupportedError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RevokeTokenNotSupportedError">RevokeTokenNotSupportedError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The provider does not support token revoke.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+    </div>
+
+</div>
+
+
+
+  </div>
+
+    </div>
+
+</div>
+
+
+
+
+  </div>
+
+    </div>
+
+</div><h2 id="naver">Naver<a class="headerlink" href="#naver" title="Permanent link">&para;</a></h2>
+
+
+<div class="doc doc-object doc-module">
+
+
+
+<h3 id="httpx_oauth.clients.naver" class="doc doc-heading">
+            <code>httpx_oauth.clients.naver</code>
+
+
+<a href="#httpx_oauth.clients.naver" class="headerlink" title="Permanent link">&para;</a></h3>
+
+    <div class="doc doc-contents first">
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+<div class="doc doc-object doc-class">
+
+
+
+<h4 id="httpx_oauth.clients.naver.NaverOAuth2" class="doc doc-heading">
+            <code>NaverOAuth2</code>
+
+
+<a href="#httpx_oauth.clients.naver.NaverOAuth2" class="headerlink" title="Permanent link">&para;</a></h4>
+
+
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.BaseOAuth2" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.BaseOAuth2">BaseOAuth2</a>[<a class="autorefs autorefs-external" title="typing.Dict" href="https://docs.python.org/3.8/library/typing.html#typing.Dict">Dict</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>, <a class="autorefs autorefs-external" title="typing.Any" href="https://docs.python.org/3.8/library/typing.html#typing.Any">Any</a>]]</code></p>
+
+
+      <p>OAuth2 client for Naver.</p>
+
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.naver.NaverOAuth2.__init__" class="doc doc-heading">
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">client_id</span><span class="p">,</span> <span class="n">client_secret</span><span class="p">,</span> <span class="n">scopes</span><span class="o">=</span><span class="n">BASE_SCOPES</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="s1">&#39;naver&#39;</span><span class="p">)</span></code>
+
+<a href="#httpx_oauth.clients.naver.NaverOAuth2.__init__" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>client_id</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The client ID provided by the OAuth2 provider.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>client_secret</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The client secret provided by the OAuth2 provider.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>scopes</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.List" href="https://docs.python.org/3.8/library/typing.html#typing.List">List</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The default scopes to be used in the authorization URL.</p>
+              </div>
+            </td>
+            <td>
+                  <code><span title="httpx_oauth.clients.naver.BASE_SCOPES">BASE_SCOPES</span></code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>name</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A unique name for the OAuth2 client.</p>
+              </div>
+            </td>
+            <td>
+                  <code>&#39;naver&#39;</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.naver.NaverOAuth2.get_access_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_access_token</span><span class="p">(</span><span class="n">code</span><span class="p">,</span> <span class="n">redirect_uri</span><span class="p">,</span> <span class="n">code_verifier</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.naver.NaverOAuth2.get_access_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Requests an access token using the authorization code obtained
+after the user has authorized the application.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>code</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The authorization code.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>redirect_uri</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The URL where the user was redirected after authorization.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_verifier</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional code verifier used
+in the <a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> flow.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2Token" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.OAuth2Token">OAuth2Token</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An access token response dictionary.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.GetAccessTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.GetAccessTokenError">GetAccessTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while getting the access token.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">access_token</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">get_access_token</span><span class="p">(</span><span class="s2">&quot;CODE&quot;</span><span class="p">,</span> <span class="s2">&quot;https://www.tintagel.bt/oauth-callback&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.naver.NaverOAuth2.get_authorization_url" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_authorization_url</span><span class="p">(</span><span class="n">redirect_uri</span><span class="p">,</span> <span class="n">state</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">code_challenge</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">code_challenge_method</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">extras_params</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.naver.NaverOAuth2.get_authorization_url" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Builds the authorization URL
+where the user should be redirected to authorize the application.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>redirect_uri</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The URL where the user will be redirected after authorization.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>state</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An opaque value used by the client to maintain state</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>scope</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.List" href="https://docs.python.org/3.8/library/typing.html#typing.List">List</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The scopes to be requested.
+If not provided, <code>base_scopes</code> will be used.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_challenge</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional
+<a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> code challenge.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_challenge_method</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.Literal" href="https://docs.python.org/3.8/library/typing.html#typing.Literal">Literal</a>[&#39;plain&#39;, &#39;S256&#39;]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional
+<a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> code challenge
+method.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>extras_params</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<span title="httpx_oauth.oauth2.T">T</span>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional extra parameters specific to the service.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The authorization URL.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <p><code>py
+authorization_url = await client.get_authorization_url(
+    "https://www.tintagel.bt/oauth-callback", scope=["SCOPE1", "SCOPE2", "SCOPE3"],
+)</code>py</p>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.naver.NaverOAuth2.get_id_email" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_id_email</span><span class="p">(</span><span class="n">token</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.naver.NaverOAuth2.get_id_email" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Returns the id and the email (if available) of the authenticated user
+from the API provider.</p>
+<p><strong>It assumes you have asked for the required scopes</strong>.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The access token.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Tuple" href="https://docs.python.org/3.8/library/typing.html#typing.Tuple">Tuple</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>, <a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A tuple with the id and the email of the authenticated user.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.exceptions.GetIdEmailError" href="../httpx_oauth.exceptions/#httpx_oauth.exceptions.GetIdEmailError">GetIdEmailError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while getting the id and email.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">user_id</span><span class="p">,</span> <span class="n">user_email</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">get_id_email</span><span class="p">(</span><span class="s2">&quot;TOKEN&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.naver.NaverOAuth2.refresh_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">refresh_token</span><span class="p">(</span><span class="n">refresh_token</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.naver.NaverOAuth2.refresh_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Requests a new access token using a refresh token.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>refresh_token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The refresh token.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2Token" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.OAuth2Token">OAuth2Token</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An access token response dictionary.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RefreshTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RefreshTokenError">RefreshTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while refreshing the token.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RefreshTokenNotSupportedError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RefreshTokenNotSupportedError">RefreshTokenNotSupportedError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The provider does not support token refresh.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">access_token</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">refresh_token</span><span class="p">(</span><span class="s2">&quot;REFRESH_TOKEN&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.naver.NaverOAuth2.revoke_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">revoke_token</span><span class="p">(</span><span class="n">token</span><span class="p">,</span> <span class="n">token_type_hint</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.naver.NaverOAuth2.revoke_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Revokes a token.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A token or refresh token to revoke.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>token_type_hint</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional hint for the service to help it determine
+if it's a token or refresh token.
+Usually either <code>token</code> or <code>refresh_token</code>.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code>None</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>None</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RevokeTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RevokeTokenError">RevokeTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while revoking the token.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RevokeTokenNotSupportedError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RevokeTokenNotSupportedError">RevokeTokenNotSupportedError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The provider does not support token revoke.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+    </div>
+
+</div>
+
+
+
+  </div>
+
+    </div>
+
+</div>
+
+
+
+
+  </div>
+
+    </div>
+
+</div><h2 id="okta">Okta<a class="headerlink" href="#okta" title="Permanent link">&para;</a></h2>
+
+
+<div class="doc doc-object doc-module">
+
+
+
+<h3 id="httpx_oauth.clients.okta" class="doc doc-heading">
+            <code>httpx_oauth.clients.okta</code>
+
+
+<a href="#httpx_oauth.clients.okta" class="headerlink" title="Permanent link">&para;</a></h3>
+
+    <div class="doc doc-contents first">
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+<div class="doc doc-object doc-class">
+
+
+
+<h4 id="httpx_oauth.clients.okta.OktaOAuth2" class="doc doc-heading">
+            <code>OktaOAuth2</code>
+
+
+<a href="#httpx_oauth.clients.okta.OktaOAuth2" class="headerlink" title="Permanent link">&para;</a></h4>
+
+
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="httpx_oauth.clients.openid.OpenID" href="#httpx_oauth.clients.openid.OpenID">OpenID</a></code></p>
+
+
+      <p>OAuth2 client for Okta.</p>
+
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.okta.OktaOAuth2.__init__" class="doc doc-heading">
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">client_id</span><span class="p">,</span> <span class="n">client_secret</span><span class="p">,</span> <span class="n">okta_domain</span><span class="p">,</span> <span class="n">scopes</span><span class="o">=</span><span class="n">BASE_SCOPES</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="s1">&#39;okta&#39;</span><span class="p">)</span></code>
+
+<a href="#httpx_oauth.clients.okta.OktaOAuth2.__init__" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>client_id</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The client ID provided by the OAuth2 provider.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>client_secret</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The client secret provided by the OAuth2 provider.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>okta_domain</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The Okta organization domain.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>scopes</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.List" href="https://docs.python.org/3.8/library/typing.html#typing.List">List</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The default scopes to be used in the authorization URL.</p>
+              </div>
+            </td>
+            <td>
+                  <code><span title="httpx_oauth.clients.okta.BASE_SCOPES">BASE_SCOPES</span></code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>name</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A unique name for the OAuth2 client.</p>
+              </div>
+            </td>
+            <td>
+                  <code>&#39;okta&#39;</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.okta.OktaOAuth2.get_access_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_access_token</span><span class="p">(</span><span class="n">code</span><span class="p">,</span> <span class="n">redirect_uri</span><span class="p">,</span> <span class="n">code_verifier</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.okta.OktaOAuth2.get_access_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Requests an access token using the authorization code obtained
+after the user has authorized the application.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>code</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The authorization code.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>redirect_uri</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The URL where the user was redirected after authorization.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_verifier</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional code verifier used
+in the <a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> flow.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2Token" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.OAuth2Token">OAuth2Token</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An access token response dictionary.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.GetAccessTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.GetAccessTokenError">GetAccessTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while getting the access token.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">access_token</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">get_access_token</span><span class="p">(</span><span class="s2">&quot;CODE&quot;</span><span class="p">,</span> <span class="s2">&quot;https://www.tintagel.bt/oauth-callback&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.okta.OktaOAuth2.get_authorization_url" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_authorization_url</span><span class="p">(</span><span class="n">redirect_uri</span><span class="p">,</span> <span class="n">state</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">code_challenge</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">code_challenge_method</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">extras_params</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.okta.OktaOAuth2.get_authorization_url" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Builds the authorization URL
+where the user should be redirected to authorize the application.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>redirect_uri</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The URL where the user will be redirected after authorization.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>state</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An opaque value used by the client to maintain state</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>scope</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.List" href="https://docs.python.org/3.8/library/typing.html#typing.List">List</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The scopes to be requested.
+If not provided, <code>base_scopes</code> will be used.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_challenge</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional
+<a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> code challenge.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_challenge_method</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.Literal" href="https://docs.python.org/3.8/library/typing.html#typing.Literal">Literal</a>[&#39;plain&#39;, &#39;S256&#39;]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional
+<a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> code challenge
+method.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>extras_params</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<span title="httpx_oauth.oauth2.T">T</span>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional extra parameters specific to the service.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The authorization URL.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <p><code>py
+authorization_url = await client.get_authorization_url(
+    "https://www.tintagel.bt/oauth-callback", scope=["SCOPE1", "SCOPE2", "SCOPE3"],
+)</code>py</p>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.okta.OktaOAuth2.get_id_email" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_id_email</span><span class="p">(</span><span class="n">token</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.okta.OktaOAuth2.get_id_email" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Returns the id and the email (if available) of the authenticated user
+from the API provider.</p>
+<p><strong>It assumes you have asked for the required scopes</strong>.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The access token.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Tuple" href="https://docs.python.org/3.8/library/typing.html#typing.Tuple">Tuple</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>, <a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A tuple with the id and the email of the authenticated user.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.exceptions.GetIdEmailError" href="../httpx_oauth.exceptions/#httpx_oauth.exceptions.GetIdEmailError">GetIdEmailError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while getting the id and email.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">user_id</span><span class="p">,</span> <span class="n">user_email</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">get_id_email</span><span class="p">(</span><span class="s2">&quot;TOKEN&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.okta.OktaOAuth2.refresh_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">refresh_token</span><span class="p">(</span><span class="n">refresh_token</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.okta.OktaOAuth2.refresh_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Requests a new access token using a refresh token.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>refresh_token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The refresh token.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2Token" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.OAuth2Token">OAuth2Token</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An access token response dictionary.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RefreshTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RefreshTokenError">RefreshTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while refreshing the token.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RefreshTokenNotSupportedError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RefreshTokenNotSupportedError">RefreshTokenNotSupportedError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The provider does not support token refresh.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">access_token</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">refresh_token</span><span class="p">(</span><span class="s2">&quot;REFRESH_TOKEN&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.okta.OktaOAuth2.revoke_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">revoke_token</span><span class="p">(</span><span class="n">token</span><span class="p">,</span> <span class="n">token_type_hint</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.okta.OktaOAuth2.revoke_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Revokes a token.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A token or refresh token to revoke.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>token_type_hint</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional hint for the service to help it determine
+if it's a token or refresh token.
+Usually either <code>token</code> or <code>refresh_token</code>.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code>None</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>None</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RevokeTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RevokeTokenError">RevokeTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while revoking the token.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RevokeTokenNotSupportedError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RevokeTokenNotSupportedError">RevokeTokenNotSupportedError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The provider does not support token revoke.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+    </div>
+
+</div>
+
+
+
+  </div>
+
+    </div>
+
+</div>
+
+
+
+
+  </div>
+
+    </div>
+
+</div><h2 id="openid">OpenID<a class="headerlink" href="#openid" title="Permanent link">&para;</a></h2>
+
+
+<div class="doc doc-object doc-module">
+
+
+
+<h3 id="httpx_oauth.clients.openid" class="doc doc-heading">
+            <code>httpx_oauth.clients.openid</code>
+
+
+<a href="#httpx_oauth.clients.openid" class="headerlink" title="Permanent link">&para;</a></h3>
+
+    <div class="doc doc-contents first">
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+<div class="doc doc-object doc-class">
+
+
+
+<h4 id="httpx_oauth.clients.openid.OpenID" class="doc doc-heading">
+            <code>OpenID</code>
+
+
+<a href="#httpx_oauth.clients.openid.OpenID" class="headerlink" title="Permanent link">&para;</a></h4>
+
+
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.BaseOAuth2" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.BaseOAuth2">BaseOAuth2</a>[<a class="autorefs autorefs-external" title="typing.Dict" href="https://docs.python.org/3.8/library/typing.html#typing.Dict">Dict</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>, <a class="autorefs autorefs-external" title="typing.Any" href="https://docs.python.org/3.8/library/typing.html#typing.Any">Any</a>]]</code></p>
+
+
+      <p>Generic client for providers following the <a href="https://openid.net/connect/">OpenID Connect protocol</a>.</p>
+<p>Besides the Client ID and the Client Secret, you'll have to provide the OpenID configuration endpoint, allowing the client to discover the required endpoints automatically. By convention, it's usually served under the path <code>.well-known/openid-configuration</code>.</p>
+
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.openid.OpenID.__init__" class="doc doc-heading">
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">client_id</span><span class="p">,</span> <span class="n">client_secret</span><span class="p">,</span> <span class="n">openid_configuration_endpoint</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="s1">&#39;openid&#39;</span><span class="p">,</span> <span class="n">base_scopes</span><span class="o">=</span><span class="n">BASE_SCOPES</span><span class="p">)</span></code>
+
+<a href="#httpx_oauth.clients.openid.OpenID.__init__" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>client_id</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The client ID provided by the OAuth2 provider.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>client_secret</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The client secret provided by the OAuth2 provider.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>openid_configuration_endpoint</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>OpenID Connect discovery endpoint URL.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>name</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A unique name for the OAuth2 client.</p>
+              </div>
+            </td>
+            <td>
+                  <code>&#39;openid&#39;</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>base_scopes</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.List" href="https://docs.python.org/3.8/library/typing.html#typing.List">List</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The base scopes to be used in the authorization URL.</p>
+              </div>
+            </td>
+            <td>
+                  <code><span title="httpx_oauth.clients.openid.BASE_SCOPES">BASE_SCOPES</span></code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.clients.openid.OpenIDConfigurationError" href="#httpx_oauth.clients.openid.OpenIDConfigurationError">OpenIDConfigurationError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while fetching the OpenID configuration.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <p>```py
+from httpx_oauth.clients.openid import OpenID</p>
+<p>client = OpenID("CLIENT_ID", "CLIENT_SECRET", "https://example.fief.dev/.well-known/openid-configuration")
+``</p>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.openid.OpenID.get_access_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_access_token</span><span class="p">(</span><span class="n">code</span><span class="p">,</span> <span class="n">redirect_uri</span><span class="p">,</span> <span class="n">code_verifier</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.openid.OpenID.get_access_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Requests an access token using the authorization code obtained
+after the user has authorized the application.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>code</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The authorization code.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>redirect_uri</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The URL where the user was redirected after authorization.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_verifier</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional code verifier used
+in the <a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> flow.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2Token" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.OAuth2Token">OAuth2Token</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An access token response dictionary.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.GetAccessTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.GetAccessTokenError">GetAccessTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while getting the access token.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">access_token</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">get_access_token</span><span class="p">(</span><span class="s2">&quot;CODE&quot;</span><span class="p">,</span> <span class="s2">&quot;https://www.tintagel.bt/oauth-callback&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.openid.OpenID.get_authorization_url" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_authorization_url</span><span class="p">(</span><span class="n">redirect_uri</span><span class="p">,</span> <span class="n">state</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">code_challenge</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">code_challenge_method</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">extras_params</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.openid.OpenID.get_authorization_url" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Builds the authorization URL
+where the user should be redirected to authorize the application.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>redirect_uri</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The URL where the user will be redirected after authorization.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>state</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An opaque value used by the client to maintain state</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>scope</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.List" href="https://docs.python.org/3.8/library/typing.html#typing.List">List</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The scopes to be requested.
+If not provided, <code>base_scopes</code> will be used.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_challenge</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional
+<a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> code challenge.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_challenge_method</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.Literal" href="https://docs.python.org/3.8/library/typing.html#typing.Literal">Literal</a>[&#39;plain&#39;, &#39;S256&#39;]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional
+<a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> code challenge
+method.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>extras_params</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<span title="httpx_oauth.oauth2.T">T</span>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional extra parameters specific to the service.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The authorization URL.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <p><code>py
+authorization_url = await client.get_authorization_url(
+    "https://www.tintagel.bt/oauth-callback", scope=["SCOPE1", "SCOPE2", "SCOPE3"],
+)</code>py</p>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.openid.OpenID.get_id_email" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_id_email</span><span class="p">(</span><span class="n">token</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.openid.OpenID.get_id_email" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Returns the id and the email (if available) of the authenticated user
+from the API provider.</p>
+<p><strong>It assumes you have asked for the required scopes</strong>.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The access token.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Tuple" href="https://docs.python.org/3.8/library/typing.html#typing.Tuple">Tuple</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>, <a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A tuple with the id and the email of the authenticated user.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.exceptions.GetIdEmailError" href="../httpx_oauth.exceptions/#httpx_oauth.exceptions.GetIdEmailError">GetIdEmailError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while getting the id and email.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">user_id</span><span class="p">,</span> <span class="n">user_email</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">get_id_email</span><span class="p">(</span><span class="s2">&quot;TOKEN&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.openid.OpenID.refresh_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">refresh_token</span><span class="p">(</span><span class="n">refresh_token</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.openid.OpenID.refresh_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Requests a new access token using a refresh token.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>refresh_token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The refresh token.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2Token" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.OAuth2Token">OAuth2Token</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An access token response dictionary.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RefreshTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RefreshTokenError">RefreshTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while refreshing the token.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RefreshTokenNotSupportedError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RefreshTokenNotSupportedError">RefreshTokenNotSupportedError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The provider does not support token refresh.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">access_token</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">refresh_token</span><span class="p">(</span><span class="s2">&quot;REFRESH_TOKEN&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.openid.OpenID.revoke_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">revoke_token</span><span class="p">(</span><span class="n">token</span><span class="p">,</span> <span class="n">token_type_hint</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.openid.OpenID.revoke_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Revokes a token.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A token or refresh token to revoke.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>token_type_hint</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional hint for the service to help it determine
+if it's a token or refresh token.
+Usually either <code>token</code> or <code>refresh_token</code>.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code>None</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>None</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RevokeTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RevokeTokenError">RevokeTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while revoking the token.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RevokeTokenNotSupportedError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RevokeTokenNotSupportedError">RevokeTokenNotSupportedError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The provider does not support token revoke.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+    </div>
+
+</div>
+
+
+
+  </div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-class">
+
+
+
+<h4 id="httpx_oauth.clients.openid.OpenIDConfigurationError" class="doc doc-heading">
+            <code>OpenIDConfigurationError</code>
+
+
+<a href="#httpx_oauth.clients.openid.OpenIDConfigurationError" class="headerlink" title="Permanent link">&para;</a></h4>
+
+
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2RequestError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.OAuth2RequestError">OAuth2RequestError</a></code></p>
+
+
+      <p>Raised when an error occurred while fetching the OpenID configuration.</p>
+
+
+    </div>
+
+</div>
+
+
+
+
+  </div>
+
+    </div>
+
+</div><h2 id="reddit">Reddit<a class="headerlink" href="#reddit" title="Permanent link">&para;</a></h2>
+
+
+<div class="doc doc-object doc-module">
+
+
+
+<h3 id="httpx_oauth.clients.reddit" class="doc doc-heading">
+            <code>httpx_oauth.clients.reddit</code>
+
+
+<a href="#httpx_oauth.clients.reddit" class="headerlink" title="Permanent link">&para;</a></h3>
+
+    <div class="doc doc-contents first">
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+<div class="doc doc-object doc-class">
+
+
+
+<h4 id="httpx_oauth.clients.reddit.RedditOAuth2" class="doc doc-heading">
+            <code>RedditOAuth2</code>
+
+
+<a href="#httpx_oauth.clients.reddit.RedditOAuth2" class="headerlink" title="Permanent link">&para;</a></h4>
+
+
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.BaseOAuth2" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.BaseOAuth2">BaseOAuth2</a>[<a class="autorefs autorefs-external" title="typing.Dict" href="https://docs.python.org/3.8/library/typing.html#typing.Dict">Dict</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>, <a class="autorefs autorefs-external" title="typing.Any" href="https://docs.python.org/3.8/library/typing.html#typing.Any">Any</a>]]</code></p>
+
+
+      <p>OAuth2 client for Reddit.</p>
+
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.reddit.RedditOAuth2.__init__" class="doc doc-heading">
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">client_id</span><span class="p">,</span> <span class="n">client_secret</span><span class="p">,</span> <span class="n">scopes</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="s1">&#39;reddit&#39;</span><span class="p">)</span></code>
+
+<a href="#httpx_oauth.clients.reddit.RedditOAuth2.__init__" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>client_id</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The client ID provided by the OAuth2 provider.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>client_secret</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The client secret provided by the OAuth2 provider.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>scopes</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.List" href="https://docs.python.org/3.8/library/typing.html#typing.List">List</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The default scopes to be used in the authorization URL.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>name</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A unique name for the OAuth2 client.</p>
+              </div>
+            </td>
+            <td>
+                  <code>&#39;reddit&#39;</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.reddit.RedditOAuth2.get_access_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_access_token</span><span class="p">(</span><span class="n">code</span><span class="p">,</span> <span class="n">redirect_uri</span><span class="p">,</span> <span class="n">code_verifier</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.reddit.RedditOAuth2.get_access_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Requests an access token using the authorization code obtained
+after the user has authorized the application.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>code</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The authorization code.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>redirect_uri</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The URL where the user was redirected after authorization.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_verifier</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional code verifier used
+in the <a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> flow.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2Token" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.OAuth2Token">OAuth2Token</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An access token response dictionary.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.GetAccessTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.GetAccessTokenError">GetAccessTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while getting the access token.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">access_token</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">get_access_token</span><span class="p">(</span><span class="s2">&quot;CODE&quot;</span><span class="p">,</span> <span class="s2">&quot;https://www.tintagel.bt/oauth-callback&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.reddit.RedditOAuth2.get_authorization_url" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_authorization_url</span><span class="p">(</span><span class="n">redirect_uri</span><span class="p">,</span> <span class="n">state</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">code_challenge</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">code_challenge_method</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">extras_params</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.reddit.RedditOAuth2.get_authorization_url" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Builds the authorization URL
+where the user should be redirected to authorize the application.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>redirect_uri</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The URL where the user will be redirected after authorization.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>state</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An opaque value used by the client to maintain state</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>scope</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.List" href="https://docs.python.org/3.8/library/typing.html#typing.List">List</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The scopes to be requested.
+If not provided, <code>base_scopes</code> will be used.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_challenge</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional
+<a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> code challenge.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_challenge_method</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.Literal" href="https://docs.python.org/3.8/library/typing.html#typing.Literal">Literal</a>[&#39;plain&#39;, &#39;S256&#39;]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional
+<a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> code challenge
+method.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>extras_params</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<span title="httpx_oauth.oauth2.T">T</span>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional extra parameters specific to the service.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The authorization URL.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <p><code>py
+authorization_url = await client.get_authorization_url(
+    "https://www.tintagel.bt/oauth-callback", scope=["SCOPE1", "SCOPE2", "SCOPE3"],
+)</code>py</p>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.reddit.RedditOAuth2.get_id_email" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_id_email</span><span class="p">(</span><span class="n">token</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.reddit.RedditOAuth2.get_id_email" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Returns the id and the email (if available) of the authenticated user
+from the API provider.</p>
+<p><strong>It assumes you have asked for the required scopes</strong>.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The access token.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Tuple" href="https://docs.python.org/3.8/library/typing.html#typing.Tuple">Tuple</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>, <a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A tuple with the id and the email of the authenticated user.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.exceptions.GetIdEmailError" href="../httpx_oauth.exceptions/#httpx_oauth.exceptions.GetIdEmailError">GetIdEmailError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while getting the id and email.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">user_id</span><span class="p">,</span> <span class="n">user_email</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">get_id_email</span><span class="p">(</span><span class="s2">&quot;TOKEN&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.reddit.RedditOAuth2.refresh_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">refresh_token</span><span class="p">(</span><span class="n">refresh_token</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.reddit.RedditOAuth2.refresh_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Requests a new access token using a refresh token.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>refresh_token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The refresh token.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2Token" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.OAuth2Token">OAuth2Token</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An access token response dictionary.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RefreshTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RefreshTokenError">RefreshTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while refreshing the token.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RefreshTokenNotSupportedError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RefreshTokenNotSupportedError">RefreshTokenNotSupportedError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The provider does not support token refresh.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">access_token</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">refresh_token</span><span class="p">(</span><span class="s2">&quot;REFRESH_TOKEN&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.reddit.RedditOAuth2.revoke_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">revoke_token</span><span class="p">(</span><span class="n">token</span><span class="p">,</span> <span class="n">token_type_hint</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.reddit.RedditOAuth2.revoke_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Revokes a token.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A token or refresh token to revoke.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>token_type_hint</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional hint for the service to help it determine
+if it's a token or refresh token.
+Usually either <code>token</code> or <code>refresh_token</code>.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code>None</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>None</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RevokeTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RevokeTokenError">RevokeTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while revoking the token.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RevokeTokenNotSupportedError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RevokeTokenNotSupportedError">RevokeTokenNotSupportedError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The provider does not support token revoke.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+    </div>
+
+</div>
+
+
+
+  </div>
+
+    </div>
+
+</div>
+
+
+
+
+  </div>
+
+    </div>
+
+</div><h2 id="shopify">Shopify<a class="headerlink" href="#shopify" title="Permanent link">&para;</a></h2>
+
+
+<div class="doc doc-object doc-module">
+
+
+
+<h3 id="httpx_oauth.clients.shopify" class="doc doc-heading">
+            <code>httpx_oauth.clients.shopify</code>
+
+
+<a href="#httpx_oauth.clients.shopify" class="headerlink" title="Permanent link">&para;</a></h3>
+
+    <div class="doc doc-contents first">
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+<div class="doc doc-object doc-class">
+
+
+
+<h4 id="httpx_oauth.clients.shopify.ShopifyOAuth2" class="doc doc-heading">
+            <code>ShopifyOAuth2</code>
+
+
+<a href="#httpx_oauth.clients.shopify.ShopifyOAuth2" class="headerlink" title="Permanent link">&para;</a></h4>
+
+
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.BaseOAuth2" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.BaseOAuth2">BaseOAuth2</a>[<span title="httpx_oauth.clients.shopify.ShopifyOAuth2AuthorizeParams">ShopifyOAuth2AuthorizeParams</span>]</code></p>
+
+
+      <p>OAuth2 client for Shopify.</p>
+<p>The OAuth2 client for Shopify authenticates shop owners to allow making calls
+to the <a href="https://shopify.dev/docs/api/admin">Shopify Admin API</a>.</p>
+
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.shopify.ShopifyOAuth2.__init__" class="doc doc-heading">
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">client_id</span><span class="p">,</span> <span class="n">client_secret</span><span class="p">,</span> <span class="n">shop</span><span class="p">,</span> <span class="n">scopes</span><span class="o">=</span><span class="n">BASE_SCOPES</span><span class="p">,</span> <span class="n">api_version</span><span class="o">=</span><span class="s1">&#39;2023-04&#39;</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="s1">&#39;shopify&#39;</span><span class="p">)</span></code>
+
+<a href="#httpx_oauth.clients.shopify.ShopifyOAuth2.__init__" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>client_id</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The client ID provided by the OAuth2 provider.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>client_secret</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The client secret provided by the OAuth2 provider.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>shop</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The shop subdomain.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>scopes</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.List" href="https://docs.python.org/3.8/library/typing.html#typing.List">List</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The default scopes to be used in the authorization URL.</p>
+              </div>
+            </td>
+            <td>
+                  <code><span title="httpx_oauth.clients.shopify.BASE_SCOPES">BASE_SCOPES</span></code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>api_version</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The version of the Shopify Admin API.</p>
+              </div>
+            </td>
+            <td>
+                  <code>&#39;2023-04&#39;</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>name</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A unique name for the OAuth2 client.</p>
+              </div>
+            </td>
+            <td>
+                  <code>&#39;shopify&#39;</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.shopify.ShopifyOAuth2.get_access_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_access_token</span><span class="p">(</span><span class="n">code</span><span class="p">,</span> <span class="n">redirect_uri</span><span class="p">,</span> <span class="n">code_verifier</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.shopify.ShopifyOAuth2.get_access_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Requests an access token using the authorization code obtained
+after the user has authorized the application.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>code</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The authorization code.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>redirect_uri</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The URL where the user was redirected after authorization.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_verifier</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional code verifier used
+in the <a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> flow.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2Token" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.OAuth2Token">OAuth2Token</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An access token response dictionary.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.GetAccessTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.GetAccessTokenError">GetAccessTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while getting the access token.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">access_token</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">get_access_token</span><span class="p">(</span><span class="s2">&quot;CODE&quot;</span><span class="p">,</span> <span class="s2">&quot;https://www.tintagel.bt/oauth-callback&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.shopify.ShopifyOAuth2.get_authorization_url" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_authorization_url</span><span class="p">(</span><span class="n">redirect_uri</span><span class="p">,</span> <span class="n">state</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">code_challenge</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">code_challenge_method</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">extras_params</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.shopify.ShopifyOAuth2.get_authorization_url" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Builds the authorization URL
+where the user should be redirected to authorize the application.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>redirect_uri</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The URL where the user will be redirected after authorization.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>state</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An opaque value used by the client to maintain state</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>scope</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.List" href="https://docs.python.org/3.8/library/typing.html#typing.List">List</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The scopes to be requested.
+If not provided, <code>base_scopes</code> will be used.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_challenge</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional
+<a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> code challenge.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_challenge_method</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.Literal" href="https://docs.python.org/3.8/library/typing.html#typing.Literal">Literal</a>[&#39;plain&#39;, &#39;S256&#39;]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional
+<a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> code challenge
+method.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>extras_params</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<span title="httpx_oauth.oauth2.T">T</span>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional extra parameters specific to the service.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The authorization URL.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <p><code>py
+authorization_url = await client.get_authorization_url(
+    "https://www.tintagel.bt/oauth-callback", scope=["SCOPE1", "SCOPE2", "SCOPE3"],
+)</code>py</p>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.shopify.ShopifyOAuth2.get_id_email" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_id_email</span><span class="p">(</span><span class="n">token</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.shopify.ShopifyOAuth2.get_id_email" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Returns the id and the email (if available) of the authenticated user
+from the API provider.</p>
+<div class="admonition warning">
+<p class="admonition-title"><code>get_id_email</code> is based on the <code>Shop</code> resource</p>
+<p>The implementation of <code>get_id_email</code> calls the <a href="https://shopify.dev/docs/api/admin-rest/2023-04/resources/shop#get-shop">Get Shop endpoint</a> of the Shopify Admin API.
+It means that it'll return you the <strong>ID of the shop</strong> and the <strong>email of the shop owner</strong>.</p>
+</div>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The access token.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Tuple" href="https://docs.python.org/3.8/library/typing.html#typing.Tuple">Tuple</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>, <a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A tuple with the id and the email of the authenticated user.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.exceptions.GetIdEmailError" href="../httpx_oauth.exceptions/#httpx_oauth.exceptions.GetIdEmailError">GetIdEmailError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while getting the id and email.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">user_id</span><span class="p">,</span> <span class="n">user_email</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">get_id_email</span><span class="p">(</span><span class="s2">&quot;TOKEN&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.shopify.ShopifyOAuth2.refresh_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">refresh_token</span><span class="p">(</span><span class="n">refresh_token</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.shopify.ShopifyOAuth2.refresh_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Requests a new access token using a refresh token.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>refresh_token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The refresh token.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2Token" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.OAuth2Token">OAuth2Token</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An access token response dictionary.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RefreshTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RefreshTokenError">RefreshTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while refreshing the token.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RefreshTokenNotSupportedError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RefreshTokenNotSupportedError">RefreshTokenNotSupportedError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The provider does not support token refresh.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">access_token</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">refresh_token</span><span class="p">(</span><span class="s2">&quot;REFRESH_TOKEN&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h5 id="httpx_oauth.clients.shopify.ShopifyOAuth2.revoke_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">revoke_token</span><span class="p">(</span><span class="n">token</span><span class="p">,</span> <span class="n">token_type_hint</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.clients.shopify.ShopifyOAuth2.revoke_token" class="headerlink" title="Permanent link">&para;</a></h5>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Revokes a token.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A token or refresh token to revoke.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>token_type_hint</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional hint for the service to help it determine
+if it's a token or refresh token.
+Usually either <code>token</code> or <code>refresh_token</code>.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code>None</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>None</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RevokeTokenError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RevokeTokenError">RevokeTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while revoking the token.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RevokeTokenNotSupportedError" href="../httpx_oauth.oauth2/#httpx_oauth.oauth2.RevokeTokenNotSupportedError">RevokeTokenNotSupportedError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The provider does not support token revoke.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+    </div>
+
+</div>
+
+
+
+  </div>
+
+    </div>
+
+</div>
+
+
+
+
+  </div>
+
+    </div>
+
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+                
+              </article>
+            </div>
+          
+          
+<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
+        </div>
+        
+      </main>
+      
+        <footer class="md-footer">
+  
+  <div class="md-footer-meta md-typeset">
+    <div class="md-footer-meta__inner md-grid">
+      <div class="md-copyright">
+  
+  
+    Made with
+    <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
+      Material for MkDocs
+    </a>
+  
+</div>
+      
+    </div>
+  </div>
+</footer>
+      
+    </div>
+    <div class="md-dialog" data-md-component="dialog">
+      <div class="md-dialog__inner md-typeset"></div>
+    </div>
+    
+    
+    <script id="__config" type="application/json">{"base": "../..", "features": ["content.code.copy"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
+    
+    
+      <script src="../../assets/javascripts/bundle.fe8b6f2b.min.js"></script>
+      
+    
+  </body>
+</html>
\ No newline at end of file
diff --git a/reference/httpx_oauth.exceptions/index.html b/reference/httpx_oauth.exceptions/index.html
new file mode 100644
index 0000000..36f40b0
--- /dev/null
+++ b/reference/httpx_oauth.exceptions/index.html
@@ -0,0 +1,766 @@
+
+<!doctype html>
+<html lang="en" class="no-js">
+  <head>
+    
+      <meta charset="utf-8">
+      <meta name="viewport" content="width=device-width,initial-scale=1">
+      
+        <meta name="description" content="Async OAuth client using HTTPX">
+      
+      
+      
+      
+        <link rel="prev" href="../httpx_oauth.oauth2/">
+      
+      
+      
+      <link rel="icon" href="../../assets/images/favicon.png">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.28">
+    
+    
+      
+        <title>httpx_oauth.exceptions - HTTPX OAuth</title>
+      
+    
+    
+      <link rel="stylesheet" href="../../assets/stylesheets/main.6543a935.min.css">
+      
+        
+        <link rel="stylesheet" href="../../assets/stylesheets/palette.06af60db.min.css">
+      
+      
+
+
+    
+    
+      
+    
+    
+      
+        
+        
+        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
+        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
+      
+    
+    
+      <link rel="stylesheet" href="../../assets/_mkdocstrings.css">
+    
+      <link rel="stylesheet" href="../../assets/stylesheets/extra.css">
+    
+    <script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
+    
+      
+
+    
+    
+    
+  </head>
+  
+  
+    
+    
+      
+    
+    
+    
+    
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo">
+  
+    
+    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
+    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
+    <label class="md-overlay" for="__drawer"></label>
+    <div data-md-component="skip">
+      
+        
+        <a href="#reference-exceptions" class="md-skip">
+          Skip to content
+        </a>
+      
+    </div>
+    <div data-md-component="announce">
+      
+    </div>
+    
+    
+      
+
+  
+
+<header class="md-header md-header--shadow" data-md-component="header">
+  <nav class="md-header__inner md-grid" aria-label="Header">
+    <a href="../.." title="HTTPX OAuth" class="md-header__button md-logo" aria-label="HTTPX OAuth" data-md-component="logo">
+      
+  
+  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 12h7c-.53 4.11-3.28 7.78-7 8.92V12H5V6.3l7-3.11M12 1 3 5v6c0 5.55 3.84 10.73 9 12 5.16-1.27 9-6.45 9-12V5l-9-4Z"/></svg>
+
+    </a>
+    <label class="md-header__button md-icon" for="__drawer">
+      
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
+    </label>
+    <div class="md-header__title" data-md-component="header-title">
+      <div class="md-header__ellipsis">
+        <div class="md-header__topic">
+          <span class="md-ellipsis">
+            HTTPX OAuth
+          </span>
+        </div>
+        <div class="md-header__topic" data-md-component="header-topic">
+          <span class="md-ellipsis">
+            
+              httpx_oauth.exceptions
+            
+          </span>
+        </div>
+      </div>
+    </div>
+    
+      
+        <form class="md-header__option" data-md-component="palette">
+  
+    
+    
+    
+    <input class="md-option" data-md-color-media="(prefers-color-scheme)" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo"  aria-label="Switch to light mode"  type="radio" name="__palette" id="__palette_0">
+    
+      <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_1" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m14.3 16-.7-2h-3.2l-.7 2H7.8L11 7h2l3.2 9h-1.9M20 8.69V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69m-9.15 3.96h2.3L12 9l-1.15 3.65Z"/></svg>
+      </label>
+    
+  
+    
+    
+    
+    <input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="blue-grey"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_1">
+    
+      <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_2" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
+      </label>
+    
+  
+    
+    
+    
+    <input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="blue-grey" data-md-color-accent="blue-grey"  aria-label="Switch to light mode"  type="radio" name="__palette" id="__palette_2">
+    
+      <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_0" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12c0-2.42-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
+      </label>
+    
+  
+</form>
+      
+    
+    
+      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
+    
+    
+    
+      <label class="md-header__button md-icon" for="__search">
+        
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
+      </label>
+      <div class="md-search" data-md-component="search" role="dialog">
+  <label class="md-search__overlay" for="__search"></label>
+  <div class="md-search__inner" role="search">
+    <form class="md-search__form" name="search">
+      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
+      <label class="md-search__icon md-icon" for="__search">
+        
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
+        
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
+      </label>
+      <nav class="md-search__options" aria-label="Search">
+        
+        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
+          
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
+        </button>
+      </nav>
+      
+    </form>
+    <div class="md-search__output">
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
+        <div class="md-search-result" data-md-component="search-result">
+          <div class="md-search-result__meta">
+            Initializing search
+          </div>
+          <ol class="md-search-result__list" role="presentation"></ol>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>
+    
+    
+      <div class="md-header__source">
+        <a href="https://github.com/frankie567/httpx-oauth" title="Go to repository" class="md-source" data-md-component="source">
+  <div class="md-source__icon md-icon">
+    
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
+  </div>
+  <div class="md-source__repository">
+    frankie567/httpx-oauth
+  </div>
+</a>
+      </div>
+    
+  </nav>
+  
+</header>
+    
+    <div class="md-container" data-md-component="container">
+      
+      
+        
+          
+        
+      
+      <main class="md-main" data-md-component="main">
+        <div class="md-main__inner md-grid">
+          
+            
+              
+              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+                    
+
+
+
+<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
+  <label class="md-nav__title" for="__drawer">
+    <a href="../.." title="HTTPX OAuth" class="md-nav__button md-logo" aria-label="HTTPX OAuth" data-md-component="logo">
+      
+  
+  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 12h7c-.53 4.11-3.28 7.78-7 8.92V12H5V6.3l7-3.11M12 1 3 5v6c0 5.55 3.84 10.73 9 12 5.16-1.27 9-6.45 9-12V5l-9-4Z"/></svg>
+
+    </a>
+    HTTPX OAuth
+  </label>
+  
+    <div class="md-nav__source">
+      <a href="https://github.com/frankie567/httpx-oauth" title="Go to repository" class="md-source" data-md-component="source">
+  <div class="md-source__icon md-icon">
+    
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
+  </div>
+  <div class="md-source__repository">
+    frankie567/httpx-oauth
+  </div>
+</a>
+    </div>
+  
+  <ul class="md-nav__list" data-md-scrollfix>
+    
+      
+      
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../.." class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    About
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../usage/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Usage
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+  
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
+        
+          
+          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
+            
+  
+  <span class="md-ellipsis">
+    Integrations
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_3">
+            <span class="md-nav__icon md-icon"></span>
+            Integrations
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../fastapi/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    FastAPI
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+    
+  
+  
+  
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" checked>
+        
+          
+          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
+            
+  
+  <span class="md-ellipsis">
+    Reference
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_4">
+            <span class="md-nav__icon md-icon"></span>
+            Reference
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../httpx_oauth.clients/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    httpx_oauth.clients
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../httpx_oauth.oauth2/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    httpx_oauth.oauth2
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+    
+  
+  
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+        
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    httpx_oauth.exceptions
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
+        
+  
+  <span class="md-ellipsis">
+    httpx_oauth.exceptions
+  </span>
+  
+
+      </a>
+      
+        
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+    
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.exceptions" class="md-nav__link">
+    <span class="md-ellipsis">
+      exceptions
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.exceptions.GetIdEmailError" class="md-nav__link">
+    <span class="md-ellipsis">
+      GetIdEmailError
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.exceptions.HTTPXOAuthError" class="md-nav__link">
+    <span class="md-ellipsis">
+      HTTPXOAuthError
+    </span>
+  </a>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+      
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+  </ul>
+</nav>
+                  </div>
+                </div>
+              </div>
+            
+            
+              
+              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+                    
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+    
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.exceptions" class="md-nav__link">
+    <span class="md-ellipsis">
+      exceptions
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.exceptions.GetIdEmailError" class="md-nav__link">
+    <span class="md-ellipsis">
+      GetIdEmailError
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.exceptions.HTTPXOAuthError" class="md-nav__link">
+    <span class="md-ellipsis">
+      HTTPXOAuthError
+    </span>
+  </a>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+                  </div>
+                </div>
+              </div>
+            
+          
+          
+            <div class="md-content" data-md-component="content">
+              <article class="md-content__inner md-typeset">
+                
+                  
+
+
+<h1 id="reference-exceptions">Reference - Exceptions<a class="headerlink" href="#reference-exceptions" title="Permanent link">&para;</a></h1>
+
+
+<div class="doc doc-object doc-module">
+
+
+
+<a id="httpx_oauth.exceptions"></a>
+    <div class="doc doc-contents first">
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+<div class="doc doc-object doc-class">
+
+
+
+<h2 id="httpx_oauth.exceptions.GetIdEmailError" class="doc doc-heading">
+            <code>GetIdEmailError</code>
+
+
+<a href="#httpx_oauth.exceptions.GetIdEmailError" class="headerlink" title="Permanent link">&para;</a></h2>
+
+
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="httpx_oauth.exceptions.HTTPXOAuthError" href="#httpx_oauth.exceptions.HTTPXOAuthError">HTTPXOAuthError</a></code></p>
+
+
+      <p>Error raised while retrieving user profile from provider API.</p>
+
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+
+
+
+  </div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-class">
+
+
+
+<h2 id="httpx_oauth.exceptions.HTTPXOAuthError" class="doc doc-heading">
+            <code>HTTPXOAuthError</code>
+
+
+<a href="#httpx_oauth.exceptions.HTTPXOAuthError" class="headerlink" title="Permanent link">&para;</a></h2>
+
+
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/exceptions.html#Exception">Exception</a></code></p>
+
+
+      <p>Base exception class for every httpx-oauth errors.</p>
+
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+
+
+
+  </div>
+
+    </div>
+
+</div>
+
+
+
+
+  </div>
+
+    </div>
+
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+                
+              </article>
+            </div>
+          
+          
+<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
+        </div>
+        
+      </main>
+      
+        <footer class="md-footer">
+  
+  <div class="md-footer-meta md-typeset">
+    <div class="md-footer-meta__inner md-grid">
+      <div class="md-copyright">
+  
+  
+    Made with
+    <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
+      Material for MkDocs
+    </a>
+  
+</div>
+      
+    </div>
+  </div>
+</footer>
+      
+    </div>
+    <div class="md-dialog" data-md-component="dialog">
+      <div class="md-dialog__inner md-typeset"></div>
+    </div>
+    
+    
+    <script id="__config" type="application/json">{"base": "../..", "features": ["content.code.copy"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
+    
+    
+      <script src="../../assets/javascripts/bundle.fe8b6f2b.min.js"></script>
+      
+    
+  </body>
+</html>
\ No newline at end of file
diff --git a/reference/httpx_oauth.oauth2/index.html b/reference/httpx_oauth.oauth2/index.html
new file mode 100644
index 0000000..d3a9114
--- /dev/null
+++ b/reference/httpx_oauth.oauth2/index.html
@@ -0,0 +1,2336 @@
+
+<!doctype html>
+<html lang="en" class="no-js">
+  <head>
+    
+      <meta charset="utf-8">
+      <meta name="viewport" content="width=device-width,initial-scale=1">
+      
+        <meta name="description" content="Async OAuth client using HTTPX">
+      
+      
+      
+      
+        <link rel="prev" href="../httpx_oauth.clients/">
+      
+      
+        <link rel="next" href="../httpx_oauth.exceptions/">
+      
+      
+      <link rel="icon" href="../../assets/images/favicon.png">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.28">
+    
+    
+      
+        <title>httpx_oauth.oauth2 - HTTPX OAuth</title>
+      
+    
+    
+      <link rel="stylesheet" href="../../assets/stylesheets/main.6543a935.min.css">
+      
+        
+        <link rel="stylesheet" href="../../assets/stylesheets/palette.06af60db.min.css">
+      
+      
+
+
+    
+    
+      
+    
+    
+      
+        
+        
+        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
+        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
+      
+    
+    
+      <link rel="stylesheet" href="../../assets/_mkdocstrings.css">
+    
+      <link rel="stylesheet" href="../../assets/stylesheets/extra.css">
+    
+    <script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
+    
+      
+
+    
+    
+    
+  </head>
+  
+  
+    
+    
+      
+    
+    
+    
+    
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo">
+  
+    
+    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
+    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
+    <label class="md-overlay" for="__drawer"></label>
+    <div data-md-component="skip">
+      
+        
+        <a href="#reference-oauth2" class="md-skip">
+          Skip to content
+        </a>
+      
+    </div>
+    <div data-md-component="announce">
+      
+    </div>
+    
+    
+      
+
+  
+
+<header class="md-header md-header--shadow" data-md-component="header">
+  <nav class="md-header__inner md-grid" aria-label="Header">
+    <a href="../.." title="HTTPX OAuth" class="md-header__button md-logo" aria-label="HTTPX OAuth" data-md-component="logo">
+      
+  
+  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 12h7c-.53 4.11-3.28 7.78-7 8.92V12H5V6.3l7-3.11M12 1 3 5v6c0 5.55 3.84 10.73 9 12 5.16-1.27 9-6.45 9-12V5l-9-4Z"/></svg>
+
+    </a>
+    <label class="md-header__button md-icon" for="__drawer">
+      
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
+    </label>
+    <div class="md-header__title" data-md-component="header-title">
+      <div class="md-header__ellipsis">
+        <div class="md-header__topic">
+          <span class="md-ellipsis">
+            HTTPX OAuth
+          </span>
+        </div>
+        <div class="md-header__topic" data-md-component="header-topic">
+          <span class="md-ellipsis">
+            
+              httpx_oauth.oauth2
+            
+          </span>
+        </div>
+      </div>
+    </div>
+    
+      
+        <form class="md-header__option" data-md-component="palette">
+  
+    
+    
+    
+    <input class="md-option" data-md-color-media="(prefers-color-scheme)" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo"  aria-label="Switch to light mode"  type="radio" name="__palette" id="__palette_0">
+    
+      <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_1" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m14.3 16-.7-2h-3.2l-.7 2H7.8L11 7h2l3.2 9h-1.9M20 8.69V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69m-9.15 3.96h2.3L12 9l-1.15 3.65Z"/></svg>
+      </label>
+    
+  
+    
+    
+    
+    <input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="blue-grey"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_1">
+    
+      <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_2" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
+      </label>
+    
+  
+    
+    
+    
+    <input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="blue-grey" data-md-color-accent="blue-grey"  aria-label="Switch to light mode"  type="radio" name="__palette" id="__palette_2">
+    
+      <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_0" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12c0-2.42-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
+      </label>
+    
+  
+</form>
+      
+    
+    
+      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
+    
+    
+    
+      <label class="md-header__button md-icon" for="__search">
+        
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
+      </label>
+      <div class="md-search" data-md-component="search" role="dialog">
+  <label class="md-search__overlay" for="__search"></label>
+  <div class="md-search__inner" role="search">
+    <form class="md-search__form" name="search">
+      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
+      <label class="md-search__icon md-icon" for="__search">
+        
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
+        
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
+      </label>
+      <nav class="md-search__options" aria-label="Search">
+        
+        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
+          
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
+        </button>
+      </nav>
+      
+    </form>
+    <div class="md-search__output">
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
+        <div class="md-search-result" data-md-component="search-result">
+          <div class="md-search-result__meta">
+            Initializing search
+          </div>
+          <ol class="md-search-result__list" role="presentation"></ol>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>
+    
+    
+      <div class="md-header__source">
+        <a href="https://github.com/frankie567/httpx-oauth" title="Go to repository" class="md-source" data-md-component="source">
+  <div class="md-source__icon md-icon">
+    
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
+  </div>
+  <div class="md-source__repository">
+    frankie567/httpx-oauth
+  </div>
+</a>
+      </div>
+    
+  </nav>
+  
+</header>
+    
+    <div class="md-container" data-md-component="container">
+      
+      
+        
+          
+        
+      
+      <main class="md-main" data-md-component="main">
+        <div class="md-main__inner md-grid">
+          
+            
+              
+              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+                    
+
+
+
+<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
+  <label class="md-nav__title" for="__drawer">
+    <a href="../.." title="HTTPX OAuth" class="md-nav__button md-logo" aria-label="HTTPX OAuth" data-md-component="logo">
+      
+  
+  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 12h7c-.53 4.11-3.28 7.78-7 8.92V12H5V6.3l7-3.11M12 1 3 5v6c0 5.55 3.84 10.73 9 12 5.16-1.27 9-6.45 9-12V5l-9-4Z"/></svg>
+
+    </a>
+    HTTPX OAuth
+  </label>
+  
+    <div class="md-nav__source">
+      <a href="https://github.com/frankie567/httpx-oauth" title="Go to repository" class="md-source" data-md-component="source">
+  <div class="md-source__icon md-icon">
+    
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
+  </div>
+  <div class="md-source__repository">
+    frankie567/httpx-oauth
+  </div>
+</a>
+    </div>
+  
+  <ul class="md-nav__list" data-md-scrollfix>
+    
+      
+      
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../.." class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    About
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../usage/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Usage
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+  
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
+        
+          
+          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
+            
+  
+  <span class="md-ellipsis">
+    Integrations
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_3">
+            <span class="md-nav__icon md-icon"></span>
+            Integrations
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../fastapi/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    FastAPI
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+    
+  
+  
+  
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--active md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" checked>
+        
+          
+          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
+            
+  
+  <span class="md-ellipsis">
+    Reference
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_4">
+            <span class="md-nav__icon md-icon"></span>
+            Reference
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../httpx_oauth.clients/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    httpx_oauth.clients
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+    
+  
+  
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+        
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    httpx_oauth.oauth2
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
+        
+  
+  <span class="md-ellipsis">
+    httpx_oauth.oauth2
+  </span>
+  
+
+      </a>
+      
+        
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+    
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2" class="md-nav__link">
+    <span class="md-ellipsis">
+      oauth2
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.OAuth2" class="md-nav__link">
+    <span class="md-ellipsis">
+      OAuth2
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.OAuth2ClientAuthMethod" class="md-nav__link">
+    <span class="md-ellipsis">
+      OAuth2ClientAuthMethod
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.BaseOAuth2" class="md-nav__link">
+    <span class="md-ellipsis">
+      BaseOAuth2
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="BaseOAuth2">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.BaseOAuth2.__init__" class="md-nav__link">
+    <span class="md-ellipsis">
+      __init__
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.BaseOAuth2.get_access_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_access_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.BaseOAuth2.get_authorization_url" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_authorization_url
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.BaseOAuth2.get_id_email" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_id_email
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.BaseOAuth2.refresh_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      refresh_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.BaseOAuth2.revoke_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      revoke_token
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.GetAccessTokenError" class="md-nav__link">
+    <span class="md-ellipsis">
+      GetAccessTokenError
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.MissingRevokeTokenAuthMethodError" class="md-nav__link">
+    <span class="md-ellipsis">
+      MissingRevokeTokenAuthMethodError
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.NotSupportedAuthMethodError" class="md-nav__link">
+    <span class="md-ellipsis">
+      NotSupportedAuthMethodError
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.OAuth2Error" class="md-nav__link">
+    <span class="md-ellipsis">
+      OAuth2Error
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.OAuth2RequestError" class="md-nav__link">
+    <span class="md-ellipsis">
+      OAuth2RequestError
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.OAuth2Token" class="md-nav__link">
+    <span class="md-ellipsis">
+      OAuth2Token
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="OAuth2Token">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.OAuth2Token.is_expired" class="md-nav__link">
+    <span class="md-ellipsis">
+      is_expired
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.RefreshTokenError" class="md-nav__link">
+    <span class="md-ellipsis">
+      RefreshTokenError
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.RefreshTokenNotSupportedError" class="md-nav__link">
+    <span class="md-ellipsis">
+      RefreshTokenNotSupportedError
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.RevokeTokenError" class="md-nav__link">
+    <span class="md-ellipsis">
+      RevokeTokenError
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.RevokeTokenNotSupportedError" class="md-nav__link">
+    <span class="md-ellipsis">
+      RevokeTokenNotSupportedError
+    </span>
+  </a>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../httpx_oauth.exceptions/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    httpx_oauth.exceptions
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+  </ul>
+</nav>
+                  </div>
+                </div>
+              </div>
+            
+            
+              
+              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+                    
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+    
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2" class="md-nav__link">
+    <span class="md-ellipsis">
+      oauth2
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.OAuth2" class="md-nav__link">
+    <span class="md-ellipsis">
+      OAuth2
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.OAuth2ClientAuthMethod" class="md-nav__link">
+    <span class="md-ellipsis">
+      OAuth2ClientAuthMethod
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.BaseOAuth2" class="md-nav__link">
+    <span class="md-ellipsis">
+      BaseOAuth2
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="BaseOAuth2">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.BaseOAuth2.__init__" class="md-nav__link">
+    <span class="md-ellipsis">
+      __init__
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.BaseOAuth2.get_access_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_access_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.BaseOAuth2.get_authorization_url" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_authorization_url
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.BaseOAuth2.get_id_email" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_id_email
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.BaseOAuth2.refresh_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      refresh_token
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.BaseOAuth2.revoke_token" class="md-nav__link">
+    <span class="md-ellipsis">
+      revoke_token
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.GetAccessTokenError" class="md-nav__link">
+    <span class="md-ellipsis">
+      GetAccessTokenError
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.MissingRevokeTokenAuthMethodError" class="md-nav__link">
+    <span class="md-ellipsis">
+      MissingRevokeTokenAuthMethodError
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.NotSupportedAuthMethodError" class="md-nav__link">
+    <span class="md-ellipsis">
+      NotSupportedAuthMethodError
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.OAuth2Error" class="md-nav__link">
+    <span class="md-ellipsis">
+      OAuth2Error
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.OAuth2RequestError" class="md-nav__link">
+    <span class="md-ellipsis">
+      OAuth2RequestError
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.OAuth2Token" class="md-nav__link">
+    <span class="md-ellipsis">
+      OAuth2Token
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="OAuth2Token">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.OAuth2Token.is_expired" class="md-nav__link">
+    <span class="md-ellipsis">
+      is_expired
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.RefreshTokenError" class="md-nav__link">
+    <span class="md-ellipsis">
+      RefreshTokenError
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.RefreshTokenNotSupportedError" class="md-nav__link">
+    <span class="md-ellipsis">
+      RefreshTokenNotSupportedError
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.RevokeTokenError" class="md-nav__link">
+    <span class="md-ellipsis">
+      RevokeTokenError
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#httpx_oauth.oauth2.RevokeTokenNotSupportedError" class="md-nav__link">
+    <span class="md-ellipsis">
+      RevokeTokenNotSupportedError
+    </span>
+  </a>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+                  </div>
+                </div>
+              </div>
+            
+          
+          
+            <div class="md-content" data-md-component="content">
+              <article class="md-content__inner md-typeset">
+                
+                  
+
+
+<h1 id="reference-oauth2">Reference - OAuth2<a class="headerlink" href="#reference-oauth2" title="Permanent link">&para;</a></h1>
+
+
+<div class="doc doc-object doc-module">
+
+
+
+<a id="httpx_oauth.oauth2"></a>
+    <div class="doc doc-contents first">
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+<div class="doc doc-object doc-attribute">
+
+
+
+<h2 id="httpx_oauth.oauth2.OAuth2" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">OAuth2</span> <span class="o">=</span> <span class="n">BaseOAuth2</span><span class="p">[</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]]</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small>
+  </span>
+
+<a href="#httpx_oauth.oauth2.OAuth2" class="headerlink" title="Permanent link">&para;</a></h2>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Generic OAuth2 client.</p>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="kn">from</span> <span class="nn">httpx_oauth.oauth2</span> <span class="kn">import</span> <span class="n">OAuth2</span>
+<a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a>
+<a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="n">client</span> <span class="o">=</span> <span class="n">OAuth2</span><span class="p">(</span>
+<a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a>    <span class="s2">&quot;CLIENT_ID&quot;</span><span class="p">,</span>
+<a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a>    <span class="s2">&quot;CLIENT_SECRET&quot;</span><span class="p">,</span>
+<a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a>    <span class="s2">&quot;AUTHORIZE_ENDPOINT&quot;</span><span class="p">,</span>
+<a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a>    <span class="s2">&quot;ACCESS_TOKEN_ENDPOINT&quot;</span><span class="p">,</span>
+<a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a>    <span class="n">refresh_token_endpoint</span><span class="o">=</span><span class="s2">&quot;REFRESH_TOKEN_ENDPOINT&quot;</span><span class="p">,</span>
+<a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a>    <span class="n">revoke_token_endpoint</span><span class="o">=</span><span class="s2">&quot;REVOKE_TOKEN_ENDPOINT&quot;</span><span class="p">,</span>
+<a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="p">)</span>
+</code></pre></div>
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-attribute">
+
+
+
+<h2 id="httpx_oauth.oauth2.OAuth2ClientAuthMethod" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">OAuth2ClientAuthMethod</span> <span class="o">=</span> <span class="n">Literal</span><span class="p">[</span><span class="s1">&#39;client_secret_basic&#39;</span><span class="p">,</span> <span class="s1">&#39;client_secret_post&#39;</span><span class="p">]</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small>
+  </span>
+
+<a href="#httpx_oauth.oauth2.OAuth2ClientAuthMethod" class="headerlink" title="Permanent link">&para;</a></h2>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Supported OAuth2 client authentication methods.</p>
+    </div>
+
+</div>
+
+
+<div class="doc doc-object doc-class">
+
+
+
+<h2 id="httpx_oauth.oauth2.BaseOAuth2" class="doc doc-heading">
+            <code>BaseOAuth2</code>
+
+
+<a href="#httpx_oauth.oauth2.BaseOAuth2" class="headerlink" title="Permanent link">&para;</a></h2>
+
+
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-external" title="typing.Generic" href="https://docs.python.org/3.8/library/typing.html#typing.Generic">Generic</a>[<span title="httpx_oauth.oauth2.T">T</span>]</code></p>
+
+
+      <p>Base OAuth2 client.</p>
+<p>This class provides a base implementation for OAuth2 clients. If you need to use a generic client, use <a class="autorefs autorefs-internal" href="#httpx_oauth.oauth2.OAuth2">OAuth2</a> instead.</p>
+
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+
+<div class="doc doc-object doc-function">
+
+
+<h3 id="httpx_oauth.oauth2.BaseOAuth2.__init__" class="doc doc-heading">
+            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">client_id</span><span class="p">,</span> <span class="n">client_secret</span><span class="p">,</span> <span class="n">authorize_endpoint</span><span class="p">,</span> <span class="n">access_token_endpoint</span><span class="p">,</span> <span class="n">refresh_token_endpoint</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">revoke_token_endpoint</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">*</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="s1">&#39;oauth2&#39;</span><span class="p">,</span> <span class="n">base_scopes</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">token_endpoint_auth_method</span><span class="o">=</span><span class="s1">&#39;client_secret_post&#39;</span><span class="p">,</span> <span class="n">revocation_endpoint_auth_method</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+<a href="#httpx_oauth.oauth2.BaseOAuth2.__init__" class="headerlink" title="Permanent link">&para;</a></h3>
+
+
+    <div class="doc doc-contents ">
+
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>client_id</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The client ID provided by the OAuth2 provider.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>client_secret</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The client secret provided by the OAuth2 provider.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>authorize_endpoint</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The authorization endpoint URL.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>access_token_endpoint</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The access token endpoint URL.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>refresh_token_endpoint</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The refresh token endpoint URL.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>revoke_token_endpoint</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The revoke token endpoint URL.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>name</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A unique name for the OAuth2 client.</p>
+              </div>
+            </td>
+            <td>
+                  <code>&#39;oauth2&#39;</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>base_scopes</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.List" href="https://docs.python.org/3.8/library/typing.html#typing.List">List</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The base scopes to be used in the authorization URL.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>token_endpoint_auth_method</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2ClientAuthMethod" href="#httpx_oauth.oauth2.OAuth2ClientAuthMethod">OAuth2ClientAuthMethod</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The authentication method to be used in the token endpoint.</p>
+              </div>
+            </td>
+            <td>
+                  <code>&#39;client_secret_post&#39;</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>revocation_endpoint_auth_method</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2ClientAuthMethod" href="#httpx_oauth.oauth2.OAuth2ClientAuthMethod">OAuth2ClientAuthMethod</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The authentication method to be used in the revocation endpoint.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.NotSupportedAuthMethodError" href="#httpx_oauth.oauth2.NotSupportedAuthMethodError">NotSupportedAuthMethodError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The provided authentication method is not supported.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.MissingRevokeTokenAuthMethodError" href="#httpx_oauth.oauth2.MissingRevokeTokenAuthMethodError">MissingRevokeTokenAuthMethodError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The revocation endpoint auth method is missing.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h3 id="httpx_oauth.oauth2.BaseOAuth2.get_access_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_access_token</span><span class="p">(</span><span class="n">code</span><span class="p">,</span> <span class="n">redirect_uri</span><span class="p">,</span> <span class="n">code_verifier</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.oauth2.BaseOAuth2.get_access_token" class="headerlink" title="Permanent link">&para;</a></h3>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Requests an access token using the authorization code obtained
+after the user has authorized the application.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>code</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The authorization code.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>redirect_uri</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The URL where the user was redirected after authorization.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_verifier</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional code verifier used
+in the <a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> flow.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2Token" href="#httpx_oauth.oauth2.OAuth2Token">OAuth2Token</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An access token response dictionary.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.GetAccessTokenError" href="#httpx_oauth.oauth2.GetAccessTokenError">GetAccessTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while getting the access token.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">access_token</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">get_access_token</span><span class="p">(</span><span class="s2">&quot;CODE&quot;</span><span class="p">,</span> <span class="s2">&quot;https://www.tintagel.bt/oauth-callback&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h3 id="httpx_oauth.oauth2.BaseOAuth2.get_authorization_url" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_authorization_url</span><span class="p">(</span><span class="n">redirect_uri</span><span class="p">,</span> <span class="n">state</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">code_challenge</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">code_challenge_method</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">extras_params</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.oauth2.BaseOAuth2.get_authorization_url" class="headerlink" title="Permanent link">&para;</a></h3>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Builds the authorization URL
+where the user should be redirected to authorize the application.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>redirect_uri</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The URL where the user will be redirected after authorization.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>state</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An opaque value used by the client to maintain state</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>scope</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.List" href="https://docs.python.org/3.8/library/typing.html#typing.List">List</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The scopes to be requested.
+If not provided, <code>base_scopes</code> will be used.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_challenge</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional
+<a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> code challenge.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>code_challenge_method</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" title="typing.Literal" href="https://docs.python.org/3.8/library/typing.html#typing.Literal">Literal</a>[&#39;plain&#39;, &#39;S256&#39;]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional
+<a href="(https://datatracker.ietf.org/doc/html/rfc7636)">PKCE</a> code challenge
+method.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>extras_params</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<span title="httpx_oauth.oauth2.T">T</span>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional extra parameters specific to the service.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The authorization URL.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <p><code>py
+authorization_url = await client.get_authorization_url(
+    "https://www.tintagel.bt/oauth-callback", scope=["SCOPE1", "SCOPE2", "SCOPE3"],
+)</code>py</p>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h3 id="httpx_oauth.oauth2.BaseOAuth2.get_id_email" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_id_email</span><span class="p">(</span><span class="n">token</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.oauth2.BaseOAuth2.get_id_email" class="headerlink" title="Permanent link">&para;</a></h3>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Returns the id and the email (if available) of the authenticated user
+from the API provider.</p>
+<p><strong>It assumes you have asked for the required scopes</strong>.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The access token.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Tuple" href="https://docs.python.org/3.8/library/typing.html#typing.Tuple">Tuple</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>, <a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A tuple with the id and the email of the authenticated user.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.exceptions.GetIdEmailError" href="../httpx_oauth.exceptions/#httpx_oauth.exceptions.GetIdEmailError">GetIdEmailError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while getting the id and email.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">user_id</span><span class="p">,</span> <span class="n">user_email</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">get_id_email</span><span class="p">(</span><span class="s2">&quot;TOKEN&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h3 id="httpx_oauth.oauth2.BaseOAuth2.refresh_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">refresh_token</span><span class="p">(</span><span class="n">refresh_token</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.oauth2.BaseOAuth2.refresh_token" class="headerlink" title="Permanent link">&para;</a></h3>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Requests a new access token using a refresh token.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>refresh_token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The refresh token.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2Token" href="#httpx_oauth.oauth2.OAuth2Token">OAuth2Token</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An access token response dictionary.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RefreshTokenError" href="#httpx_oauth.oauth2.RefreshTokenError">RefreshTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while refreshing the token.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RefreshTokenNotSupportedError" href="#httpx_oauth.oauth2.RefreshTokenNotSupportedError">RefreshTokenNotSupportedError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The provider does not support token refresh.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">access_token</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">refresh_token</span><span class="p">(</span><span class="s2">&quot;REFRESH_TOKEN&quot;</span><span class="p">)</span>
+</code></pre></div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h3 id="httpx_oauth.oauth2.BaseOAuth2.revoke_token" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">revoke_token</span><span class="p">(</span><span class="n">token</span><span class="p">,</span> <span class="n">token_type_hint</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-async"><code>async</code></small>
+  </span>
+
+<a href="#httpx_oauth.oauth2.BaseOAuth2.revoke_token" class="headerlink" title="Permanent link">&para;</a></h3>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Revokes a token.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>token</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A token or refresh token to revoke.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>token_type_hint</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-external" title="typing.Optional" href="https://docs.python.org/3.8/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional hint for the service to help it determine
+if it's a token or refresh token.
+Usually either <code>token</code> or <code>refresh_token</code>.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code>None</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>None</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RevokeTokenError" href="#httpx_oauth.oauth2.RevokeTokenError">RevokeTokenError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>An error occurred while revoking the token.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.RevokeTokenNotSupportedError" href="#httpx_oauth.oauth2.RevokeTokenNotSupportedError">RevokeTokenNotSupportedError</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The provider does not support token revoke.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+    </div>
+
+</div>
+
+
+
+  </div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-class">
+
+
+
+<h2 id="httpx_oauth.oauth2.GetAccessTokenError" class="doc doc-heading">
+            <code>GetAccessTokenError</code>
+
+
+<a href="#httpx_oauth.oauth2.GetAccessTokenError" class="headerlink" title="Permanent link">&para;</a></h2>
+
+
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2RequestError" href="#httpx_oauth.oauth2.OAuth2RequestError">OAuth2RequestError</a></code></p>
+
+
+      <p>Error raised when an error occurs while getting an access token.</p>
+
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-class">
+
+
+
+<h2 id="httpx_oauth.oauth2.MissingRevokeTokenAuthMethodError" class="doc doc-heading">
+            <code>MissingRevokeTokenAuthMethodError</code>
+
+
+<a href="#httpx_oauth.oauth2.MissingRevokeTokenAuthMethodError" class="headerlink" title="Permanent link">&para;</a></h2>
+
+
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2Error" href="#httpx_oauth.oauth2.OAuth2Error">OAuth2Error</a></code></p>
+
+
+      <p>Error raised when the revocation endpoint auth method is missing.</p>
+
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+
+
+
+  </div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-class">
+
+
+
+<h2 id="httpx_oauth.oauth2.NotSupportedAuthMethodError" class="doc doc-heading">
+            <code>NotSupportedAuthMethodError</code>
+
+
+<a href="#httpx_oauth.oauth2.NotSupportedAuthMethodError" class="headerlink" title="Permanent link">&para;</a></h2>
+
+
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2Error" href="#httpx_oauth.oauth2.OAuth2Error">OAuth2Error</a></code></p>
+
+
+      <p>Error raised when an unsupported authentication method is used.</p>
+
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+
+
+
+  </div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-class">
+
+
+
+<h2 id="httpx_oauth.oauth2.OAuth2Error" class="doc doc-heading">
+            <code>OAuth2Error</code>
+
+
+<a href="#httpx_oauth.oauth2.OAuth2Error" class="headerlink" title="Permanent link">&para;</a></h2>
+
+
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="httpx_oauth.exceptions.HTTPXOAuthError" href="../httpx_oauth.exceptions/#httpx_oauth.exceptions.HTTPXOAuthError">HTTPXOAuthError</a></code></p>
+
+
+      <p>Base exception class for OAuth2 client errors.</p>
+
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-class">
+
+
+
+<h2 id="httpx_oauth.oauth2.OAuth2RequestError" class="doc doc-heading">
+            <code>OAuth2RequestError</code>
+
+
+<a href="#httpx_oauth.oauth2.OAuth2RequestError" class="headerlink" title="Permanent link">&para;</a></h2>
+
+
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2Error" href="#httpx_oauth.oauth2.OAuth2Error">OAuth2Error</a></code></p>
+
+
+      <p>Base exception class for OAuth2 request errors.</p>
+
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+
+
+
+  </div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-class">
+
+
+
+<h2 id="httpx_oauth.oauth2.OAuth2Token" class="doc doc-heading">
+            <code>OAuth2Token</code>
+
+
+<a href="#httpx_oauth.oauth2.OAuth2Token" class="headerlink" title="Permanent link">&para;</a></h2>
+
+
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-external" title="typing.Dict" href="https://docs.python.org/3.8/library/typing.html#typing.Dict">Dict</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/stdtypes.html#str">str</a>, <a class="autorefs autorefs-external" title="typing.Any" href="https://docs.python.org/3.8/library/typing.html#typing.Any">Any</a>]</code></p>
+
+
+      <p>Wrapper around a standard <code>Dict[str, Any]</code> that bears the response
+of a successful token request.</p>
+<p>Properties can vary greatly from a service to another but, usually,
+you can get access token like this:</p>
+
+
+<p><span class="doc-section-title">Examples:</span></p>
+    <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">access_token</span> <span class="o">=</span> <span class="n">token</span><span class="p">[</span><span class="s2">&quot;access_token&quot;</span><span class="p">]</span>
+</code></pre></div>
+
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+
+<div class="doc doc-object doc-function">
+
+
+<h3 id="httpx_oauth.oauth2.OAuth2Token.is_expired" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">is_expired</span><span class="p">()</span></code>
+
+<a href="#httpx_oauth.oauth2.OAuth2Token.is_expired" class="headerlink" title="Permanent link">&para;</a></h3>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Checks if the token is expired.</p>
+
+
+    <p><span class="doc-section-title">Returns:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><a class="autorefs autorefs-external" href="https://docs.python.org/3.8/library/functions.html#bool">bool</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>True if the token is expired, False otherwise</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+    </div>
+
+</div>
+
+
+
+  </div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-class">
+
+
+
+<h2 id="httpx_oauth.oauth2.RefreshTokenError" class="doc doc-heading">
+            <code>RefreshTokenError</code>
+
+
+<a href="#httpx_oauth.oauth2.RefreshTokenError" class="headerlink" title="Permanent link">&para;</a></h2>
+
+
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2RequestError" href="#httpx_oauth.oauth2.OAuth2RequestError">OAuth2RequestError</a></code></p>
+
+
+      <p>Error raised when an error occurs while refreshing a token.</p>
+
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-class">
+
+
+
+<h2 id="httpx_oauth.oauth2.RefreshTokenNotSupportedError" class="doc doc-heading">
+            <code>RefreshTokenNotSupportedError</code>
+
+
+<a href="#httpx_oauth.oauth2.RefreshTokenNotSupportedError" class="headerlink" title="Permanent link">&para;</a></h2>
+
+
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2Error" href="#httpx_oauth.oauth2.OAuth2Error">OAuth2Error</a></code></p>
+
+
+      <p>Error raised when trying to refresh a token
+on a provider that does not support it.</p>
+
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+
+
+
+  </div>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-class">
+
+
+
+<h2 id="httpx_oauth.oauth2.RevokeTokenError" class="doc doc-heading">
+            <code>RevokeTokenError</code>
+
+
+<a href="#httpx_oauth.oauth2.RevokeTokenError" class="headerlink" title="Permanent link">&para;</a></h2>
+
+
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2RequestError" href="#httpx_oauth.oauth2.OAuth2RequestError">OAuth2RequestError</a></code></p>
+
+
+      <p>Error raised when an error occurs while revoking a token.</p>
+
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-class">
+
+
+
+<h2 id="httpx_oauth.oauth2.RevokeTokenNotSupportedError" class="doc doc-heading">
+            <code>RevokeTokenNotSupportedError</code>
+
+
+<a href="#httpx_oauth.oauth2.RevokeTokenNotSupportedError" class="headerlink" title="Permanent link">&para;</a></h2>
+
+
+    <div class="doc doc-contents ">
+            <p class="doc doc-class-bases">
+              Bases: <code><a class="autorefs autorefs-internal" title="httpx_oauth.oauth2.OAuth2Error" href="#httpx_oauth.oauth2.OAuth2Error">OAuth2Error</a></code></p>
+
+
+      <p>Error raised when trying to revole a token
+on a provider that does not support it.</p>
+
+
+
+
+  <div class="doc doc-children">
+
+
+
+
+
+
+
+
+
+
+
+  </div>
+
+    </div>
+
+</div>
+
+
+
+
+  </div>
+
+    </div>
+
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+                
+              </article>
+            </div>
+          
+          
+<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
+        </div>
+        
+      </main>
+      
+        <footer class="md-footer">
+  
+  <div class="md-footer-meta md-typeset">
+    <div class="md-footer-meta__inner md-grid">
+      <div class="md-copyright">
+  
+  
+    Made with
+    <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
+      Material for MkDocs
+    </a>
+  
+</div>
+      
+    </div>
+  </div>
+</footer>
+      
+    </div>
+    <div class="md-dialog" data-md-component="dialog">
+      <div class="md-dialog__inner md-typeset"></div>
+    </div>
+    
+    
+    <script id="__config" type="application/json">{"base": "../..", "features": ["content.code.copy"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
+    
+    
+      <script src="../../assets/javascripts/bundle.fe8b6f2b.min.js"></script>
+      
+    
+  </body>
+</html>
\ No newline at end of file
diff --git a/search/search_index.json b/search/search_index.json
index 24ccffa..fc4a165 100644
--- a/search/search_index.json
+++ b/search/search_index.json
@@ -1 +1 @@
-{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"HTTPX OAuth","text":"<p> Async OAuth client using HTTPX </p> <p> </p> <p></p> <p> </p> <p>Documentation: https://frankie567.github.io/httpx-oauth/</p> <p>Source Code: https://github.com/frankie567/httpx-oauth</p>"},{"location":"#installation","title":"Installation","text":"<pre><code>pip install httpx-oauth\n</code></pre>"},{"location":"#contributors","title":"Contributors \u2728","text":"<p>Thanks goes to these wonderful people (emoji key):</p> <sub>Fran\u00e7ois Voron</sub>\ud83d\udea7 <sub>Xavi Torell\u00f3</sub>\ud83d\udcbb <sub>dbf</sub>\ud83d\udcbb <sub>Kenton Parton</sub>\ud83d\udcbb <sub>stepan-chatalyan</sub>\ud83d\udcbb <sub>Foster Snowhill</sub>\ud83d\udcbb <sub>William Hatcher</sub>\ud83d\udcbb <sub>Matt Chan</sub>\ud83d\udce6 <sub>Goran Meki\u0107</sub>\ud83d\udce6 <sub>Joona Yoon</sub>\ud83d\udcbb <sub>LindezaGrey</sub>\ud83d\udcbb <sub>R. Singh</sub>\ud83d\udc1b <sub>Lukas L\u00f6sche</sub>\ud83d\udc1b \ud83d\udcbb <sub>James King</sub>\ud83d\udcbb <p>This project follows the all-contributors specification. Contributions of any kind welcome!</p>"},{"location":"#development","title":"Development","text":""},{"location":"#setup-environment","title":"Setup environment","text":"<p>We use Hatch to manage the development environment and production build. Ensure it's installed on your system.</p>"},{"location":"#run-unit-tests","title":"Run unit tests","text":"<p>You can run all the tests with:</p> <pre><code>hatch run test\n</code></pre>"},{"location":"#format-the-code","title":"Format the code","text":"<p>Execute the following command to apply <code>isort</code> and <code>black</code> formatting:</p> <pre><code>hatch run lint\n</code></pre>"},{"location":"#serve-the-documentation","title":"Serve the documentation","text":"<p>You can serve the documentation locally with the following command:</p> <pre><code>hatch run docs\n</code></pre> <p>The documentation will be available on http://localhost:8000.</p>"},{"location":"#license","title":"License","text":"<p>This project is licensed under the terms of the MIT license.</p>"},{"location":"fastapi/","title":"FastAPI","text":"<p>Utilities are provided to ease the integration of an OAuth2 process in FastAPI.</p>"},{"location":"fastapi/#oauth2authorizecallback","title":"<code>OAuth2AuthorizeCallback</code>","text":"<p>Dependency callable to handle the authorization callback. It reads the query parameters and returns the access token and the state.</p> <p>Parameters</p> <ul> <li><code>client: OAuth2</code>: The OAuth2 client.</li> <li><code>route_name: Optional[str]</code>: Name of the callback route, as defined in the <code>name</code> parameter of the route decorator.</li> <li><code>redirect_url: Optional[str]</code>: Full URL to the callback route.</li> </ul> <p>Tip</p> <p>You should either set <code>route_name</code>, which will automatically reverse the URL, or <code>redirect_url</code>, which is an arbitrary URL you set.</p> <pre><code>from fastapi import FastAPI, Depends\nfrom httpx_oauth.integrations.fastapi import OAuth2AuthorizeCallback\nfrom httpx_oauth.oauth2 import OAuth2\n\nclient = OAuth2(\"CLIENT_ID\", \"CLIENT_SECRET\", \"AUTHORIZE_ENDPOINT\", \"ACCESS_TOKEN_ENDPOINT\")\noauth2_authorize_callback = OAuth2AuthorizeCallback(client, \"oauth-callback\")\napp = FastAPI()\n\n@app.get(\"/oauth-callback\", name=\"oauth-callback\")\nasync def oauth_callback(access_token_state=Depends(oauth2_authorize_callback)):\n    token, state = access_token_state\n    # Do something useful\n</code></pre>"},{"location":"oauth2/","title":"OAuth2","text":""},{"location":"oauth2/#generic-client","title":"Generic client","text":"<p>A generic OAuth2 class is provided to adapt to any OAuth2-compliant service. You can instantiate it like this:</p> <pre><code>from httpx_oauth.oauth2 import OAuth2\n\nclient = OAuth2(\n    \"CLIENT_ID\",\n    \"CLIENT_SECRET\",\n    \"AUTHORIZE_ENDPOINT\",\n    \"ACCESS_TOKEN_ENDPOINT\",\n    refresh_token_endpoint=\"REFRESH_TOKEN_ENDPOINT\",\n    revoke_token_endpoint=\"REVOKE_TOKEN_ENDPOINT\",\n)\n</code></pre> <p>Note that <code>refresh_token_endpoint</code> and <code>revoke_token_endpoint</code> are optional since not every services propose to refresh and revoke tokens.</p>"},{"location":"oauth2/#available-methods","title":"Available methods","text":""},{"location":"oauth2/#get_authorization_url","title":"<code>get_authorization_url</code>","text":"<p>Returns the authorization URL where you should redirect the user to ask for their approval.</p> <p>Parameters</p> <ul> <li><code>redirect_uri: str</code>: Your callback URI where the user will be redirected after the service prompt.</li> <li><code>state: str = None</code>: Optional string that will be returned back in the callback parameters to allow you to retrieve state information.</li> <li><code>scope: Optional[List[str]] = None</code>: Optional list of scopes to ask for.</li> <li><code>code_challenge: Optional[str] = None</code>: Optional code_challenge in a PKCE context.</li> <li><code>code_challenge_method: Optional[Literal[\"plain\", \"S256\"]] = None</code>: Optional code_challenge_method in a PKCE context.</li> <li><code>extras_params: Optional[Dict[str, Any]] = None</code>: Optional dictionary containing parameters specific to the service.</li> </ul> <p>Example</p> <pre><code>authorization_url = await client.get_authorization_url(\n    \"https://www.tintagel.bt/oauth-callback\", scope=[\"SCOPE1\", \"SCOPE2\", \"SCOPE3\"],\n)\n</code></pre>"},{"location":"oauth2/#get_access_token","title":"<code>get_access_token</code>","text":"<p>Returns an <code>OAuth2Token</code> object for the service given the authorization code passed in the redirection callback.</p> <p>Raises a <code>GetAccessTokenError</code> if an error occurs.</p> <p>Parameters</p> <ul> <li><code>code: str</code>: The authorization code passed in the redirection callback.</li> <li><code>redirect_uri: str</code>: The exact same <code>redirect_uri</code> you passed to the authorization URL.</li> <li><code>code_verifier: Optional[str]</code>: Optional code verifier in a PKCE context.</li> </ul> <p>Example</p> <pre><code>access_token = await client.get_access_token(\"CODE\", \"https://www.tintagel.bt/oauth-callback\")\n</code></pre>"},{"location":"oauth2/#refresh_token","title":"<code>refresh_token</code>","text":"<p>Returns a fresh <code>OAuth2Token</code> object for the service given a refresh token.</p> <p>Raises a <code>RefreshTokenNotSupportedError</code> if no <code>refresh_token_endpoint</code> was provided.</p> <p>Parameters</p> <ul> <li><code>refresh_token: str</code>: A valid refresh token for the service.</li> </ul> <p>Example</p> <pre><code>access_token = await client.refresh_token(\"REFRESH_TOKEN\")\n</code></pre>"},{"location":"oauth2/#revoke_token","title":"<code>revoke_token</code>","text":"<p>Revokes a token.</p> <p>Raises a <code>RevokeTokenNotSupportedError</code> if no <code>revoke_token_endpoint</code> was provided.</p> <p>Parameters</p> <ul> <li><code>token: str</code>: A token or refresh token to revoke.</li> <li><code>token_type_hint: str = None</code>: Optional hint for the service to help it determine if it's a token or refresh token. Usually either <code>token</code> or <code>refresh_token</code>.</li> </ul> <p>Example</p> <pre><code>await client.revoke_token(\"TOKEN\")\n</code></pre>"},{"location":"oauth2/#get_id_email","title":"<code>get_id_email</code>","text":"<p>Returns the id and the email (if available) of the authenticated user from the API provider. It assumes you have asked for the required scopes.</p> <p>Raises a <code>GetIdEmailError</code> if an error occurs.</p> <p>Parameters</p> <ul> <li><code>token: str</code>: A valid access token.</li> </ul> <p>Example</p> <pre><code>user_id, user_email = await client.get_id_email(\"TOKEN\")\n</code></pre>"},{"location":"oauth2/#oauth2token-class","title":"<code>OAuth2Token</code> class","text":"<p>This class is a wrapper around a standard <code>Dict[str, Any]</code> that bears the response of <code>get_access_token</code>. Properties can vary greatly from a service to another but, usually, you can get access token like this:</p> <pre><code>access_token = token[\"access_token\"]\n</code></pre>"},{"location":"oauth2/#is_expired","title":"<code>is_expired</code>","text":"<p>A utility method is provided to quickly determine if the token is still valid or needs to be refreshed.</p> <p>Example</p> <pre><code>if token.is_expired():\n    token = await client.refresh_token(token[\"refresh_token\"])\n    # Save token to DB\n\naccess_token = token[\"access_token\"]\n# Do something useful with this access token\n</code></pre>"},{"location":"oauth2/#provided-clients","title":"Provided clients","text":"<p>We provide several ready-to-use clients for widely used services with configured endpoints and specificites took into account.</p>"},{"location":"oauth2/#openid","title":"OpenID","text":"<p>Generic client for providers following the OpenID Connect protocol. Besides the Client ID and the Client Secret, you'll have to provide the OpenID configuration endpoint, allowing the client to discover the required endpoints automatically. By convention, it's usually served under the path <code>.well-known/openid-configuration</code>.</p> <pre><code>from httpx_oauth.clients.openid import OpenID\n\nclient = OpenID(\"CLIENT_ID\", \"CLIENT_SECRET\", \"https://example.fief.dev/.well-known/openid-configuration\")\n</code></pre> <ul> <li>\u2753 <code>refresh_token</code>: depends if the OpenID provider supports it</li> <li>\u2753 <code>revoke_token</code>: depends if the OpenID provider supports it</li> </ul>"},{"location":"oauth2/#discord","title":"Discord","text":"<pre><code>from httpx_oauth.clients.discord import DiscordOAuth2\n\nclient = DiscordOAuth2(\"CLIENT_ID\", \"CLIENT_SECRET\")\n</code></pre> <ul> <li>\u2705 <code>refresh_token</code></li> <li>\u2705 <code>revoke_token</code></li> </ul> <p>Warning about <code>get_id_email</code></p> <p>Email is optional for Discord accounts, so the email might be <code>None</code>.</p>"},{"location":"oauth2/#facebook","title":"Facebook","text":"<pre><code>from httpx_oauth.clients.facebook import FacebookOAuth2\n\nclient = FacebookOAuth2(\"CLIENT_ID\", \"CLIENT_SECRET\")\n</code></pre> <ul> <li>\u274c <code>refresh_token</code></li> <li>\u274c <code>revoke_token</code></li> </ul>"},{"location":"oauth2/#get_long_lived_access_token","title":"<code>get_long_lived_access_token</code>","text":"<p>Returns an <code>OAuth2Token</code> object with a long-lived access token given a short-lived access token.</p> <p>Raises a <code>GetLongLivedAccessTokenError</code> if an error occurs.</p> <p>Parameters</p> <ul> <li><code>token: str</code>: A short-lived access token given by <code>get_access_token</code>.</li> </ul> <p>Example</p> <pre><code>long_lived_access_token = await client.get_long_lived_access_token(\"TOKEN\")\n</code></pre>"},{"location":"oauth2/#github","title":"GitHub","text":"<pre><code>from httpx_oauth.clients.github import GitHubOAuth2\n\nclient = GitHubOAuth2(\"CLIENT_ID\", \"CLIENT_SECRET\")\n</code></pre> <ul> <li>\u2705 <code>refresh_token</code></li> <li>\u274c <code>revoke_token</code></li> </ul> <p>Tip</p> <p>You should enable Email addresses permission in the Permissions &amp; events section of your GitHub app parameters. You can find it at https://github.com/settings/apps/{YOUR_APP}/permissions.</p> <p>Refresh tokens are not enabled by default</p> <p>Refresh tokens are currently an optional feature you need to enable in your GitHub app parameters. Read more.</p>"},{"location":"oauth2/#google","title":"Google","text":"<pre><code>from httpx_oauth.clients.google import GoogleOAuth2\n\nclient = GoogleOAuth2(\"CLIENT_ID\", \"CLIENT_SECRET\")\n</code></pre> <ul> <li>\u2705 <code>refresh_token</code></li> <li>\u2705 <code>revoke_token</code></li> </ul>"},{"location":"oauth2/#kakao","title":"Kakao","text":"<pre><code>from httpx_oauth.clients.kakao import KakaoOAuth2\n\nclient = KakaoOAuth2(\"CLIENT_ID\", \"CLIENT_SECRET\")\n</code></pre> <ul> <li>\u2705 <code>refresh_token</code></li> <li>\u2705 <code>revoke_token</code></li> </ul>"},{"location":"oauth2/#linkedin","title":"LinkedIn","text":"<pre><code>from httpx_oauth.clients.linkedin import LinkedInOAuth2\n\nclient = LinkedInOAuth2(\"CLIENT_ID\", \"CLIENT_SECRET\")\n</code></pre> <ul> <li>\u2705 <code>refresh_token</code> (only for selected partners)</li> <li>\u274c <code>revoke_token</code></li> </ul>"},{"location":"oauth2/#naver","title":"NAVER","text":"<pre><code>from httpx_oauth.clients.naver import NaverOAuth2\n\nclient = NaverOAuth2(\"CLIENT_ID\", \"CLIENT_SECRET\")\n</code></pre> <ul> <li>\u2705 <code>refresh_token</code></li> <li>\u2705 <code>revoke_token</code></li> </ul>"},{"location":"oauth2/#okta","title":"Okta","text":"<p>Based on the OpenID client. You need to provide the domain of your Okta domain for automatically discovering the required endpoints.</p> <pre><code>from httpx_oauth.clients.okta import OktaOAuth2\n\nclient = OktaOAuth2(\"CLIENT_ID\", \"CLIENT_SECRET\", \"example.okta.com\")\n</code></pre> <ul> <li>\u2705 <code>refresh_token</code></li> <li>\u2705 <code>revoke_token</code></li> </ul>"},{"location":"oauth2/#reddit","title":"Reddit","text":"<pre><code>from httpx_oauth.clients.reddit import RedditOAuth2\n\nclient = RedditOAuth2(\"CLIENT_ID\", \"CLIENT_SECRET\")\n</code></pre> <ul> <li>\u2705 <code>refresh_token</code></li> <li>\u2705 <code>revoke_token</code></li> </ul> <p>Warning about <code>get_id_email</code></p> <p>Reddit API never return email addresses. Thus, e-mail will always be <code>None</code>.</p>"},{"location":"oauth2/#franceconnect","title":"FranceConnect","text":"<pre><code>from httpx_oauth.clients.franceconnect import FranceConnectOAuth2\n\nclient = FranceConnectOAuth2(\"CLIENT_ID\", \"CLIENT_SECRET\")\n</code></pre> <ul> <li>\u274c <code>refresh_token</code></li> <li>\u274c <code>revoke_token</code></li> </ul> <p>Integration server</p> <p>Since you need to go through a heavy validation process before getting your client ID and secret, you can use during development the integration server with demo credentials. You can enable this mode by setting the <code>integration</code> flag to <code>True</code>.</p> <pre><code>from httpx_oauth.clients.franceconnect import FranceConnectOAuth2\n\nclient = FranceConnectOAuth2(\"CLIENT_ID\", \"CLIENT_SECRET\", integration=True)\n</code></pre>"},{"location":"oauth2/#shopify","title":"Shopify","text":"<p>The OAuth2 client for Shopify allows you to authenticate shop owners so your app can make calls to the Shopify Admin API. Besides the Client ID and Secret, you'll need the shop subdomain of the shop you need to access.</p> <pre><code>from httpx_oauth.clients.shopify import ShopifyOAuth2\n\nclient = ShopifyOAuth2(\"CLIENT_ID\", \"CLIENT_SECRET\", \"my-shop\")\n</code></pre> <ul> <li>\u274c <code>refresh_token</code></li> <li>\u274c <code>revoke_token</code></li> </ul> <p><code>get_id_email</code> is based on the <code>Shop</code> resource</p> <p>The implementation of <code>get_id_email</code> calls the Get Shop endpoint of the Shopify Admin API. It means that it'll return you the ID of the shop and the email of the shop owner.</p>"},{"location":"oauth2/#customize-httpx-client","title":"Customize HTTPX client","text":"<p>By default, requests are made using <code>httpx.AsyncClient</code> with default parameters. If you wish to customize settings, like setting timeout or proxies, you can do this by overloading the <code>get_httpx_client</code> method.</p> <pre><code>from typing import AsyncContextManager\n\nimport httpx\nfrom httpx_oauth.oauth2 import OAuth2\n\n\nclass OAuth2CustomTimeout(OAuth2):\n    def get_httpx_client(self) -&gt; AsyncContextManager[httpx.AsyncClient]:\n        return httpx.AsyncClient(timeout=10.0)  # Use a default 10s timeout everywhere.\n\n\nclient = OAuth2CustomTimeout(\n    \"CLIENT_ID\",\n    \"CLIENT_SECRET\",\n    \"AUTHORIZE_ENDPOINT\",\n    \"ACCESS_TOKEN_ENDPOINT\",\n    refresh_token_endpoint=\"REFRESH_TOKEN_ENDPOINT\",\n    revoke_token_endpoint=\"REVOKE_TOKEN_ENDPOINT\",\n)\n</code></pre>"}]}
\ No newline at end of file
+{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"HTTPX OAuth","text":"<p> Async OAuth client using HTTPX </p> <p> </p> <p></p> <p> </p> <p>Documentation: https://frankie567.github.io/httpx-oauth/</p> <p>Source Code: https://github.com/frankie567/httpx-oauth</p>"},{"location":"#installation","title":"Installation","text":"<pre><code>pip install httpx-oauth\n</code></pre>"},{"location":"#contributors","title":"Contributors \u2728","text":"<p>Thanks goes to these wonderful people (emoji key):</p> <sub>Fran\u00e7ois Voron</sub>\ud83d\udea7 <sub>Xavi Torell\u00f3</sub>\ud83d\udcbb <sub>dbf</sub>\ud83d\udcbb <sub>Kenton Parton</sub>\ud83d\udcbb <sub>stepan-chatalyan</sub>\ud83d\udcbb <sub>Foster Snowhill</sub>\ud83d\udcbb <sub>William Hatcher</sub>\ud83d\udcbb <sub>Matt Chan</sub>\ud83d\udce6 <sub>Goran Meki\u0107</sub>\ud83d\udce6 <sub>Joona Yoon</sub>\ud83d\udcbb <sub>LindezaGrey</sub>\ud83d\udcbb <sub>R. Singh</sub>\ud83d\udc1b <sub>Lukas L\u00f6sche</sub>\ud83d\udc1b \ud83d\udcbb <sub>James King</sub>\ud83d\udcbb <p>This project follows the all-contributors specification. Contributions of any kind welcome!</p>"},{"location":"#development","title":"Development","text":""},{"location":"#setup-environment","title":"Setup environment","text":"<p>We use Hatch to manage the development environment and production build. Ensure it's installed on your system.</p>"},{"location":"#run-unit-tests","title":"Run unit tests","text":"<p>You can run all the tests with:</p> <pre><code>hatch run test\n</code></pre>"},{"location":"#format-the-code","title":"Format the code","text":"<p>Execute the following command to apply <code>isort</code> and <code>black</code> formatting:</p> <pre><code>hatch run lint\n</code></pre>"},{"location":"#serve-the-documentation","title":"Serve the documentation","text":"<p>You can serve the documentation locally with the following command:</p> <pre><code>hatch run docs\n</code></pre> <p>The documentation will be available on http://localhost:8000.</p>"},{"location":"#license","title":"License","text":"<p>This project is licensed under the terms of the MIT license.</p>"},{"location":"fastapi/","title":"FastAPI","text":"<p>Utilities are provided to ease the integration of an OAuth2 process in FastAPI.</p>"},{"location":"fastapi/#oauth2authorizecallback","title":"<code>OAuth2AuthorizeCallback</code>","text":"<p>Dependency callable to handle the authorization callback. It reads the query parameters and returns the access token and the state.</p> <p>Parameters</p> <ul> <li><code>client: OAuth2</code>: The OAuth2 client.</li> <li><code>route_name: Optional[str]</code>: Name of the callback route, as defined in the <code>name</code> parameter of the route decorator.</li> <li><code>redirect_url: Optional[str]</code>: Full URL to the callback route.</li> </ul> <p>Tip</p> <p>You should either set <code>route_name</code>, which will automatically reverse the URL, or <code>redirect_url</code>, which is an arbitrary URL you set.</p> <pre><code>from fastapi import FastAPI, Depends\nfrom httpx_oauth.integrations.fastapi import OAuth2AuthorizeCallback\nfrom httpx_oauth.oauth2 import OAuth2\n\nclient = OAuth2(\"CLIENT_ID\", \"CLIENT_SECRET\", \"AUTHORIZE_ENDPOINT\", \"ACCESS_TOKEN_ENDPOINT\")\noauth2_authorize_callback = OAuth2AuthorizeCallback(client, \"oauth-callback\")\napp = FastAPI()\n\n@app.get(\"/oauth-callback\", name=\"oauth-callback\")\nasync def oauth_callback(access_token_state=Depends(oauth2_authorize_callback)):\n    token, state = access_token_state\n    # Do something useful\n</code></pre>"},{"location":"usage/","title":"Usage","text":""},{"location":"usage/#create-a-client","title":"Create a client","text":"<p>A generic OAuth2 class is provided to adapt to any OAuth2-compliant service. You can instantiate it like this:</p> <pre><code>from httpx_oauth.oauth2 import OAuth2\n\nclient = OAuth2(\n    \"CLIENT_ID\",\n    \"CLIENT_SECRET\",\n    \"AUTHORIZE_ENDPOINT\",\n    \"ACCESS_TOKEN_ENDPOINT\",\n    refresh_token_endpoint=\"REFRESH_TOKEN_ENDPOINT\",\n    revoke_token_endpoint=\"REVOKE_TOKEN_ENDPOINT\",\n)\n</code></pre> <p>Note that <code>refresh_token_endpoint</code> and <code>revoke_token_endpoint</code> are optional since not every services propose to refresh and revoke tokens.</p>"},{"location":"usage/#generate-an-authorization-url","title":"Generate an authorization URL","text":"<p>Use the get_authorization_url method to generate the authorization URL where you should redirect the user to ask for their approval.</p> <pre><code>authorization_url = await client.get_authorization_url(\n    \"https://www.tintagel.bt/oauth-callback\", scope=[\"SCOPE1\", \"SCOPE2\", \"SCOPE3\"],\n)\n</code></pre>"},{"location":"usage/#request-an-access-token","title":"Request an access token","text":"<p>Once you have the authorization code, use the get_access_token method to exchange it with a valid access token.</p> <p>It returns an OAuth2Token dictionary-like object.</p> <pre><code>access_token = await client.get_access_token(\"CODE\", \"https://www.tintagel.bt/oauth-callback\")\n</code></pre>"},{"location":"usage/#refresh-an-access-token","title":"Refresh an access token","text":"<p>For providers supporting it, you can ask for a fresh access token given a refresh token. For this, use the refresh_token method.</p> <p>It returns an OAuth2Token dictionary-like object.</p> <pre><code>access_token = await client.refresh_token(\"REFRESH_TOKEN\")\n</code></pre>"},{"location":"usage/#revoke-an-access-or-refresh-token","title":"Revoke an access or refresh token","text":"<p>For providers supporting it, you can ask to revoke an access or refresh token. For this, use the revoke_token method.</p>"},{"location":"usage/#get-authenticated-user-id-and-email","title":"Get authenticated user ID and email","text":"<p>For convenience, we provide a method that'll use a valid access token to query the provider API and get the ID and the email (if available) of the authenticated user. For this, use the get_id_email method.</p> <p>This method is implemented specifically on each provider.</p>"},{"location":"usage/#provided-clients","title":"Provided clients","text":"<p>Out-of-the box, we support lot of popular providers like Google or Facebook, for which we provided dedicated classes with pre-configured endpoints.</p> <p>Clients reference</p>"},{"location":"usage/#customize-httpx-client","title":"Customize HTTPX client","text":"<p>By default, requests are made using <code>httpx.AsyncClient</code> with default parameters. If you wish to customize settings, like setting timeout or proxies, you can do this by overloading the <code>get_httpx_client</code> method.</p> <pre><code>from typing import AsyncContextManager\n\nimport httpx\nfrom httpx_oauth.oauth2 import OAuth2\n\n\nclass OAuth2CustomTimeout(OAuth2):\n    def get_httpx_client(self) -&gt; AsyncContextManager[httpx.AsyncClient]:\n        return httpx.AsyncClient(timeout=10.0)  # Use a default 10s timeout everywhere.\n\n\nclient = OAuth2CustomTimeout(\n    \"CLIENT_ID\",\n    \"CLIENT_SECRET\",\n    \"AUTHORIZE_ENDPOINT\",\n    \"ACCESS_TOKEN_ENDPOINT\",\n    refresh_token_endpoint=\"REFRESH_TOKEN_ENDPOINT\",\n    revoke_token_endpoint=\"REVOKE_TOKEN_ENDPOINT\",\n)\n</code></pre>"},{"location":"reference/httpx_oauth.clients/","title":"Reference - Clients","text":""},{"location":"reference/httpx_oauth.clients/#discord","title":"Discord","text":""},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.discord.DiscordOAuth2","title":"<code>DiscordOAuth2</code>","text":"<p>               Bases: <code>BaseOAuth2[Dict[str, Any]]</code></p> <p>OAuth2 client for Discord.</p>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.discord.DiscordOAuth2.__init__","title":"<code>__init__(client_id, client_secret, scopes=BASE_SCOPES, name='discord')</code>","text":"<p>Parameters:</p> Name Type Description Default <code>client_id</code> <code>str</code> <p>The client ID provided by the OAuth2 provider.</p> required <code>client_secret</code> <code>str</code> <p>The client secret provided by the OAuth2 provider.</p> required <code>scopes</code> <code>Optional[List[str]]</code> <p>The default scopes to be used in the authorization URL.</p> <code>BASE_SCOPES</code> <code>name</code> <code>str</code> <p>A unique name for the OAuth2 client.</p> <code>'discord'</code>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.discord.DiscordOAuth2.get_access_token","title":"<code>get_access_token(code, redirect_uri, code_verifier=None)</code>  <code>async</code>","text":"<p>Requests an access token using the authorization code obtained after the user has authorized the application.</p> <p>Parameters:</p> Name Type Description Default <code>code</code> <code>str</code> <p>The authorization code.</p> required <code>redirect_uri</code> <code>str</code> <p>The URL where the user was redirected after authorization.</p> required <code>code_verifier</code> <code>Optional[str]</code> <p>Optional code verifier used in the PKCE flow.</p> <code>None</code> <p>Returns:</p> Type Description <code>OAuth2Token</code> <p>An access token response dictionary.</p> <p>Raises:</p> Type Description <code>GetAccessTokenError</code> <p>An error occurred while getting the access token.</p> <p>Examples:</p> <pre><code>access_token = await client.get_access_token(\"CODE\", \"https://www.tintagel.bt/oauth-callback\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.discord.DiscordOAuth2.get_authorization_url","title":"<code>get_authorization_url(redirect_uri, state=None, scope=None, code_challenge=None, code_challenge_method=None, extras_params=None)</code>  <code>async</code>","text":"<p>Builds the authorization URL where the user should be redirected to authorize the application.</p> <p>Parameters:</p> Name Type Description Default <code>redirect_uri</code> <code>str</code> <p>The URL where the user will be redirected after authorization.</p> required <code>state</code> <code>Optional[str]</code> <p>An opaque value used by the client to maintain state</p> <code>None</code> <code>scope</code> <code>Optional[List[str]]</code> <p>The scopes to be requested. If not provided, <code>base_scopes</code> will be used.</p> <code>None</code> <code>code_challenge</code> <code>Optional[str]</code> <p>Optional PKCE code challenge.</p> <code>None</code> <code>code_challenge_method</code> <code>Optional[Literal['plain', 'S256']]</code> <p>Optional PKCE code challenge method.</p> <code>None</code> <code>extras_params</code> <code>Optional[T]</code> <p>Optional extra parameters specific to the service.</p> <code>None</code> <p>Returns:</p> Type Description <code>str</code> <p>The authorization URL.</p> <p>Examples:</p> <p><code>py authorization_url = await client.get_authorization_url(     \"https://www.tintagel.bt/oauth-callback\", scope=[\"SCOPE1\", \"SCOPE2\", \"SCOPE3\"], )</code>py</p>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.discord.DiscordOAuth2.get_id_email","title":"<code>get_id_email(token)</code>  <code>async</code>","text":"<p>Returns the id and the email (if available) of the authenticated user from the API provider.</p> <p>It assumes you have asked for the required scopes.</p> <p>Parameters:</p> Name Type Description Default <code>token</code> <code>str</code> <p>The access token.</p> required <p>Returns:</p> Type Description <code>Tuple[str, Optional[str]]</code> <p>A tuple with the id and the email of the authenticated user.</p> <p>Raises:</p> Type Description <code>GetIdEmailError</code> <p>An error occurred while getting the id and email.</p> <p>Examples:</p> <pre><code>user_id, user_email = await client.get_id_email(\"TOKEN\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.discord.DiscordOAuth2.refresh_token","title":"<code>refresh_token(refresh_token)</code>  <code>async</code>","text":"<p>Requests a new access token using a refresh token.</p> <p>Parameters:</p> Name Type Description Default <code>refresh_token</code> <code>str</code> <p>The refresh token.</p> required <p>Returns:</p> Type Description <code>OAuth2Token</code> <p>An access token response dictionary.</p> <p>Raises:</p> Type Description <code>RefreshTokenError</code> <p>An error occurred while refreshing the token.</p> <code>RefreshTokenNotSupportedError</code> <p>The provider does not support token refresh.</p> <p>Examples:</p> <pre><code>access_token = await client.refresh_token(\"REFRESH_TOKEN\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.discord.DiscordOAuth2.revoke_token","title":"<code>revoke_token(token, token_type_hint=None)</code>  <code>async</code>","text":"<p>Revokes a token.</p> <p>Parameters:</p> Name Type Description Default <code>token</code> <code>str</code> <p>A token or refresh token to revoke.</p> required <code>token_type_hint</code> <code>Optional[str]</code> <p>Optional hint for the service to help it determine if it's a token or refresh token. Usually either <code>token</code> or <code>refresh_token</code>.</p> <code>None</code> <p>Returns:</p> Type Description <code>None</code> <p>None</p> <p>Raises:</p> Type Description <code>RevokeTokenError</code> <p>An error occurred while revoking the token.</p> <code>RevokeTokenNotSupportedError</code> <p>The provider does not support token revoke.</p>"},{"location":"reference/httpx_oauth.clients/#facebook","title":"Facebook","text":""},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.facebook","title":"<code>httpx_oauth.clients.facebook</code>","text":""},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.facebook.FacebookOAuth2","title":"<code>FacebookOAuth2</code>","text":"<p>               Bases: <code>BaseOAuth2[Dict[str, Any]]</code></p> <p>OAuth2 client for Facebook.</p>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.facebook.FacebookOAuth2.__init__","title":"<code>__init__(client_id, client_secret, scopes=BASE_SCOPES, name='facebook')</code>","text":"<p>Parameters:</p> Name Type Description Default <code>client_id</code> <code>str</code> <p>The client ID provided by the OAuth2 provider.</p> required <code>client_secret</code> <code>str</code> <p>The client secret provided by the OAuth2 provider.</p> required <code>scopes</code> <code>Optional[List[str]]</code> <p>The default scopes to be used in the authorization URL.</p> <code>BASE_SCOPES</code> <code>name</code> <code>str</code> <p>A unique name for the OAuth2 client.</p> <code>'facebook'</code>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.facebook.FacebookOAuth2.get_access_token","title":"<code>get_access_token(code, redirect_uri, code_verifier=None)</code>  <code>async</code>","text":"<p>Requests an access token using the authorization code obtained after the user has authorized the application.</p> <p>Parameters:</p> Name Type Description Default <code>code</code> <code>str</code> <p>The authorization code.</p> required <code>redirect_uri</code> <code>str</code> <p>The URL where the user was redirected after authorization.</p> required <code>code_verifier</code> <code>Optional[str]</code> <p>Optional code verifier used in the PKCE flow.</p> <code>None</code> <p>Returns:</p> Type Description <code>OAuth2Token</code> <p>An access token response dictionary.</p> <p>Raises:</p> Type Description <code>GetAccessTokenError</code> <p>An error occurred while getting the access token.</p> <p>Examples:</p> <pre><code>access_token = await client.get_access_token(\"CODE\", \"https://www.tintagel.bt/oauth-callback\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.facebook.FacebookOAuth2.get_authorization_url","title":"<code>get_authorization_url(redirect_uri, state=None, scope=None, code_challenge=None, code_challenge_method=None, extras_params=None)</code>  <code>async</code>","text":"<p>Builds the authorization URL where the user should be redirected to authorize the application.</p> <p>Parameters:</p> Name Type Description Default <code>redirect_uri</code> <code>str</code> <p>The URL where the user will be redirected after authorization.</p> required <code>state</code> <code>Optional[str]</code> <p>An opaque value used by the client to maintain state</p> <code>None</code> <code>scope</code> <code>Optional[List[str]]</code> <p>The scopes to be requested. If not provided, <code>base_scopes</code> will be used.</p> <code>None</code> <code>code_challenge</code> <code>Optional[str]</code> <p>Optional PKCE code challenge.</p> <code>None</code> <code>code_challenge_method</code> <code>Optional[Literal['plain', 'S256']]</code> <p>Optional PKCE code challenge method.</p> <code>None</code> <code>extras_params</code> <code>Optional[T]</code> <p>Optional extra parameters specific to the service.</p> <code>None</code> <p>Returns:</p> Type Description <code>str</code> <p>The authorization URL.</p> <p>Examples:</p> <p><code>py authorization_url = await client.get_authorization_url(     \"https://www.tintagel.bt/oauth-callback\", scope=[\"SCOPE1\", \"SCOPE2\", \"SCOPE3\"], )</code>py</p>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.facebook.FacebookOAuth2.get_id_email","title":"<code>get_id_email(token)</code>  <code>async</code>","text":"<p>Returns the id and the email (if available) of the authenticated user from the API provider.</p> <p>It assumes you have asked for the required scopes.</p> <p>Parameters:</p> Name Type Description Default <code>token</code> <code>str</code> <p>The access token.</p> required <p>Returns:</p> Type Description <code>Tuple[str, Optional[str]]</code> <p>A tuple with the id and the email of the authenticated user.</p> <p>Raises:</p> Type Description <code>GetIdEmailError</code> <p>An error occurred while getting the id and email.</p> <p>Examples:</p> <pre><code>user_id, user_email = await client.get_id_email(\"TOKEN\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.facebook.FacebookOAuth2.get_long_lived_access_token","title":"<code>get_long_lived_access_token(token)</code>  <code>async</code>","text":"<p>Request a long-lived access token given a short-lived access token.</p> <p>Parameters:</p> Name Type Description Default <code>token</code> <code>str</code> <p>The short-lived access token.</p> required <p>Returns:</p> Type Description <code>OAuth2Token</code> <p>An access token response dictionary.</p> <p>Raises:</p> Type Description <code>GetLongLivedAccessTokenError</code> <p>An error occurred while requesting</p> <p>Examples:</p> <pre><code>long_lived_access_token = await client.get_long_lived_access_token(\"TOKEN\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.facebook.FacebookOAuth2.refresh_token","title":"<code>refresh_token(refresh_token)</code>  <code>async</code>","text":"<p>Requests a new access token using a refresh token.</p> <p>Parameters:</p> Name Type Description Default <code>refresh_token</code> <code>str</code> <p>The refresh token.</p> required <p>Returns:</p> Type Description <code>OAuth2Token</code> <p>An access token response dictionary.</p> <p>Raises:</p> Type Description <code>RefreshTokenError</code> <p>An error occurred while refreshing the token.</p> <code>RefreshTokenNotSupportedError</code> <p>The provider does not support token refresh.</p> <p>Examples:</p> <pre><code>access_token = await client.refresh_token(\"REFRESH_TOKEN\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.facebook.FacebookOAuth2.revoke_token","title":"<code>revoke_token(token, token_type_hint=None)</code>  <code>async</code>","text":"<p>Revokes a token.</p> <p>Parameters:</p> Name Type Description Default <code>token</code> <code>str</code> <p>A token or refresh token to revoke.</p> required <code>token_type_hint</code> <code>Optional[str]</code> <p>Optional hint for the service to help it determine if it's a token or refresh token. Usually either <code>token</code> or <code>refresh_token</code>.</p> <code>None</code> <p>Returns:</p> Type Description <code>None</code> <p>None</p> <p>Raises:</p> Type Description <code>RevokeTokenError</code> <p>An error occurred while revoking the token.</p> <code>RevokeTokenNotSupportedError</code> <p>The provider does not support token revoke.</p>"},{"location":"reference/httpx_oauth.clients/#github","title":"GitHub","text":""},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.github","title":"<code>httpx_oauth.clients.github</code>","text":""},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.github.GitHubOAuth2","title":"<code>GitHubOAuth2</code>","text":"<p>               Bases: <code>BaseOAuth2[GitHubOAuth2AuthorizeParams]</code></p> <p>OAuth2 client for GitHub.</p>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.github.GitHubOAuth2.__init__","title":"<code>__init__(client_id, client_secret, scopes=BASE_SCOPES, name='github')</code>","text":"<p>Parameters:</p> Name Type Description Default <code>client_id</code> <code>str</code> <p>The client ID provided by the OAuth2 provider.</p> required <code>client_secret</code> <code>str</code> <p>The client secret provided by the OAuth2 provider.</p> required <code>scopes</code> <code>Optional[List[str]]</code> <p>The default scopes to be used in the authorization URL.</p> <code>BASE_SCOPES</code> <code>name</code> <code>str</code> <p>A unique name for the OAuth2 client.</p> <code>'github'</code>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.github.GitHubOAuth2.get_access_token","title":"<code>get_access_token(code, redirect_uri, code_verifier=None)</code>  <code>async</code>","text":"<p>Requests an access token using the authorization code obtained after the user has authorized the application.</p> <p>Parameters:</p> Name Type Description Default <code>code</code> <code>str</code> <p>The authorization code.</p> required <code>redirect_uri</code> <code>str</code> <p>The URL where the user was redirected after authorization.</p> required <code>code_verifier</code> <code>Optional[str]</code> <p>Optional code verifier used in the PKCE flow.</p> <code>None</code> <p>Returns:</p> Type Description <code>OAuth2Token</code> <p>An access token response dictionary.</p> <p>Raises:</p> Type Description <code>GetAccessTokenError</code> <p>An error occurred while getting the access token.</p> <p>Examples:</p> <pre><code>access_token = await client.get_access_token(\"CODE\", \"https://www.tintagel.bt/oauth-callback\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.github.GitHubOAuth2.get_authorization_url","title":"<code>get_authorization_url(redirect_uri, state=None, scope=None, code_challenge=None, code_challenge_method=None, extras_params=None)</code>  <code>async</code>","text":"<p>Builds the authorization URL where the user should be redirected to authorize the application.</p> <p>Parameters:</p> Name Type Description Default <code>redirect_uri</code> <code>str</code> <p>The URL where the user will be redirected after authorization.</p> required <code>state</code> <code>Optional[str]</code> <p>An opaque value used by the client to maintain state</p> <code>None</code> <code>scope</code> <code>Optional[List[str]]</code> <p>The scopes to be requested. If not provided, <code>base_scopes</code> will be used.</p> <code>None</code> <code>code_challenge</code> <code>Optional[str]</code> <p>Optional PKCE code challenge.</p> <code>None</code> <code>code_challenge_method</code> <code>Optional[Literal['plain', 'S256']]</code> <p>Optional PKCE code challenge method.</p> <code>None</code> <code>extras_params</code> <code>Optional[T]</code> <p>Optional extra parameters specific to the service.</p> <code>None</code> <p>Returns:</p> Type Description <code>str</code> <p>The authorization URL.</p> <p>Examples:</p> <p><code>py authorization_url = await client.get_authorization_url(     \"https://www.tintagel.bt/oauth-callback\", scope=[\"SCOPE1\", \"SCOPE2\", \"SCOPE3\"], )</code>py</p>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.github.GitHubOAuth2.get_id_email","title":"<code>get_id_email(token)</code>  <code>async</code>","text":"<p>Returns the id and the email (if available) of the authenticated user from the API provider.</p> <p>Tip</p> <p>You should enable Email addresses permission in the Permissions &amp; events section of your GitHub app parameters. You can find it at https://github.com/settings/apps/{YOUR_APP}/permissions.</p> <p>Parameters:</p> Name Type Description Default <code>token</code> <code>str</code> <p>The access token.</p> required <p>Returns:</p> Type Description <code>Tuple[str, Optional[str]]</code> <p>A tuple with the id and the email of the authenticated user.</p> <p>Raises:</p> Type Description <code>GetIdEmailError</code> <p>An error occurred while getting the id and email.</p> <p>Examples:</p> <pre><code>user_id, user_email = await client.get_id_email(\"TOKEN\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.github.GitHubOAuth2.refresh_token","title":"<code>refresh_token(refresh_token)</code>  <code>async</code>","text":"<p>Requests a new access token using a refresh token.</p> <p>Refresh tokens are not enabled by default</p> <p>Refresh tokens are currently an optional feature you need to enable in your GitHub app parameters. Read more.</p> <p>Parameters:</p> Name Type Description Default <code>refresh_token</code> <code>str</code> <p>The refresh token.</p> required <p>Returns:</p> Type Description <p>An access token response dictionary.</p> <p>Raises:</p> Type Description <code>RefreshTokenError</code> <p>An error occurred while refreshing the token.</p> <code>RefreshTokenNotSupportedError</code> <p>The provider does not support token refresh.</p> <p>Examples:</p> <pre><code>access_token = await client.refresh_token(\"REFRESH_TOKEN\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.github.GitHubOAuth2.revoke_token","title":"<code>revoke_token(token, token_type_hint=None)</code>  <code>async</code>","text":"<p>Revokes a token.</p> <p>Parameters:</p> Name Type Description Default <code>token</code> <code>str</code> <p>A token or refresh token to revoke.</p> required <code>token_type_hint</code> <code>Optional[str]</code> <p>Optional hint for the service to help it determine if it's a token or refresh token. Usually either <code>token</code> or <code>refresh_token</code>.</p> <code>None</code> <p>Returns:</p> Type Description <code>None</code> <p>None</p> <p>Raises:</p> Type Description <code>RevokeTokenError</code> <p>An error occurred while revoking the token.</p> <code>RevokeTokenNotSupportedError</code> <p>The provider does not support token revoke.</p>"},{"location":"reference/httpx_oauth.clients/#google","title":"Google","text":""},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.google","title":"<code>httpx_oauth.clients.google</code>","text":""},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.google.GoogleOAuth2","title":"<code>GoogleOAuth2</code>","text":"<p>               Bases: <code>BaseOAuth2[GoogleOAuth2AuthorizeParams]</code></p> <p>OAuth2 client for Google.</p>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.google.GoogleOAuth2.__init__","title":"<code>__init__(client_id, client_secret, scopes=BASE_SCOPES, name='google')</code>","text":"<p>Parameters:</p> Name Type Description Default <code>client_id</code> <code>str</code> <p>The client ID provided by the OAuth2 provider.</p> required <code>client_secret</code> <code>str</code> <p>The client secret provided by the OAuth2 provider.</p> required <code>scopes</code> <code>Optional[List[str]]</code> <p>The default scopes to be used in the authorization URL.</p> <code>BASE_SCOPES</code> <code>name</code> <p>A unique name for the OAuth2 client.</p> <code>'google'</code>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.google.GoogleOAuth2.get_access_token","title":"<code>get_access_token(code, redirect_uri, code_verifier=None)</code>  <code>async</code>","text":"<p>Requests an access token using the authorization code obtained after the user has authorized the application.</p> <p>Parameters:</p> Name Type Description Default <code>code</code> <code>str</code> <p>The authorization code.</p> required <code>redirect_uri</code> <code>str</code> <p>The URL where the user was redirected after authorization.</p> required <code>code_verifier</code> <code>Optional[str]</code> <p>Optional code verifier used in the PKCE flow.</p> <code>None</code> <p>Returns:</p> Type Description <code>OAuth2Token</code> <p>An access token response dictionary.</p> <p>Raises:</p> Type Description <code>GetAccessTokenError</code> <p>An error occurred while getting the access token.</p> <p>Examples:</p> <pre><code>access_token = await client.get_access_token(\"CODE\", \"https://www.tintagel.bt/oauth-callback\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.google.GoogleOAuth2.get_authorization_url","title":"<code>get_authorization_url(redirect_uri, state=None, scope=None, code_challenge=None, code_challenge_method=None, extras_params=None)</code>  <code>async</code>","text":"<p>Builds the authorization URL where the user should be redirected to authorize the application.</p> <p>Parameters:</p> Name Type Description Default <code>redirect_uri</code> <code>str</code> <p>The URL where the user will be redirected after authorization.</p> required <code>state</code> <code>Optional[str]</code> <p>An opaque value used by the client to maintain state</p> <code>None</code> <code>scope</code> <code>Optional[List[str]]</code> <p>The scopes to be requested. If not provided, <code>base_scopes</code> will be used.</p> <code>None</code> <code>code_challenge</code> <code>Optional[str]</code> <p>Optional PKCE code challenge.</p> <code>None</code> <code>code_challenge_method</code> <code>Optional[Literal['plain', 'S256']]</code> <p>Optional PKCE code challenge method.</p> <code>None</code> <code>extras_params</code> <code>Optional[T]</code> <p>Optional extra parameters specific to the service.</p> <code>None</code> <p>Returns:</p> Type Description <code>str</code> <p>The authorization URL.</p> <p>Examples:</p> <p><code>py authorization_url = await client.get_authorization_url(     \"https://www.tintagel.bt/oauth-callback\", scope=[\"SCOPE1\", \"SCOPE2\", \"SCOPE3\"], )</code>py</p>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.google.GoogleOAuth2.get_id_email","title":"<code>get_id_email(token)</code>  <code>async</code>","text":"<p>Returns the id and the email (if available) of the authenticated user from the API provider.</p> <p>It assumes you have asked for the required scopes.</p> <p>Parameters:</p> Name Type Description Default <code>token</code> <code>str</code> <p>The access token.</p> required <p>Returns:</p> Type Description <code>Tuple[str, Optional[str]]</code> <p>A tuple with the id and the email of the authenticated user.</p> <p>Raises:</p> Type Description <code>GetIdEmailError</code> <p>An error occurred while getting the id and email.</p> <p>Examples:</p> <pre><code>user_id, user_email = await client.get_id_email(\"TOKEN\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.google.GoogleOAuth2.refresh_token","title":"<code>refresh_token(refresh_token)</code>  <code>async</code>","text":"<p>Requests a new access token using a refresh token.</p> <p>Parameters:</p> Name Type Description Default <code>refresh_token</code> <code>str</code> <p>The refresh token.</p> required <p>Returns:</p> Type Description <code>OAuth2Token</code> <p>An access token response dictionary.</p> <p>Raises:</p> Type Description <code>RefreshTokenError</code> <p>An error occurred while refreshing the token.</p> <code>RefreshTokenNotSupportedError</code> <p>The provider does not support token refresh.</p> <p>Examples:</p> <pre><code>access_token = await client.refresh_token(\"REFRESH_TOKEN\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.google.GoogleOAuth2.revoke_token","title":"<code>revoke_token(token, token_type_hint=None)</code>  <code>async</code>","text":"<p>Revokes a token.</p> <p>Parameters:</p> Name Type Description Default <code>token</code> <code>str</code> <p>A token or refresh token to revoke.</p> required <code>token_type_hint</code> <code>Optional[str]</code> <p>Optional hint for the service to help it determine if it's a token or refresh token. Usually either <code>token</code> or <code>refresh_token</code>.</p> <code>None</code> <p>Returns:</p> Type Description <code>None</code> <p>None</p> <p>Raises:</p> Type Description <code>RevokeTokenError</code> <p>An error occurred while revoking the token.</p> <code>RevokeTokenNotSupportedError</code> <p>The provider does not support token revoke.</p>"},{"location":"reference/httpx_oauth.clients/#kakao","title":"Kakao","text":""},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.kakao","title":"<code>httpx_oauth.clients.kakao</code>","text":""},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.kakao.KakaoOAuth2","title":"<code>KakaoOAuth2</code>","text":"<p>               Bases: <code>BaseOAuth2[Dict[str, Any]]</code></p> <p>OAuth2 client for Kakao.</p>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.kakao.KakaoOAuth2.__init__","title":"<code>__init__(client_id, client_secret, scopes=BASE_SCOPES, name='kakao')</code>","text":"<p>Parameters:</p> Name Type Description Default <code>client_id</code> <code>str</code> <p>The client ID provided by the OAuth2 provider.</p> required <code>client_secret</code> <code>str</code> <p>The client secret provided by the OAuth2 provider.</p> required <code>scopes</code> <code>Optional[List[str]]</code> <p>The default scopes to be used in the authorization URL.</p> <code>BASE_SCOPES</code> <code>name</code> <code>str</code> <p>A unique name for the OAuth2 client.</p> <code>'kakao'</code>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.kakao.KakaoOAuth2.get_access_token","title":"<code>get_access_token(code, redirect_uri, code_verifier=None)</code>  <code>async</code>","text":"<p>Requests an access token using the authorization code obtained after the user has authorized the application.</p> <p>Parameters:</p> Name Type Description Default <code>code</code> <code>str</code> <p>The authorization code.</p> required <code>redirect_uri</code> <code>str</code> <p>The URL where the user was redirected after authorization.</p> required <code>code_verifier</code> <code>Optional[str]</code> <p>Optional code verifier used in the PKCE flow.</p> <code>None</code> <p>Returns:</p> Type Description <code>OAuth2Token</code> <p>An access token response dictionary.</p> <p>Raises:</p> Type Description <code>GetAccessTokenError</code> <p>An error occurred while getting the access token.</p> <p>Examples:</p> <pre><code>access_token = await client.get_access_token(\"CODE\", \"https://www.tintagel.bt/oauth-callback\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.kakao.KakaoOAuth2.get_authorization_url","title":"<code>get_authorization_url(redirect_uri, state=None, scope=None, code_challenge=None, code_challenge_method=None, extras_params=None)</code>  <code>async</code>","text":"<p>Builds the authorization URL where the user should be redirected to authorize the application.</p> <p>Parameters:</p> Name Type Description Default <code>redirect_uri</code> <code>str</code> <p>The URL where the user will be redirected after authorization.</p> required <code>state</code> <code>Optional[str]</code> <p>An opaque value used by the client to maintain state</p> <code>None</code> <code>scope</code> <code>Optional[List[str]]</code> <p>The scopes to be requested. If not provided, <code>base_scopes</code> will be used.</p> <code>None</code> <code>code_challenge</code> <code>Optional[str]</code> <p>Optional PKCE code challenge.</p> <code>None</code> <code>code_challenge_method</code> <code>Optional[Literal['plain', 'S256']]</code> <p>Optional PKCE code challenge method.</p> <code>None</code> <code>extras_params</code> <code>Optional[T]</code> <p>Optional extra parameters specific to the service.</p> <code>None</code> <p>Returns:</p> Type Description <code>str</code> <p>The authorization URL.</p> <p>Examples:</p> <p><code>py authorization_url = await client.get_authorization_url(     \"https://www.tintagel.bt/oauth-callback\", scope=[\"SCOPE1\", \"SCOPE2\", \"SCOPE3\"], )</code>py</p>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.kakao.KakaoOAuth2.get_id_email","title":"<code>get_id_email(token)</code>  <code>async</code>","text":"<p>Returns the id and the email (if available) of the authenticated user from the API provider.</p> <p>It assumes you have asked for the required scopes.</p> <p>Parameters:</p> Name Type Description Default <code>token</code> <code>str</code> <p>The access token.</p> required <p>Returns:</p> Type Description <code>Tuple[str, Optional[str]]</code> <p>A tuple with the id and the email of the authenticated user.</p> <p>Raises:</p> Type Description <code>GetIdEmailError</code> <p>An error occurred while getting the id and email.</p> <p>Examples:</p> <pre><code>user_id, user_email = await client.get_id_email(\"TOKEN\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.kakao.KakaoOAuth2.refresh_token","title":"<code>refresh_token(refresh_token)</code>  <code>async</code>","text":"<p>Requests a new access token using a refresh token.</p> <p>Parameters:</p> Name Type Description Default <code>refresh_token</code> <code>str</code> <p>The refresh token.</p> required <p>Returns:</p> Type Description <code>OAuth2Token</code> <p>An access token response dictionary.</p> <p>Raises:</p> Type Description <code>RefreshTokenError</code> <p>An error occurred while refreshing the token.</p> <code>RefreshTokenNotSupportedError</code> <p>The provider does not support token refresh.</p> <p>Examples:</p> <pre><code>access_token = await client.refresh_token(\"REFRESH_TOKEN\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.kakao.KakaoOAuth2.revoke_token","title":"<code>revoke_token(token, token_type_hint=None)</code>  <code>async</code>","text":"<p>Revokes a token.</p> <p>Parameters:</p> Name Type Description Default <code>token</code> <code>str</code> <p>A token or refresh token to revoke.</p> required <code>token_type_hint</code> <code>Optional[str]</code> <p>Optional hint for the service to help it determine if it's a token or refresh token. Usually either <code>token</code> or <code>refresh_token</code>.</p> <code>None</code> <p>Returns:</p> Type Description <code>None</code> <p>None</p> <p>Raises:</p> Type Description <code>RevokeTokenError</code> <p>An error occurred while revoking the token.</p> <code>RevokeTokenNotSupportedError</code> <p>The provider does not support token revoke.</p>"},{"location":"reference/httpx_oauth.clients/#linkedin","title":"LinkedIn","text":""},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.linkedin","title":"<code>httpx_oauth.clients.linkedin</code>","text":""},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.linkedin.LinkedInOAuth2","title":"<code>LinkedInOAuth2</code>","text":"<p>               Bases: <code>BaseOAuth2[Dict[str, Any]]</code></p> <p>OAuth2 client for LinkedIn.</p>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.linkedin.LinkedInOAuth2.__init__","title":"<code>__init__(client_id, client_secret, scopes=BASE_SCOPES, name='linkedin')</code>","text":"<p>Parameters:</p> Name Type Description Default <code>client_id</code> <code>str</code> <p>The client ID provided by the OAuth2 provider.</p> required <code>client_secret</code> <code>str</code> <p>The client secret provided by the OAuth2 provider.</p> required <code>scopes</code> <code>Optional[List[str]]</code> <p>The default scopes to be used in the authorization URL.</p> <code>BASE_SCOPES</code> <code>name</code> <code>str</code> <p>A unique name for the OAuth2 client.</p> <code>'linkedin'</code>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.linkedin.LinkedInOAuth2.get_access_token","title":"<code>get_access_token(code, redirect_uri, code_verifier=None)</code>  <code>async</code>","text":"<p>Requests an access token using the authorization code obtained after the user has authorized the application.</p> <p>Parameters:</p> Name Type Description Default <code>code</code> <code>str</code> <p>The authorization code.</p> required <code>redirect_uri</code> <code>str</code> <p>The URL where the user was redirected after authorization.</p> required <code>code_verifier</code> <code>Optional[str]</code> <p>Optional code verifier used in the PKCE flow.</p> <code>None</code> <p>Returns:</p> Type Description <code>OAuth2Token</code> <p>An access token response dictionary.</p> <p>Raises:</p> Type Description <code>GetAccessTokenError</code> <p>An error occurred while getting the access token.</p> <p>Examples:</p> <pre><code>access_token = await client.get_access_token(\"CODE\", \"https://www.tintagel.bt/oauth-callback\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.linkedin.LinkedInOAuth2.get_authorization_url","title":"<code>get_authorization_url(redirect_uri, state=None, scope=None, code_challenge=None, code_challenge_method=None, extras_params=None)</code>  <code>async</code>","text":"<p>Builds the authorization URL where the user should be redirected to authorize the application.</p> <p>Parameters:</p> Name Type Description Default <code>redirect_uri</code> <code>str</code> <p>The URL where the user will be redirected after authorization.</p> required <code>state</code> <code>Optional[str]</code> <p>An opaque value used by the client to maintain state</p> <code>None</code> <code>scope</code> <code>Optional[List[str]]</code> <p>The scopes to be requested. If not provided, <code>base_scopes</code> will be used.</p> <code>None</code> <code>code_challenge</code> <code>Optional[str]</code> <p>Optional PKCE code challenge.</p> <code>None</code> <code>code_challenge_method</code> <code>Optional[Literal['plain', 'S256']]</code> <p>Optional PKCE code challenge method.</p> <code>None</code> <code>extras_params</code> <code>Optional[T]</code> <p>Optional extra parameters specific to the service.</p> <code>None</code> <p>Returns:</p> Type Description <code>str</code> <p>The authorization URL.</p> <p>Examples:</p> <p><code>py authorization_url = await client.get_authorization_url(     \"https://www.tintagel.bt/oauth-callback\", scope=[\"SCOPE1\", \"SCOPE2\", \"SCOPE3\"], )</code>py</p>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.linkedin.LinkedInOAuth2.get_id_email","title":"<code>get_id_email(token)</code>  <code>async</code>","text":"<p>Returns the id and the email (if available) of the authenticated user from the API provider.</p> <p>It assumes you have asked for the required scopes.</p> <p>Parameters:</p> Name Type Description Default <code>token</code> <code>str</code> <p>The access token.</p> required <p>Returns:</p> Type Description <code>Tuple[str, Optional[str]]</code> <p>A tuple with the id and the email of the authenticated user.</p> <p>Raises:</p> Type Description <code>GetIdEmailError</code> <p>An error occurred while getting the id and email.</p> <p>Examples:</p> <pre><code>user_id, user_email = await client.get_id_email(\"TOKEN\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.linkedin.LinkedInOAuth2.refresh_token","title":"<code>refresh_token(refresh_token)</code>  <code>async</code>","text":"<p>Requests a new access token using a refresh token.</p> <p>Warning</p> <p>Only available for selected partners.</p> <p>Parameters:</p> Name Type Description Default <code>refresh_token</code> <code>str</code> <p>The refresh token.</p> required <p>Returns:</p> Type Description <code>OAuth2Token</code> <p>An access token response dictionary.</p> <p>Raises:</p> Type Description <code>RefreshTokenError</code> <p>An error occurred while refreshing the token.</p> <code>RefreshTokenNotSupportedError</code> <p>The provider does not support token refresh.</p> <p>Examples:</p> <pre><code>access_token = await client.refresh_token(\"REFRESH_TOKEN\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.linkedin.LinkedInOAuth2.revoke_token","title":"<code>revoke_token(token, token_type_hint=None)</code>  <code>async</code>","text":"<p>Revokes a token.</p> <p>Parameters:</p> Name Type Description Default <code>token</code> <code>str</code> <p>A token or refresh token to revoke.</p> required <code>token_type_hint</code> <code>Optional[str]</code> <p>Optional hint for the service to help it determine if it's a token or refresh token. Usually either <code>token</code> or <code>refresh_token</code>.</p> <code>None</code> <p>Returns:</p> Type Description <code>None</code> <p>None</p> <p>Raises:</p> Type Description <code>RevokeTokenError</code> <p>An error occurred while revoking the token.</p> <code>RevokeTokenNotSupportedError</code> <p>The provider does not support token revoke.</p>"},{"location":"reference/httpx_oauth.clients/#microsoft","title":"Microsoft","text":""},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.microsoft","title":"<code>httpx_oauth.clients.microsoft</code>","text":""},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2","title":"<code>MicrosoftGraphOAuth2</code>","text":"<p>               Bases: <code>BaseOAuth2[Dict[str, Any]]</code></p> <p>OAuth2 client for Microsoft Graph API.</p>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2.__init__","title":"<code>__init__(client_id, client_secret, tenant='common', scopes=BASE_SCOPES, name='microsoft')</code>","text":"<p>Parameters:</p> Name Type Description Default <code>client_id</code> <code>str</code> <p>The client ID provided by the OAuth2 provider.</p> required <code>client_secret</code> <code>str</code> <p>The client secret provided by the OAuth2 provider.</p> required <code>tenant</code> <code>str</code> <p>The tenant to use for the authorization URL.</p> <code>'common'</code> <code>scopes</code> <code>Optional[List[str]]</code> <p>The default scopes to be used in the authorization URL.</p> <code>BASE_SCOPES</code> <code>name</code> <code>str</code> <p>A unique name for the OAuth2 client.</p> <code>'microsoft'</code>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2.get_access_token","title":"<code>get_access_token(code, redirect_uri, code_verifier=None)</code>  <code>async</code>","text":"<p>Requests an access token using the authorization code obtained after the user has authorized the application.</p> <p>Parameters:</p> Name Type Description Default <code>code</code> <code>str</code> <p>The authorization code.</p> required <code>redirect_uri</code> <code>str</code> <p>The URL where the user was redirected after authorization.</p> required <code>code_verifier</code> <code>Optional[str]</code> <p>Optional code verifier used in the PKCE flow.</p> <code>None</code> <p>Returns:</p> Type Description <code>OAuth2Token</code> <p>An access token response dictionary.</p> <p>Raises:</p> Type Description <code>GetAccessTokenError</code> <p>An error occurred while getting the access token.</p> <p>Examples:</p> <pre><code>access_token = await client.get_access_token(\"CODE\", \"https://www.tintagel.bt/oauth-callback\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2.get_authorization_url","title":"<code>get_authorization_url(redirect_uri, state=None, scope=None, extras_params=None)</code>","text":"<p>Builds the authorization URL where the user should be redirected to authorize the application.</p> <p>Parameters:</p> Name Type Description Default <code>redirect_uri</code> <code>str</code> <p>The URL where the user will be redirected after authorization.</p> required <code>state</code> <code>Optional[str]</code> <p>An opaque value used by the client to maintain state</p> <code>None</code> <code>scope</code> <code>Optional[List[str]]</code> <p>The scopes to be requested. If not provided, <code>base_scopes</code> will be used.</p> <code>None</code> <code>code_challenge</code> <code>Optional[str]</code> <p>Optional PKCE code challenge.</p> <code>None</code> <code>code_challenge_method</code> <code>Optional[Literal['plain', 'S256']]</code> <p>Optional PKCE code challenge method.</p> <code>None</code> <code>extras_params</code> <code>Optional[T]</code> <p>Optional extra parameters specific to the service.</p> <code>None</code> <p>Returns:</p> Type Description <code>str</code> <p>The authorization URL.</p> <p>Examples:</p> <p><code>py authorization_url = await client.get_authorization_url(     \"https://www.tintagel.bt/oauth-callback\", scope=[\"SCOPE1\", \"SCOPE2\", \"SCOPE3\"], )</code>py</p>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2.get_id_email","title":"<code>get_id_email(token)</code>  <code>async</code>","text":"<p>Returns the id and the email (if available) of the authenticated user from the API provider.</p> <p>It assumes you have asked for the required scopes.</p> <p>Parameters:</p> Name Type Description Default <code>token</code> <code>str</code> <p>The access token.</p> required <p>Returns:</p> Type Description <code>Tuple[str, Optional[str]]</code> <p>A tuple with the id and the email of the authenticated user.</p> <p>Raises:</p> Type Description <code>GetIdEmailError</code> <p>An error occurred while getting the id and email.</p> <p>Examples:</p> <pre><code>user_id, user_email = await client.get_id_email(\"TOKEN\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2.refresh_token","title":"<code>refresh_token(refresh_token)</code>  <code>async</code>","text":"<p>Requests a new access token using a refresh token.</p> <p>Parameters:</p> Name Type Description Default <code>refresh_token</code> <code>str</code> <p>The refresh token.</p> required <p>Returns:</p> Type Description <code>OAuth2Token</code> <p>An access token response dictionary.</p> <p>Raises:</p> Type Description <code>RefreshTokenError</code> <p>An error occurred while refreshing the token.</p> <code>RefreshTokenNotSupportedError</code> <p>The provider does not support token refresh.</p> <p>Examples:</p> <pre><code>access_token = await client.refresh_token(\"REFRESH_TOKEN\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.microsoft.MicrosoftGraphOAuth2.revoke_token","title":"<code>revoke_token(token, token_type_hint=None)</code>  <code>async</code>","text":"<p>Revokes a token.</p> <p>Parameters:</p> Name Type Description Default <code>token</code> <code>str</code> <p>A token or refresh token to revoke.</p> required <code>token_type_hint</code> <code>Optional[str]</code> <p>Optional hint for the service to help it determine if it's a token or refresh token. Usually either <code>token</code> or <code>refresh_token</code>.</p> <code>None</code> <p>Returns:</p> Type Description <code>None</code> <p>None</p> <p>Raises:</p> Type Description <code>RevokeTokenError</code> <p>An error occurred while revoking the token.</p> <code>RevokeTokenNotSupportedError</code> <p>The provider does not support token revoke.</p>"},{"location":"reference/httpx_oauth.clients/#naver","title":"Naver","text":""},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.naver","title":"<code>httpx_oauth.clients.naver</code>","text":""},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.naver.NaverOAuth2","title":"<code>NaverOAuth2</code>","text":"<p>               Bases: <code>BaseOAuth2[Dict[str, Any]]</code></p> <p>OAuth2 client for Naver.</p>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.naver.NaverOAuth2.__init__","title":"<code>__init__(client_id, client_secret, scopes=BASE_SCOPES, name='naver')</code>","text":"<p>Parameters:</p> Name Type Description Default <code>client_id</code> <code>str</code> <p>The client ID provided by the OAuth2 provider.</p> required <code>client_secret</code> <code>str</code> <p>The client secret provided by the OAuth2 provider.</p> required <code>scopes</code> <code>Optional[List[str]]</code> <p>The default scopes to be used in the authorization URL.</p> <code>BASE_SCOPES</code> <code>name</code> <code>str</code> <p>A unique name for the OAuth2 client.</p> <code>'naver'</code>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.naver.NaverOAuth2.get_access_token","title":"<code>get_access_token(code, redirect_uri, code_verifier=None)</code>  <code>async</code>","text":"<p>Requests an access token using the authorization code obtained after the user has authorized the application.</p> <p>Parameters:</p> Name Type Description Default <code>code</code> <code>str</code> <p>The authorization code.</p> required <code>redirect_uri</code> <code>str</code> <p>The URL where the user was redirected after authorization.</p> required <code>code_verifier</code> <code>Optional[str]</code> <p>Optional code verifier used in the PKCE flow.</p> <code>None</code> <p>Returns:</p> Type Description <code>OAuth2Token</code> <p>An access token response dictionary.</p> <p>Raises:</p> Type Description <code>GetAccessTokenError</code> <p>An error occurred while getting the access token.</p> <p>Examples:</p> <pre><code>access_token = await client.get_access_token(\"CODE\", \"https://www.tintagel.bt/oauth-callback\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.naver.NaverOAuth2.get_authorization_url","title":"<code>get_authorization_url(redirect_uri, state=None, scope=None, code_challenge=None, code_challenge_method=None, extras_params=None)</code>  <code>async</code>","text":"<p>Builds the authorization URL where the user should be redirected to authorize the application.</p> <p>Parameters:</p> Name Type Description Default <code>redirect_uri</code> <code>str</code> <p>The URL where the user will be redirected after authorization.</p> required <code>state</code> <code>Optional[str]</code> <p>An opaque value used by the client to maintain state</p> <code>None</code> <code>scope</code> <code>Optional[List[str]]</code> <p>The scopes to be requested. If not provided, <code>base_scopes</code> will be used.</p> <code>None</code> <code>code_challenge</code> <code>Optional[str]</code> <p>Optional PKCE code challenge.</p> <code>None</code> <code>code_challenge_method</code> <code>Optional[Literal['plain', 'S256']]</code> <p>Optional PKCE code challenge method.</p> <code>None</code> <code>extras_params</code> <code>Optional[T]</code> <p>Optional extra parameters specific to the service.</p> <code>None</code> <p>Returns:</p> Type Description <code>str</code> <p>The authorization URL.</p> <p>Examples:</p> <p><code>py authorization_url = await client.get_authorization_url(     \"https://www.tintagel.bt/oauth-callback\", scope=[\"SCOPE1\", \"SCOPE2\", \"SCOPE3\"], )</code>py</p>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.naver.NaverOAuth2.get_id_email","title":"<code>get_id_email(token)</code>  <code>async</code>","text":"<p>Returns the id and the email (if available) of the authenticated user from the API provider.</p> <p>It assumes you have asked for the required scopes.</p> <p>Parameters:</p> Name Type Description Default <code>token</code> <code>str</code> <p>The access token.</p> required <p>Returns:</p> Type Description <code>Tuple[str, Optional[str]]</code> <p>A tuple with the id and the email of the authenticated user.</p> <p>Raises:</p> Type Description <code>GetIdEmailError</code> <p>An error occurred while getting the id and email.</p> <p>Examples:</p> <pre><code>user_id, user_email = await client.get_id_email(\"TOKEN\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.naver.NaverOAuth2.refresh_token","title":"<code>refresh_token(refresh_token)</code>  <code>async</code>","text":"<p>Requests a new access token using a refresh token.</p> <p>Parameters:</p> Name Type Description Default <code>refresh_token</code> <code>str</code> <p>The refresh token.</p> required <p>Returns:</p> Type Description <code>OAuth2Token</code> <p>An access token response dictionary.</p> <p>Raises:</p> Type Description <code>RefreshTokenError</code> <p>An error occurred while refreshing the token.</p> <code>RefreshTokenNotSupportedError</code> <p>The provider does not support token refresh.</p> <p>Examples:</p> <pre><code>access_token = await client.refresh_token(\"REFRESH_TOKEN\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.naver.NaverOAuth2.revoke_token","title":"<code>revoke_token(token, token_type_hint=None)</code>  <code>async</code>","text":"<p>Revokes a token.</p> <p>Parameters:</p> Name Type Description Default <code>token</code> <code>str</code> <p>A token or refresh token to revoke.</p> required <code>token_type_hint</code> <code>Optional[str]</code> <p>Optional hint for the service to help it determine if it's a token or refresh token. Usually either <code>token</code> or <code>refresh_token</code>.</p> <code>None</code> <p>Returns:</p> Type Description <code>None</code> <p>None</p> <p>Raises:</p> Type Description <code>RevokeTokenError</code> <p>An error occurred while revoking the token.</p> <code>RevokeTokenNotSupportedError</code> <p>The provider does not support token revoke.</p>"},{"location":"reference/httpx_oauth.clients/#okta","title":"Okta","text":""},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.okta","title":"<code>httpx_oauth.clients.okta</code>","text":""},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.okta.OktaOAuth2","title":"<code>OktaOAuth2</code>","text":"<p>               Bases: <code>OpenID</code></p> <p>OAuth2 client for Okta.</p>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.okta.OktaOAuth2.__init__","title":"<code>__init__(client_id, client_secret, okta_domain, scopes=BASE_SCOPES, name='okta')</code>","text":"<p>Parameters:</p> Name Type Description Default <code>client_id</code> <code>str</code> <p>The client ID provided by the OAuth2 provider.</p> required <code>client_secret</code> <code>str</code> <p>The client secret provided by the OAuth2 provider.</p> required <code>okta_domain</code> <code>str</code> <p>The Okta organization domain.</p> required <code>scopes</code> <code>Optional[List[str]]</code> <p>The default scopes to be used in the authorization URL.</p> <code>BASE_SCOPES</code> <code>name</code> <code>str</code> <p>A unique name for the OAuth2 client.</p> <code>'okta'</code>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.okta.OktaOAuth2.get_access_token","title":"<code>get_access_token(code, redirect_uri, code_verifier=None)</code>  <code>async</code>","text":"<p>Requests an access token using the authorization code obtained after the user has authorized the application.</p> <p>Parameters:</p> Name Type Description Default <code>code</code> <code>str</code> <p>The authorization code.</p> required <code>redirect_uri</code> <code>str</code> <p>The URL where the user was redirected after authorization.</p> required <code>code_verifier</code> <code>Optional[str]</code> <p>Optional code verifier used in the PKCE flow.</p> <code>None</code> <p>Returns:</p> Type Description <code>OAuth2Token</code> <p>An access token response dictionary.</p> <p>Raises:</p> Type Description <code>GetAccessTokenError</code> <p>An error occurred while getting the access token.</p> <p>Examples:</p> <pre><code>access_token = await client.get_access_token(\"CODE\", \"https://www.tintagel.bt/oauth-callback\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.okta.OktaOAuth2.get_authorization_url","title":"<code>get_authorization_url(redirect_uri, state=None, scope=None, code_challenge=None, code_challenge_method=None, extras_params=None)</code>  <code>async</code>","text":"<p>Builds the authorization URL where the user should be redirected to authorize the application.</p> <p>Parameters:</p> Name Type Description Default <code>redirect_uri</code> <code>str</code> <p>The URL where the user will be redirected after authorization.</p> required <code>state</code> <code>Optional[str]</code> <p>An opaque value used by the client to maintain state</p> <code>None</code> <code>scope</code> <code>Optional[List[str]]</code> <p>The scopes to be requested. If not provided, <code>base_scopes</code> will be used.</p> <code>None</code> <code>code_challenge</code> <code>Optional[str]</code> <p>Optional PKCE code challenge.</p> <code>None</code> <code>code_challenge_method</code> <code>Optional[Literal['plain', 'S256']]</code> <p>Optional PKCE code challenge method.</p> <code>None</code> <code>extras_params</code> <code>Optional[T]</code> <p>Optional extra parameters specific to the service.</p> <code>None</code> <p>Returns:</p> Type Description <code>str</code> <p>The authorization URL.</p> <p>Examples:</p> <p><code>py authorization_url = await client.get_authorization_url(     \"https://www.tintagel.bt/oauth-callback\", scope=[\"SCOPE1\", \"SCOPE2\", \"SCOPE3\"], )</code>py</p>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.okta.OktaOAuth2.get_id_email","title":"<code>get_id_email(token)</code>  <code>async</code>","text":"<p>Returns the id and the email (if available) of the authenticated user from the API provider.</p> <p>It assumes you have asked for the required scopes.</p> <p>Parameters:</p> Name Type Description Default <code>token</code> <code>str</code> <p>The access token.</p> required <p>Returns:</p> Type Description <code>Tuple[str, Optional[str]]</code> <p>A tuple with the id and the email of the authenticated user.</p> <p>Raises:</p> Type Description <code>GetIdEmailError</code> <p>An error occurred while getting the id and email.</p> <p>Examples:</p> <pre><code>user_id, user_email = await client.get_id_email(\"TOKEN\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.okta.OktaOAuth2.refresh_token","title":"<code>refresh_token(refresh_token)</code>  <code>async</code>","text":"<p>Requests a new access token using a refresh token.</p> <p>Parameters:</p> Name Type Description Default <code>refresh_token</code> <code>str</code> <p>The refresh token.</p> required <p>Returns:</p> Type Description <code>OAuth2Token</code> <p>An access token response dictionary.</p> <p>Raises:</p> Type Description <code>RefreshTokenError</code> <p>An error occurred while refreshing the token.</p> <code>RefreshTokenNotSupportedError</code> <p>The provider does not support token refresh.</p> <p>Examples:</p> <pre><code>access_token = await client.refresh_token(\"REFRESH_TOKEN\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.okta.OktaOAuth2.revoke_token","title":"<code>revoke_token(token, token_type_hint=None)</code>  <code>async</code>","text":"<p>Revokes a token.</p> <p>Parameters:</p> Name Type Description Default <code>token</code> <code>str</code> <p>A token or refresh token to revoke.</p> required <code>token_type_hint</code> <code>Optional[str]</code> <p>Optional hint for the service to help it determine if it's a token or refresh token. Usually either <code>token</code> or <code>refresh_token</code>.</p> <code>None</code> <p>Returns:</p> Type Description <code>None</code> <p>None</p> <p>Raises:</p> Type Description <code>RevokeTokenError</code> <p>An error occurred while revoking the token.</p> <code>RevokeTokenNotSupportedError</code> <p>The provider does not support token revoke.</p>"},{"location":"reference/httpx_oauth.clients/#openid","title":"OpenID","text":""},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.openid","title":"<code>httpx_oauth.clients.openid</code>","text":""},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.openid.OpenID","title":"<code>OpenID</code>","text":"<p>               Bases: <code>BaseOAuth2[Dict[str, Any]]</code></p> <p>Generic client for providers following the OpenID Connect protocol.</p> <p>Besides the Client ID and the Client Secret, you'll have to provide the OpenID configuration endpoint, allowing the client to discover the required endpoints automatically. By convention, it's usually served under the path <code>.well-known/openid-configuration</code>.</p>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.openid.OpenID.__init__","title":"<code>__init__(client_id, client_secret, openid_configuration_endpoint, name='openid', base_scopes=BASE_SCOPES)</code>","text":"<p>Parameters:</p> Name Type Description Default <code>client_id</code> <code>str</code> <p>The client ID provided by the OAuth2 provider.</p> required <code>client_secret</code> <code>str</code> <p>The client secret provided by the OAuth2 provider.</p> required <code>openid_configuration_endpoint</code> <code>str</code> <p>OpenID Connect discovery endpoint URL.</p> required <code>name</code> <code>str</code> <p>A unique name for the OAuth2 client.</p> <code>'openid'</code> <code>base_scopes</code> <code>Optional[List[str]]</code> <p>The base scopes to be used in the authorization URL.</p> <code>BASE_SCOPES</code> <p>Raises:</p> Type Description <code>OpenIDConfigurationError</code> <p>An error occurred while fetching the OpenID configuration.</p> <p>Examples:</p> <p>```py from httpx_oauth.clients.openid import OpenID</p> <p>client = OpenID(\"CLIENT_ID\", \"CLIENT_SECRET\", \"https://example.fief.dev/.well-known/openid-configuration\") ``</p>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.openid.OpenID.get_access_token","title":"<code>get_access_token(code, redirect_uri, code_verifier=None)</code>  <code>async</code>","text":"<p>Requests an access token using the authorization code obtained after the user has authorized the application.</p> <p>Parameters:</p> Name Type Description Default <code>code</code> <code>str</code> <p>The authorization code.</p> required <code>redirect_uri</code> <code>str</code> <p>The URL where the user was redirected after authorization.</p> required <code>code_verifier</code> <code>Optional[str]</code> <p>Optional code verifier used in the PKCE flow.</p> <code>None</code> <p>Returns:</p> Type Description <code>OAuth2Token</code> <p>An access token response dictionary.</p> <p>Raises:</p> Type Description <code>GetAccessTokenError</code> <p>An error occurred while getting the access token.</p> <p>Examples:</p> <pre><code>access_token = await client.get_access_token(\"CODE\", \"https://www.tintagel.bt/oauth-callback\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.openid.OpenID.get_authorization_url","title":"<code>get_authorization_url(redirect_uri, state=None, scope=None, code_challenge=None, code_challenge_method=None, extras_params=None)</code>  <code>async</code>","text":"<p>Builds the authorization URL where the user should be redirected to authorize the application.</p> <p>Parameters:</p> Name Type Description Default <code>redirect_uri</code> <code>str</code> <p>The URL where the user will be redirected after authorization.</p> required <code>state</code> <code>Optional[str]</code> <p>An opaque value used by the client to maintain state</p> <code>None</code> <code>scope</code> <code>Optional[List[str]]</code> <p>The scopes to be requested. If not provided, <code>base_scopes</code> will be used.</p> <code>None</code> <code>code_challenge</code> <code>Optional[str]</code> <p>Optional PKCE code challenge.</p> <code>None</code> <code>code_challenge_method</code> <code>Optional[Literal['plain', 'S256']]</code> <p>Optional PKCE code challenge method.</p> <code>None</code> <code>extras_params</code> <code>Optional[T]</code> <p>Optional extra parameters specific to the service.</p> <code>None</code> <p>Returns:</p> Type Description <code>str</code> <p>The authorization URL.</p> <p>Examples:</p> <p><code>py authorization_url = await client.get_authorization_url(     \"https://www.tintagel.bt/oauth-callback\", scope=[\"SCOPE1\", \"SCOPE2\", \"SCOPE3\"], )</code>py</p>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.openid.OpenID.get_id_email","title":"<code>get_id_email(token)</code>  <code>async</code>","text":"<p>Returns the id and the email (if available) of the authenticated user from the API provider.</p> <p>It assumes you have asked for the required scopes.</p> <p>Parameters:</p> Name Type Description Default <code>token</code> <code>str</code> <p>The access token.</p> required <p>Returns:</p> Type Description <code>Tuple[str, Optional[str]]</code> <p>A tuple with the id and the email of the authenticated user.</p> <p>Raises:</p> Type Description <code>GetIdEmailError</code> <p>An error occurred while getting the id and email.</p> <p>Examples:</p> <pre><code>user_id, user_email = await client.get_id_email(\"TOKEN\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.openid.OpenID.refresh_token","title":"<code>refresh_token(refresh_token)</code>  <code>async</code>","text":"<p>Requests a new access token using a refresh token.</p> <p>Parameters:</p> Name Type Description Default <code>refresh_token</code> <code>str</code> <p>The refresh token.</p> required <p>Returns:</p> Type Description <code>OAuth2Token</code> <p>An access token response dictionary.</p> <p>Raises:</p> Type Description <code>RefreshTokenError</code> <p>An error occurred while refreshing the token.</p> <code>RefreshTokenNotSupportedError</code> <p>The provider does not support token refresh.</p> <p>Examples:</p> <pre><code>access_token = await client.refresh_token(\"REFRESH_TOKEN\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.openid.OpenID.revoke_token","title":"<code>revoke_token(token, token_type_hint=None)</code>  <code>async</code>","text":"<p>Revokes a token.</p> <p>Parameters:</p> Name Type Description Default <code>token</code> <code>str</code> <p>A token or refresh token to revoke.</p> required <code>token_type_hint</code> <code>Optional[str]</code> <p>Optional hint for the service to help it determine if it's a token or refresh token. Usually either <code>token</code> or <code>refresh_token</code>.</p> <code>None</code> <p>Returns:</p> Type Description <code>None</code> <p>None</p> <p>Raises:</p> Type Description <code>RevokeTokenError</code> <p>An error occurred while revoking the token.</p> <code>RevokeTokenNotSupportedError</code> <p>The provider does not support token revoke.</p>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.openid.OpenIDConfigurationError","title":"<code>OpenIDConfigurationError</code>","text":"<p>               Bases: <code>OAuth2RequestError</code></p> <p>Raised when an error occurred while fetching the OpenID configuration.</p>"},{"location":"reference/httpx_oauth.clients/#reddit","title":"Reddit","text":""},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.reddit","title":"<code>httpx_oauth.clients.reddit</code>","text":""},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.reddit.RedditOAuth2","title":"<code>RedditOAuth2</code>","text":"<p>               Bases: <code>BaseOAuth2[Dict[str, Any]]</code></p> <p>OAuth2 client for Reddit.</p>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.reddit.RedditOAuth2.__init__","title":"<code>__init__(client_id, client_secret, scopes=None, name='reddit')</code>","text":"<p>Parameters:</p> Name Type Description Default <code>client_id</code> <code>str</code> <p>The client ID provided by the OAuth2 provider.</p> required <code>client_secret</code> <code>str</code> <p>The client secret provided by the OAuth2 provider.</p> required <code>scopes</code> <code>Optional[List[str]]</code> <p>The default scopes to be used in the authorization URL.</p> <code>None</code> <code>name</code> <code>str</code> <p>A unique name for the OAuth2 client.</p> <code>'reddit'</code>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.reddit.RedditOAuth2.get_access_token","title":"<code>get_access_token(code, redirect_uri, code_verifier=None)</code>  <code>async</code>","text":"<p>Requests an access token using the authorization code obtained after the user has authorized the application.</p> <p>Parameters:</p> Name Type Description Default <code>code</code> <code>str</code> <p>The authorization code.</p> required <code>redirect_uri</code> <code>str</code> <p>The URL where the user was redirected after authorization.</p> required <code>code_verifier</code> <code>Optional[str]</code> <p>Optional code verifier used in the PKCE flow.</p> <code>None</code> <p>Returns:</p> Type Description <code>OAuth2Token</code> <p>An access token response dictionary.</p> <p>Raises:</p> Type Description <code>GetAccessTokenError</code> <p>An error occurred while getting the access token.</p> <p>Examples:</p> <pre><code>access_token = await client.get_access_token(\"CODE\", \"https://www.tintagel.bt/oauth-callback\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.reddit.RedditOAuth2.get_authorization_url","title":"<code>get_authorization_url(redirect_uri, state=None, scope=None, code_challenge=None, code_challenge_method=None, extras_params=None)</code>  <code>async</code>","text":"<p>Builds the authorization URL where the user should be redirected to authorize the application.</p> <p>Parameters:</p> Name Type Description Default <code>redirect_uri</code> <code>str</code> <p>The URL where the user will be redirected after authorization.</p> required <code>state</code> <code>Optional[str]</code> <p>An opaque value used by the client to maintain state</p> <code>None</code> <code>scope</code> <code>Optional[List[str]]</code> <p>The scopes to be requested. If not provided, <code>base_scopes</code> will be used.</p> <code>None</code> <code>code_challenge</code> <code>Optional[str]</code> <p>Optional PKCE code challenge.</p> <code>None</code> <code>code_challenge_method</code> <code>Optional[Literal['plain', 'S256']]</code> <p>Optional PKCE code challenge method.</p> <code>None</code> <code>extras_params</code> <code>Optional[T]</code> <p>Optional extra parameters specific to the service.</p> <code>None</code> <p>Returns:</p> Type Description <code>str</code> <p>The authorization URL.</p> <p>Examples:</p> <p><code>py authorization_url = await client.get_authorization_url(     \"https://www.tintagel.bt/oauth-callback\", scope=[\"SCOPE1\", \"SCOPE2\", \"SCOPE3\"], )</code>py</p>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.reddit.RedditOAuth2.get_id_email","title":"<code>get_id_email(token)</code>  <code>async</code>","text":"<p>Returns the id and the email (if available) of the authenticated user from the API provider.</p> <p>It assumes you have asked for the required scopes.</p> <p>Parameters:</p> Name Type Description Default <code>token</code> <code>str</code> <p>The access token.</p> required <p>Returns:</p> Type Description <code>Tuple[str, Optional[str]]</code> <p>A tuple with the id and the email of the authenticated user.</p> <p>Raises:</p> Type Description <code>GetIdEmailError</code> <p>An error occurred while getting the id and email.</p> <p>Examples:</p> <pre><code>user_id, user_email = await client.get_id_email(\"TOKEN\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.reddit.RedditOAuth2.refresh_token","title":"<code>refresh_token(refresh_token)</code>  <code>async</code>","text":"<p>Requests a new access token using a refresh token.</p> <p>Parameters:</p> Name Type Description Default <code>refresh_token</code> <code>str</code> <p>The refresh token.</p> required <p>Returns:</p> Type Description <code>OAuth2Token</code> <p>An access token response dictionary.</p> <p>Raises:</p> Type Description <code>RefreshTokenError</code> <p>An error occurred while refreshing the token.</p> <code>RefreshTokenNotSupportedError</code> <p>The provider does not support token refresh.</p> <p>Examples:</p> <pre><code>access_token = await client.refresh_token(\"REFRESH_TOKEN\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.reddit.RedditOAuth2.revoke_token","title":"<code>revoke_token(token, token_type_hint=None)</code>  <code>async</code>","text":"<p>Revokes a token.</p> <p>Parameters:</p> Name Type Description Default <code>token</code> <code>str</code> <p>A token or refresh token to revoke.</p> required <code>token_type_hint</code> <code>Optional[str]</code> <p>Optional hint for the service to help it determine if it's a token or refresh token. Usually either <code>token</code> or <code>refresh_token</code>.</p> <code>None</code> <p>Returns:</p> Type Description <code>None</code> <p>None</p> <p>Raises:</p> Type Description <code>RevokeTokenError</code> <p>An error occurred while revoking the token.</p> <code>RevokeTokenNotSupportedError</code> <p>The provider does not support token revoke.</p>"},{"location":"reference/httpx_oauth.clients/#shopify","title":"Shopify","text":""},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.shopify","title":"<code>httpx_oauth.clients.shopify</code>","text":""},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.shopify.ShopifyOAuth2","title":"<code>ShopifyOAuth2</code>","text":"<p>               Bases: <code>BaseOAuth2[ShopifyOAuth2AuthorizeParams]</code></p> <p>OAuth2 client for Shopify.</p> <p>The OAuth2 client for Shopify authenticates shop owners to allow making calls to the Shopify Admin API.</p>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.shopify.ShopifyOAuth2.__init__","title":"<code>__init__(client_id, client_secret, shop, scopes=BASE_SCOPES, api_version='2023-04', name='shopify')</code>","text":"<p>Parameters:</p> Name Type Description Default <code>client_id</code> <code>str</code> <p>The client ID provided by the OAuth2 provider.</p> required <code>client_secret</code> <code>str</code> <p>The client secret provided by the OAuth2 provider.</p> required <code>shop</code> <code>str</code> <p>The shop subdomain.</p> required <code>scopes</code> <code>Optional[List[str]]</code> <p>The default scopes to be used in the authorization URL.</p> <code>BASE_SCOPES</code> <code>api_version</code> <code>str</code> <p>The version of the Shopify Admin API.</p> <code>'2023-04'</code> <code>name</code> <code>str</code> <p>A unique name for the OAuth2 client.</p> <code>'shopify'</code>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.shopify.ShopifyOAuth2.get_access_token","title":"<code>get_access_token(code, redirect_uri, code_verifier=None)</code>  <code>async</code>","text":"<p>Requests an access token using the authorization code obtained after the user has authorized the application.</p> <p>Parameters:</p> Name Type Description Default <code>code</code> <code>str</code> <p>The authorization code.</p> required <code>redirect_uri</code> <code>str</code> <p>The URL where the user was redirected after authorization.</p> required <code>code_verifier</code> <code>Optional[str]</code> <p>Optional code verifier used in the PKCE flow.</p> <code>None</code> <p>Returns:</p> Type Description <code>OAuth2Token</code> <p>An access token response dictionary.</p> <p>Raises:</p> Type Description <code>GetAccessTokenError</code> <p>An error occurred while getting the access token.</p> <p>Examples:</p> <pre><code>access_token = await client.get_access_token(\"CODE\", \"https://www.tintagel.bt/oauth-callback\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.shopify.ShopifyOAuth2.get_authorization_url","title":"<code>get_authorization_url(redirect_uri, state=None, scope=None, code_challenge=None, code_challenge_method=None, extras_params=None)</code>  <code>async</code>","text":"<p>Builds the authorization URL where the user should be redirected to authorize the application.</p> <p>Parameters:</p> Name Type Description Default <code>redirect_uri</code> <code>str</code> <p>The URL where the user will be redirected after authorization.</p> required <code>state</code> <code>Optional[str]</code> <p>An opaque value used by the client to maintain state</p> <code>None</code> <code>scope</code> <code>Optional[List[str]]</code> <p>The scopes to be requested. If not provided, <code>base_scopes</code> will be used.</p> <code>None</code> <code>code_challenge</code> <code>Optional[str]</code> <p>Optional PKCE code challenge.</p> <code>None</code> <code>code_challenge_method</code> <code>Optional[Literal['plain', 'S256']]</code> <p>Optional PKCE code challenge method.</p> <code>None</code> <code>extras_params</code> <code>Optional[T]</code> <p>Optional extra parameters specific to the service.</p> <code>None</code> <p>Returns:</p> Type Description <code>str</code> <p>The authorization URL.</p> <p>Examples:</p> <p><code>py authorization_url = await client.get_authorization_url(     \"https://www.tintagel.bt/oauth-callback\", scope=[\"SCOPE1\", \"SCOPE2\", \"SCOPE3\"], )</code>py</p>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.shopify.ShopifyOAuth2.get_id_email","title":"<code>get_id_email(token)</code>  <code>async</code>","text":"<p>Returns the id and the email (if available) of the authenticated user from the API provider.</p> <p><code>get_id_email</code> is based on the <code>Shop</code> resource</p> <p>The implementation of <code>get_id_email</code> calls the Get Shop endpoint of the Shopify Admin API. It means that it'll return you the ID of the shop and the email of the shop owner.</p> <p>Parameters:</p> Name Type Description Default <code>token</code> <code>str</code> <p>The access token.</p> required <p>Returns:</p> Type Description <code>Tuple[str, Optional[str]]</code> <p>A tuple with the id and the email of the authenticated user.</p> <p>Raises:</p> Type Description <code>GetIdEmailError</code> <p>An error occurred while getting the id and email.</p> <p>Examples:</p> <pre><code>user_id, user_email = await client.get_id_email(\"TOKEN\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.shopify.ShopifyOAuth2.refresh_token","title":"<code>refresh_token(refresh_token)</code>  <code>async</code>","text":"<p>Requests a new access token using a refresh token.</p> <p>Parameters:</p> Name Type Description Default <code>refresh_token</code> <code>str</code> <p>The refresh token.</p> required <p>Returns:</p> Type Description <code>OAuth2Token</code> <p>An access token response dictionary.</p> <p>Raises:</p> Type Description <code>RefreshTokenError</code> <p>An error occurred while refreshing the token.</p> <code>RefreshTokenNotSupportedError</code> <p>The provider does not support token refresh.</p> <p>Examples:</p> <pre><code>access_token = await client.refresh_token(\"REFRESH_TOKEN\")\n</code></pre>"},{"location":"reference/httpx_oauth.clients/#httpx_oauth.clients.shopify.ShopifyOAuth2.revoke_token","title":"<code>revoke_token(token, token_type_hint=None)</code>  <code>async</code>","text":"<p>Revokes a token.</p> <p>Parameters:</p> Name Type Description Default <code>token</code> <code>str</code> <p>A token or refresh token to revoke.</p> required <code>token_type_hint</code> <code>Optional[str]</code> <p>Optional hint for the service to help it determine if it's a token or refresh token. Usually either <code>token</code> or <code>refresh_token</code>.</p> <code>None</code> <p>Returns:</p> Type Description <code>None</code> <p>None</p> <p>Raises:</p> Type Description <code>RevokeTokenError</code> <p>An error occurred while revoking the token.</p> <code>RevokeTokenNotSupportedError</code> <p>The provider does not support token revoke.</p>"},{"location":"reference/httpx_oauth.exceptions/","title":"Reference - Exceptions","text":""},{"location":"reference/httpx_oauth.exceptions/#httpx_oauth.exceptions.GetIdEmailError","title":"<code>GetIdEmailError</code>","text":"<p>               Bases: <code>HTTPXOAuthError</code></p> <p>Error raised while retrieving user profile from provider API.</p>"},{"location":"reference/httpx_oauth.exceptions/#httpx_oauth.exceptions.HTTPXOAuthError","title":"<code>HTTPXOAuthError</code>","text":"<p>               Bases: <code>Exception</code></p> <p>Base exception class for every httpx-oauth errors.</p>"},{"location":"reference/httpx_oauth.oauth2/","title":"Reference - OAuth2","text":""},{"location":"reference/httpx_oauth.oauth2/#httpx_oauth.oauth2.OAuth2","title":"<code>OAuth2 = BaseOAuth2[Dict[str, Any]]</code>  <code>module-attribute</code>","text":"<p>Generic OAuth2 client.</p> <p>Examples:</p> <pre><code>from httpx_oauth.oauth2 import OAuth2\n\nclient = OAuth2(\n    \"CLIENT_ID\",\n    \"CLIENT_SECRET\",\n    \"AUTHORIZE_ENDPOINT\",\n    \"ACCESS_TOKEN_ENDPOINT\",\n    refresh_token_endpoint=\"REFRESH_TOKEN_ENDPOINT\",\n    revoke_token_endpoint=\"REVOKE_TOKEN_ENDPOINT\",\n)\n</code></pre>"},{"location":"reference/httpx_oauth.oauth2/#httpx_oauth.oauth2.OAuth2ClientAuthMethod","title":"<code>OAuth2ClientAuthMethod = Literal['client_secret_basic', 'client_secret_post']</code>  <code>module-attribute</code>","text":"<p>Supported OAuth2 client authentication methods.</p>"},{"location":"reference/httpx_oauth.oauth2/#httpx_oauth.oauth2.BaseOAuth2","title":"<code>BaseOAuth2</code>","text":"<p>               Bases: <code>Generic[T]</code></p> <p>Base OAuth2 client.</p> <p>This class provides a base implementation for OAuth2 clients. If you need to use a generic client, use OAuth2 instead.</p>"},{"location":"reference/httpx_oauth.oauth2/#httpx_oauth.oauth2.BaseOAuth2.__init__","title":"<code>__init__(client_id, client_secret, authorize_endpoint, access_token_endpoint, refresh_token_endpoint=None, revoke_token_endpoint=None, *, name='oauth2', base_scopes=None, token_endpoint_auth_method='client_secret_post', revocation_endpoint_auth_method=None)</code>","text":"<p>Parameters:</p> Name Type Description Default <code>client_id</code> <code>str</code> <p>The client ID provided by the OAuth2 provider.</p> required <code>client_secret</code> <code>str</code> <p>The client secret provided by the OAuth2 provider.</p> required <code>authorize_endpoint</code> <code>str</code> <p>The authorization endpoint URL.</p> required <code>access_token_endpoint</code> <code>str</code> <p>The access token endpoint URL.</p> required <code>refresh_token_endpoint</code> <code>Optional[str]</code> <p>The refresh token endpoint URL.</p> <code>None</code> <code>revoke_token_endpoint</code> <code>Optional[str]</code> <p>The revoke token endpoint URL.</p> <code>None</code> <code>name</code> <code>str</code> <p>A unique name for the OAuth2 client.</p> <code>'oauth2'</code> <code>base_scopes</code> <code>Optional[List[str]]</code> <p>The base scopes to be used in the authorization URL.</p> <code>None</code> <code>token_endpoint_auth_method</code> <code>OAuth2ClientAuthMethod</code> <p>The authentication method to be used in the token endpoint.</p> <code>'client_secret_post'</code> <code>revocation_endpoint_auth_method</code> <code>Optional[OAuth2ClientAuthMethod]</code> <p>The authentication method to be used in the revocation endpoint.</p> <code>None</code> <p>Raises:</p> Type Description <code>NotSupportedAuthMethodError</code> <p>The provided authentication method is not supported.</p> <code>MissingRevokeTokenAuthMethodError</code> <p>The revocation endpoint auth method is missing.</p>"},{"location":"reference/httpx_oauth.oauth2/#httpx_oauth.oauth2.BaseOAuth2.get_access_token","title":"<code>get_access_token(code, redirect_uri, code_verifier=None)</code>  <code>async</code>","text":"<p>Requests an access token using the authorization code obtained after the user has authorized the application.</p> <p>Parameters:</p> Name Type Description Default <code>code</code> <code>str</code> <p>The authorization code.</p> required <code>redirect_uri</code> <code>str</code> <p>The URL where the user was redirected after authorization.</p> required <code>code_verifier</code> <code>Optional[str]</code> <p>Optional code verifier used in the PKCE flow.</p> <code>None</code> <p>Returns:</p> Type Description <code>OAuth2Token</code> <p>An access token response dictionary.</p> <p>Raises:</p> Type Description <code>GetAccessTokenError</code> <p>An error occurred while getting the access token.</p> <p>Examples:</p> <pre><code>access_token = await client.get_access_token(\"CODE\", \"https://www.tintagel.bt/oauth-callback\")\n</code></pre>"},{"location":"reference/httpx_oauth.oauth2/#httpx_oauth.oauth2.BaseOAuth2.get_authorization_url","title":"<code>get_authorization_url(redirect_uri, state=None, scope=None, code_challenge=None, code_challenge_method=None, extras_params=None)</code>  <code>async</code>","text":"<p>Builds the authorization URL where the user should be redirected to authorize the application.</p> <p>Parameters:</p> Name Type Description Default <code>redirect_uri</code> <code>str</code> <p>The URL where the user will be redirected after authorization.</p> required <code>state</code> <code>Optional[str]</code> <p>An opaque value used by the client to maintain state</p> <code>None</code> <code>scope</code> <code>Optional[List[str]]</code> <p>The scopes to be requested. If not provided, <code>base_scopes</code> will be used.</p> <code>None</code> <code>code_challenge</code> <code>Optional[str]</code> <p>Optional PKCE code challenge.</p> <code>None</code> <code>code_challenge_method</code> <code>Optional[Literal['plain', 'S256']]</code> <p>Optional PKCE code challenge method.</p> <code>None</code> <code>extras_params</code> <code>Optional[T]</code> <p>Optional extra parameters specific to the service.</p> <code>None</code> <p>Returns:</p> Type Description <code>str</code> <p>The authorization URL.</p> <p>Examples:</p> <p><code>py authorization_url = await client.get_authorization_url(     \"https://www.tintagel.bt/oauth-callback\", scope=[\"SCOPE1\", \"SCOPE2\", \"SCOPE3\"], )</code>py</p>"},{"location":"reference/httpx_oauth.oauth2/#httpx_oauth.oauth2.BaseOAuth2.get_id_email","title":"<code>get_id_email(token)</code>  <code>async</code>","text":"<p>Returns the id and the email (if available) of the authenticated user from the API provider.</p> <p>It assumes you have asked for the required scopes.</p> <p>Parameters:</p> Name Type Description Default <code>token</code> <code>str</code> <p>The access token.</p> required <p>Returns:</p> Type Description <code>Tuple[str, Optional[str]]</code> <p>A tuple with the id and the email of the authenticated user.</p> <p>Raises:</p> Type Description <code>GetIdEmailError</code> <p>An error occurred while getting the id and email.</p> <p>Examples:</p> <pre><code>user_id, user_email = await client.get_id_email(\"TOKEN\")\n</code></pre>"},{"location":"reference/httpx_oauth.oauth2/#httpx_oauth.oauth2.BaseOAuth2.refresh_token","title":"<code>refresh_token(refresh_token)</code>  <code>async</code>","text":"<p>Requests a new access token using a refresh token.</p> <p>Parameters:</p> Name Type Description Default <code>refresh_token</code> <code>str</code> <p>The refresh token.</p> required <p>Returns:</p> Type Description <code>OAuth2Token</code> <p>An access token response dictionary.</p> <p>Raises:</p> Type Description <code>RefreshTokenError</code> <p>An error occurred while refreshing the token.</p> <code>RefreshTokenNotSupportedError</code> <p>The provider does not support token refresh.</p> <p>Examples:</p> <pre><code>access_token = await client.refresh_token(\"REFRESH_TOKEN\")\n</code></pre>"},{"location":"reference/httpx_oauth.oauth2/#httpx_oauth.oauth2.BaseOAuth2.revoke_token","title":"<code>revoke_token(token, token_type_hint=None)</code>  <code>async</code>","text":"<p>Revokes a token.</p> <p>Parameters:</p> Name Type Description Default <code>token</code> <code>str</code> <p>A token or refresh token to revoke.</p> required <code>token_type_hint</code> <code>Optional[str]</code> <p>Optional hint for the service to help it determine if it's a token or refresh token. Usually either <code>token</code> or <code>refresh_token</code>.</p> <code>None</code> <p>Returns:</p> Type Description <code>None</code> <p>None</p> <p>Raises:</p> Type Description <code>RevokeTokenError</code> <p>An error occurred while revoking the token.</p> <code>RevokeTokenNotSupportedError</code> <p>The provider does not support token revoke.</p>"},{"location":"reference/httpx_oauth.oauth2/#httpx_oauth.oauth2.GetAccessTokenError","title":"<code>GetAccessTokenError</code>","text":"<p>               Bases: <code>OAuth2RequestError</code></p> <p>Error raised when an error occurs while getting an access token.</p>"},{"location":"reference/httpx_oauth.oauth2/#httpx_oauth.oauth2.MissingRevokeTokenAuthMethodError","title":"<code>MissingRevokeTokenAuthMethodError</code>","text":"<p>               Bases: <code>OAuth2Error</code></p> <p>Error raised when the revocation endpoint auth method is missing.</p>"},{"location":"reference/httpx_oauth.oauth2/#httpx_oauth.oauth2.NotSupportedAuthMethodError","title":"<code>NotSupportedAuthMethodError</code>","text":"<p>               Bases: <code>OAuth2Error</code></p> <p>Error raised when an unsupported authentication method is used.</p>"},{"location":"reference/httpx_oauth.oauth2/#httpx_oauth.oauth2.OAuth2Error","title":"<code>OAuth2Error</code>","text":"<p>               Bases: <code>HTTPXOAuthError</code></p> <p>Base exception class for OAuth2 client errors.</p>"},{"location":"reference/httpx_oauth.oauth2/#httpx_oauth.oauth2.OAuth2RequestError","title":"<code>OAuth2RequestError</code>","text":"<p>               Bases: <code>OAuth2Error</code></p> <p>Base exception class for OAuth2 request errors.</p>"},{"location":"reference/httpx_oauth.oauth2/#httpx_oauth.oauth2.OAuth2Token","title":"<code>OAuth2Token</code>","text":"<p>               Bases: <code>Dict[str, Any]</code></p> <p>Wrapper around a standard <code>Dict[str, Any]</code> that bears the response of a successful token request.</p> <p>Properties can vary greatly from a service to another but, usually, you can get access token like this:</p> <p>Examples:</p> <pre><code>access_token = token[\"access_token\"]\n</code></pre>"},{"location":"reference/httpx_oauth.oauth2/#httpx_oauth.oauth2.OAuth2Token.is_expired","title":"<code>is_expired()</code>","text":"<p>Checks if the token is expired.</p> <p>Returns:</p> Type Description <code>bool</code> <p>True if the token is expired, False otherwise</p>"},{"location":"reference/httpx_oauth.oauth2/#httpx_oauth.oauth2.RefreshTokenError","title":"<code>RefreshTokenError</code>","text":"<p>               Bases: <code>OAuth2RequestError</code></p> <p>Error raised when an error occurs while refreshing a token.</p>"},{"location":"reference/httpx_oauth.oauth2/#httpx_oauth.oauth2.RefreshTokenNotSupportedError","title":"<code>RefreshTokenNotSupportedError</code>","text":"<p>               Bases: <code>OAuth2Error</code></p> <p>Error raised when trying to refresh a token on a provider that does not support it.</p>"},{"location":"reference/httpx_oauth.oauth2/#httpx_oauth.oauth2.RevokeTokenError","title":"<code>RevokeTokenError</code>","text":"<p>               Bases: <code>OAuth2RequestError</code></p> <p>Error raised when an error occurs while revoking a token.</p>"},{"location":"reference/httpx_oauth.oauth2/#httpx_oauth.oauth2.RevokeTokenNotSupportedError","title":"<code>RevokeTokenNotSupportedError</code>","text":"<p>               Bases: <code>OAuth2Error</code></p> <p>Error raised when trying to revole a token on a provider that does not support it.</p>"}]}
\ No newline at end of file
diff --git a/usage/index.html b/usage/index.html
new file mode 100644
index 0000000..612e90c
--- /dev/null
+++ b/usage/index.html
@@ -0,0 +1,810 @@
+
+<!doctype html>
+<html lang="en" class="no-js">
+  <head>
+    
+      <meta charset="utf-8">
+      <meta name="viewport" content="width=device-width,initial-scale=1">
+      
+        <meta name="description" content="Async OAuth client using HTTPX">
+      
+      
+      
+      
+        <link rel="prev" href="..">
+      
+      
+        <link rel="next" href="../fastapi/">
+      
+      
+      <link rel="icon" href="../assets/images/favicon.png">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.28">
+    
+    
+      
+        <title>Usage - HTTPX OAuth</title>
+      
+    
+    
+      <link rel="stylesheet" href="../assets/stylesheets/main.6543a935.min.css">
+      
+        
+        <link rel="stylesheet" href="../assets/stylesheets/palette.06af60db.min.css">
+      
+      
+
+
+    
+    
+      
+    
+    
+      
+        
+        
+        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
+        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
+      
+    
+    
+      <link rel="stylesheet" href="../assets/_mkdocstrings.css">
+    
+      <link rel="stylesheet" href="../assets/stylesheets/extra.css">
+    
+    <script>__md_scope=new URL("..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
+    
+      
+
+    
+    
+    
+  </head>
+  
+  
+    
+    
+      
+    
+    
+    
+    
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo">
+  
+    
+    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
+    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
+    <label class="md-overlay" for="__drawer"></label>
+    <div data-md-component="skip">
+      
+        
+        <a href="#usage" class="md-skip">
+          Skip to content
+        </a>
+      
+    </div>
+    <div data-md-component="announce">
+      
+    </div>
+    
+    
+      
+
+  
+
+<header class="md-header md-header--shadow" data-md-component="header">
+  <nav class="md-header__inner md-grid" aria-label="Header">
+    <a href=".." title="HTTPX OAuth" class="md-header__button md-logo" aria-label="HTTPX OAuth" data-md-component="logo">
+      
+  
+  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 12h7c-.53 4.11-3.28 7.78-7 8.92V12H5V6.3l7-3.11M12 1 3 5v6c0 5.55 3.84 10.73 9 12 5.16-1.27 9-6.45 9-12V5l-9-4Z"/></svg>
+
+    </a>
+    <label class="md-header__button md-icon" for="__drawer">
+      
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
+    </label>
+    <div class="md-header__title" data-md-component="header-title">
+      <div class="md-header__ellipsis">
+        <div class="md-header__topic">
+          <span class="md-ellipsis">
+            HTTPX OAuth
+          </span>
+        </div>
+        <div class="md-header__topic" data-md-component="header-topic">
+          <span class="md-ellipsis">
+            
+              Usage
+            
+          </span>
+        </div>
+      </div>
+    </div>
+    
+      
+        <form class="md-header__option" data-md-component="palette">
+  
+    
+    
+    
+    <input class="md-option" data-md-color-media="(prefers-color-scheme)" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo"  aria-label="Switch to light mode"  type="radio" name="__palette" id="__palette_0">
+    
+      <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_1" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m14.3 16-.7-2h-3.2l-.7 2H7.8L11 7h2l3.2 9h-1.9M20 8.69V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69m-9.15 3.96h2.3L12 9l-1.15 3.65Z"/></svg>
+      </label>
+    
+  
+    
+    
+    
+    <input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="blue-grey" data-md-color-accent="blue-grey"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_1">
+    
+      <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_2" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
+      </label>
+    
+  
+    
+    
+    
+    <input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="blue-grey" data-md-color-accent="blue-grey"  aria-label="Switch to light mode"  type="radio" name="__palette" id="__palette_2">
+    
+      <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_0" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12c0-2.42-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
+      </label>
+    
+  
+</form>
+      
+    
+    
+      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
+    
+    
+    
+      <label class="md-header__button md-icon" for="__search">
+        
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
+      </label>
+      <div class="md-search" data-md-component="search" role="dialog">
+  <label class="md-search__overlay" for="__search"></label>
+  <div class="md-search__inner" role="search">
+    <form class="md-search__form" name="search">
+      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
+      <label class="md-search__icon md-icon" for="__search">
+        
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
+        
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
+      </label>
+      <nav class="md-search__options" aria-label="Search">
+        
+        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
+          
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
+        </button>
+      </nav>
+      
+    </form>
+    <div class="md-search__output">
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
+        <div class="md-search-result" data-md-component="search-result">
+          <div class="md-search-result__meta">
+            Initializing search
+          </div>
+          <ol class="md-search-result__list" role="presentation"></ol>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>
+    
+    
+      <div class="md-header__source">
+        <a href="https://github.com/frankie567/httpx-oauth" title="Go to repository" class="md-source" data-md-component="source">
+  <div class="md-source__icon md-icon">
+    
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
+  </div>
+  <div class="md-source__repository">
+    frankie567/httpx-oauth
+  </div>
+</a>
+      </div>
+    
+  </nav>
+  
+</header>
+    
+    <div class="md-container" data-md-component="container">
+      
+      
+        
+          
+        
+      
+      <main class="md-main" data-md-component="main">
+        <div class="md-main__inner md-grid">
+          
+            
+              
+              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+                    
+
+
+
+<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
+  <label class="md-nav__title" for="__drawer">
+    <a href=".." title="HTTPX OAuth" class="md-nav__button md-logo" aria-label="HTTPX OAuth" data-md-component="logo">
+      
+  
+  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 12h7c-.53 4.11-3.28 7.78-7 8.92V12H5V6.3l7-3.11M12 1 3 5v6c0 5.55 3.84 10.73 9 12 5.16-1.27 9-6.45 9-12V5l-9-4Z"/></svg>
+
+    </a>
+    HTTPX OAuth
+  </label>
+  
+    <div class="md-nav__source">
+      <a href="https://github.com/frankie567/httpx-oauth" title="Go to repository" class="md-source" data-md-component="source">
+  <div class="md-source__icon md-icon">
+    
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
+  </div>
+  <div class="md-source__repository">
+    frankie567/httpx-oauth
+  </div>
+</a>
+    </div>
+  
+  <ul class="md-nav__list" data-md-scrollfix>
+    
+      
+      
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href=".." class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    About
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+    
+  
+  
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+        
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    Usage
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
+        
+  
+  <span class="md-ellipsis">
+    Usage
+  </span>
+  
+
+      </a>
+      
+        
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+    
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#create-a-client" class="md-nav__link">
+    <span class="md-ellipsis">
+      Create a client
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#generate-an-authorization-url" class="md-nav__link">
+    <span class="md-ellipsis">
+      Generate an authorization URL
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#request-an-access-token" class="md-nav__link">
+    <span class="md-ellipsis">
+      Request an access token
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#refresh-an-access-token" class="md-nav__link">
+    <span class="md-ellipsis">
+      Refresh an access token
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#revoke-an-access-or-refresh-token" class="md-nav__link">
+    <span class="md-ellipsis">
+      Revoke an access or refresh token
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#get-authenticated-user-id-and-email" class="md-nav__link">
+    <span class="md-ellipsis">
+      Get authenticated user ID and email
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#provided-clients" class="md-nav__link">
+    <span class="md-ellipsis">
+      Provided clients
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#customize-httpx-client" class="md-nav__link">
+    <span class="md-ellipsis">
+      Customize HTTPX client
+    </span>
+  </a>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+  
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
+        
+          
+          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
+            
+  
+  <span class="md-ellipsis">
+    Integrations
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_3">
+            <span class="md-nav__icon md-icon"></span>
+            Integrations
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../fastapi/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    FastAPI
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+  
+    
+    
+    
+    
+    <li class="md-nav__item md-nav__item--nested">
+      
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
+        
+          
+          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
+            
+  
+  <span class="md-ellipsis">
+    Reference
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_4">
+            <span class="md-nav__icon md-icon"></span>
+            Reference
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../reference/httpx_oauth.clients/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    httpx_oauth.clients
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../reference/httpx_oauth.oauth2/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    httpx_oauth.oauth2
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../reference/httpx_oauth.exceptions/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    httpx_oauth.exceptions
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+  </ul>
+</nav>
+                  </div>
+                </div>
+              </div>
+            
+            
+              
+              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+                    
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+    
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#create-a-client" class="md-nav__link">
+    <span class="md-ellipsis">
+      Create a client
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#generate-an-authorization-url" class="md-nav__link">
+    <span class="md-ellipsis">
+      Generate an authorization URL
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#request-an-access-token" class="md-nav__link">
+    <span class="md-ellipsis">
+      Request an access token
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#refresh-an-access-token" class="md-nav__link">
+    <span class="md-ellipsis">
+      Refresh an access token
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#revoke-an-access-or-refresh-token" class="md-nav__link">
+    <span class="md-ellipsis">
+      Revoke an access or refresh token
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#get-authenticated-user-id-and-email" class="md-nav__link">
+    <span class="md-ellipsis">
+      Get authenticated user ID and email
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#provided-clients" class="md-nav__link">
+    <span class="md-ellipsis">
+      Provided clients
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#customize-httpx-client" class="md-nav__link">
+    <span class="md-ellipsis">
+      Customize HTTPX client
+    </span>
+  </a>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+                  </div>
+                </div>
+              </div>
+            
+          
+          
+            <div class="md-content" data-md-component="content">
+              <article class="md-content__inner md-typeset">
+                
+                  
+
+
+<h1 id="usage">Usage<a class="headerlink" href="#usage" title="Permanent link">&para;</a></h1>
+<h2 id="create-a-client">Create a client<a class="headerlink" href="#create-a-client" title="Permanent link">&para;</a></h2>
+<p>A generic OAuth2 class is provided to adapt to any OAuth2-compliant service. You can instantiate it like this:</p>
+<div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="kn">from</span> <span class="nn">httpx_oauth.oauth2</span> <span class="kn">import</span> <span class="n">OAuth2</span>
+<a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a>
+<a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="n">client</span> <span class="o">=</span> <span class="n">OAuth2</span><span class="p">(</span>
+<a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a>    <span class="s2">&quot;CLIENT_ID&quot;</span><span class="p">,</span>
+<a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a>    <span class="s2">&quot;CLIENT_SECRET&quot;</span><span class="p">,</span>
+<a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a>    <span class="s2">&quot;AUTHORIZE_ENDPOINT&quot;</span><span class="p">,</span>
+<a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a>    <span class="s2">&quot;ACCESS_TOKEN_ENDPOINT&quot;</span><span class="p">,</span>
+<a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a>    <span class="n">refresh_token_endpoint</span><span class="o">=</span><span class="s2">&quot;REFRESH_TOKEN_ENDPOINT&quot;</span><span class="p">,</span>
+<a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a>    <span class="n">revoke_token_endpoint</span><span class="o">=</span><span class="s2">&quot;REVOKE_TOKEN_ENDPOINT&quot;</span><span class="p">,</span>
+<a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="p">)</span>
+</code></pre></div>
+<p>Note that <code>refresh_token_endpoint</code> and <code>revoke_token_endpoint</code> are optional since not every services propose to refresh and revoke tokens.</p>
+<h2 id="generate-an-authorization-url">Generate an authorization URL<a class="headerlink" href="#generate-an-authorization-url" title="Permanent link">&para;</a></h2>
+<p>Use the <a class="autorefs autorefs-internal" href="../reference/httpx_oauth.oauth2/#httpx_oauth.oauth2.BaseOAuth2.get_authorization_url">get_authorization_url</a> method to generate the authorization URL where you should redirect the user to ask for their approval.</p>
+<div class="highlight"><pre><span></span><code><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="n">authorization_url</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">get_authorization_url</span><span class="p">(</span>
+<a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a>    <span class="s2">&quot;https://www.tintagel.bt/oauth-callback&quot;</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;SCOPE1&quot;</span><span class="p">,</span> <span class="s2">&quot;SCOPE2&quot;</span><span class="p">,</span> <span class="s2">&quot;SCOPE3&quot;</span><span class="p">],</span>
+<a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="p">)</span>
+</code></pre></div>
+<h2 id="request-an-access-token">Request an access token<a class="headerlink" href="#request-an-access-token" title="Permanent link">&para;</a></h2>
+<p>Once you have the authorization code, use the <a class="autorefs autorefs-internal" href="../reference/httpx_oauth.oauth2/#httpx_oauth.oauth2.BaseOAuth2.get_access_token">get_access_token</a> method to exchange it with a valid access token.</p>
+<p>It returns an <a class="autorefs autorefs-internal" href="../reference/httpx_oauth.oauth2/#httpx_oauth.oauth2.OAuth2Token">OAuth2Token</a> dictionary-like object.</p>
+<div class="highlight"><pre><span></span><code><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="n">access_token</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">get_access_token</span><span class="p">(</span><span class="s2">&quot;CODE&quot;</span><span class="p">,</span> <span class="s2">&quot;https://www.tintagel.bt/oauth-callback&quot;</span><span class="p">)</span>
+</code></pre></div>
+<h2 id="refresh-an-access-token">Refresh an access token<a class="headerlink" href="#refresh-an-access-token" title="Permanent link">&para;</a></h2>
+<p>For providers supporting it, you can ask for a fresh access token given a refresh token. For this, use the <a class="autorefs autorefs-internal" href="../reference/httpx_oauth.oauth2/#httpx_oauth.oauth2.BaseOAuth2.refresh_token">refresh_token</a> method.</p>
+<p>It returns an <a class="autorefs autorefs-internal" href="../reference/httpx_oauth.oauth2/#httpx_oauth.oauth2.OAuth2Token">OAuth2Token</a> dictionary-like object.</p>
+<div class="highlight"><pre><span></span><code><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a><span class="n">access_token</span> <span class="o">=</span> <span class="k">await</span> <span class="n">client</span><span class="o">.</span><span class="n">refresh_token</span><span class="p">(</span><span class="s2">&quot;REFRESH_TOKEN&quot;</span><span class="p">)</span>
+</code></pre></div>
+<h2 id="revoke-an-access-or-refresh-token">Revoke an access or refresh token<a class="headerlink" href="#revoke-an-access-or-refresh-token" title="Permanent link">&para;</a></h2>
+<p>For providers supporting it, you can ask to revoke an access or refresh token. For this, use the <a class="autorefs autorefs-internal" href="../reference/httpx_oauth.oauth2/#httpx_oauth.oauth2.BaseOAuth2.revoke_token">revoke_token</a> method.</p>
+<h2 id="get-authenticated-user-id-and-email">Get authenticated user ID and email<a class="headerlink" href="#get-authenticated-user-id-and-email" title="Permanent link">&para;</a></h2>
+<p>For convenience, we provide a method that'll use a valid access token to query the provider API and get the ID and the email (if available) of the authenticated user. For this, use the <a class="autorefs autorefs-internal" href="../reference/httpx_oauth.oauth2/#httpx_oauth.oauth2.BaseOAuth2.get_id_email">get_id_email</a> method.</p>
+<p>This method is implemented specifically on each provider.</p>
+<h2 id="provided-clients">Provided clients<a class="headerlink" href="#provided-clients" title="Permanent link">&para;</a></h2>
+<p>Out-of-the box, we support lot of popular providers like <a class="autorefs autorefs-internal" href="../reference/httpx_oauth.clients/#httpx_oauth.clients.google">Google</a> or <a class="autorefs autorefs-internal" href="../reference/httpx_oauth.clients/#httpx_oauth.clients.facebook">Facebook</a>, for which we provided dedicated classes with pre-configured endpoints.</p>
+<p class="buttons"><a class="md-button" href="../reference/httpx_oauth.clients/">Clients reference</a></p>
+<h2 id="customize-httpx-client">Customize HTTPX client<a class="headerlink" href="#customize-httpx-client" title="Permanent link">&para;</a></h2>
+<p>By default, requests are made using <a href="https://www.python-httpx.org/api/#asyncclient"><code>httpx.AsyncClient</code></a> with default parameters. If you wish to customize settings, like setting timeout or proxies, you can do this by overloading the <code>get_httpx_client</code> method.</p>
+<div class="highlight"><pre><span></span><code><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a><span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">AsyncContextManager</span>
+<a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a>
+<a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a><span class="kn">import</span> <span class="nn">httpx</span>
+<a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a><span class="kn">from</span> <span class="nn">httpx_oauth.oauth2</span> <span class="kn">import</span> <span class="n">OAuth2</span>
+<a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a>
+<a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a>
+<a id="__codelineno-4-7" name="__codelineno-4-7" href="#__codelineno-4-7"></a><span class="k">class</span> <span class="nc">OAuth2CustomTimeout</span><span class="p">(</span><span class="n">OAuth2</span><span class="p">):</span>
+<a id="__codelineno-4-8" name="__codelineno-4-8" href="#__codelineno-4-8"></a>    <span class="k">def</span> <span class="nf">get_httpx_client</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">AsyncContextManager</span><span class="p">[</span><span class="n">httpx</span><span class="o">.</span><span class="n">AsyncClient</span><span class="p">]:</span>
+<a id="__codelineno-4-9" name="__codelineno-4-9" href="#__codelineno-4-9"></a>        <span class="k">return</span> <span class="n">httpx</span><span class="o">.</span><span class="n">AsyncClient</span><span class="p">(</span><span class="n">timeout</span><span class="o">=</span><span class="mf">10.0</span><span class="p">)</span>  <span class="c1"># Use a default 10s timeout everywhere.</span>
+<a id="__codelineno-4-10" name="__codelineno-4-10" href="#__codelineno-4-10"></a>
+<a id="__codelineno-4-11" name="__codelineno-4-11" href="#__codelineno-4-11"></a>
+<a id="__codelineno-4-12" name="__codelineno-4-12" href="#__codelineno-4-12"></a><span class="n">client</span> <span class="o">=</span> <span class="n">OAuth2CustomTimeout</span><span class="p">(</span>
+<a id="__codelineno-4-13" name="__codelineno-4-13" href="#__codelineno-4-13"></a>    <span class="s2">&quot;CLIENT_ID&quot;</span><span class="p">,</span>
+<a id="__codelineno-4-14" name="__codelineno-4-14" href="#__codelineno-4-14"></a>    <span class="s2">&quot;CLIENT_SECRET&quot;</span><span class="p">,</span>
+<a id="__codelineno-4-15" name="__codelineno-4-15" href="#__codelineno-4-15"></a>    <span class="s2">&quot;AUTHORIZE_ENDPOINT&quot;</span><span class="p">,</span>
+<a id="__codelineno-4-16" name="__codelineno-4-16" href="#__codelineno-4-16"></a>    <span class="s2">&quot;ACCESS_TOKEN_ENDPOINT&quot;</span><span class="p">,</span>
+<a id="__codelineno-4-17" name="__codelineno-4-17" href="#__codelineno-4-17"></a>    <span class="n">refresh_token_endpoint</span><span class="o">=</span><span class="s2">&quot;REFRESH_TOKEN_ENDPOINT&quot;</span><span class="p">,</span>
+<a id="__codelineno-4-18" name="__codelineno-4-18" href="#__codelineno-4-18"></a>    <span class="n">revoke_token_endpoint</span><span class="o">=</span><span class="s2">&quot;REVOKE_TOKEN_ENDPOINT&quot;</span><span class="p">,</span>
+<a id="__codelineno-4-19" name="__codelineno-4-19" href="#__codelineno-4-19"></a><span class="p">)</span>
+</code></pre></div>
+
+
+
+
+
+
+
+
+
+
+
+
+                
+              </article>
+            </div>
+          
+          
+<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
+        </div>
+        
+      </main>
+      
+        <footer class="md-footer">
+  
+  <div class="md-footer-meta md-typeset">
+    <div class="md-footer-meta__inner md-grid">
+      <div class="md-copyright">
+  
+  
+    Made with
+    <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
+      Material for MkDocs
+    </a>
+  
+</div>
+      
+    </div>
+  </div>
+</footer>
+      
+    </div>
+    <div class="md-dialog" data-md-component="dialog">
+      <div class="md-dialog__inner md-typeset"></div>
+    </div>
+    
+    
+    <script id="__config" type="application/json">{"base": "..", "features": ["content.code.copy"], "search": "../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
+    
+    
+      <script src="../assets/javascripts/bundle.fe8b6f2b.min.js"></script>
+      
+    
+  </body>
+</html>
\ No newline at end of file
