Refresh a session
curl --request POST \
--url https://sandbox.api.btdx.io/sessions/refresh \
--header 'authorization: <authorization>'import requests
url = "https://sandbox.api.btdx.io/sessions/refresh"
headers = {"authorization": "<authorization>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {authorization: '<authorization>'}};
fetch('https://sandbox.api.btdx.io/sessions/refresh', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://sandbox.api.btdx.io/sessions/refresh",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://sandbox.api.btdx.io/sessions/refresh"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://sandbox.api.btdx.io/sessions/refresh")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.api.btdx.io/sessions/refresh")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"_meta": {
"_primary_document": "sessions",
"_count": 1
},
"sessions": [
{
"accessToken": "eyJ0eXAiOiJh....bBDA",
"refreshToken": "eyJ0eXAiOiJy....uHCQ",
"accessExpiresAt": "2099-01-01T23:59:59.999Z",
"refreshExpiresAt": "2099-01-01T23:59:59.999Z"
}
]
}{
"title": "Unauthorized",
"details": [
null
]
}Session Management
Refresh a session
Refresh an existing session using the refresh token. If a session’s access token has expired but the refresh token is still valid, the existing session can be refreshed. New access and refresh tokens will be returned.
The refresh token should be used in place of the access token in the authorization header for Bearer authentication.
This is a faster operation than creating a new session and refreshing should be preferred to creating new sessions where possible.
POST
/
sessions
/
refresh
Refresh a session
curl --request POST \
--url https://sandbox.api.btdx.io/sessions/refresh \
--header 'authorization: <authorization>'import requests
url = "https://sandbox.api.btdx.io/sessions/refresh"
headers = {"authorization": "<authorization>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {authorization: '<authorization>'}};
fetch('https://sandbox.api.btdx.io/sessions/refresh', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://sandbox.api.btdx.io/sessions/refresh",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://sandbox.api.btdx.io/sessions/refresh"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://sandbox.api.btdx.io/sessions/refresh")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.api.btdx.io/sessions/refresh")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"_meta": {
"_primary_document": "sessions",
"_count": 1
},
"sessions": [
{
"accessToken": "eyJ0eXAiOiJh....bBDA",
"refreshToken": "eyJ0eXAiOiJy....uHCQ",
"accessExpiresAt": "2099-01-01T23:59:59.999Z",
"refreshExpiresAt": "2099-01-01T23:59:59.999Z"
}
]
}{
"title": "Unauthorized",
"details": [
null
]
}