post__devices_trust

POST /devices/trust

Trust Device

Mark a device as trusted using its fingerprint. This will extend the device's trust period and allow it to access the system with reduced security prompts.

Request Body

Name	Type	Required	Restrictions	Description
fingerprint	string	true	none	Device fingerprint hash

TypeScript Client Library

// Using the Flashback TypeScript client
import { FlashbackClient } from '@flashback/client';

const client = new FlashbackClient({
  accessToken: 'your-access-token'
});

// Trust a device
try {
  const result = await client.devices.trust({
    fingerprint: 'device-fingerprint-hash'
  });
  console.log('Device trusted:', result);
} catch (error) {
  console.error('Failed to trust device:', error);
}

Code Samples

Shell

# You can also use wget
curl -X POST https://backend.flashback.tech/devices/trust \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}' \
  -H 'Content-Type: application/json' \
  -d '{
  "fingerprint": "string"
}'

HTTP

POST https://backend.flashback.tech/devices/trust HTTP/1.1
Host: localhost:3000
Accept: application/json
Content-Type: application/json
Authorization: Bearer {access-token}

{
  "fingerprint": "string"
}

JavaScript

const headers = {
  'Accept':'application/json',
  'Authorization':'Bearer {access-token}',
  'Content-Type':'application/json'
};

const body = {
  "fingerprint": "string"
};

fetch('https://backend.flashback.tech/devices/trust',
{
  method: 'POST',
  headers: headers,
  body: JSON.stringify(body)
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

Ruby

require 'rest-client'
require 'json'

headers = {
  'Accept' => 'application/json',
  'Authorization' => 'Bearer {access-token}',
  'Content-Type' => 'application/json'
}

result = RestClient.post 'https://backend.flashback.tech/devices/trust',
  {
    'fingerprint' => 'string'
  }.to_json, headers

p JSON.parse(result)

Python

import requests
headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}',
  'Content-Type': 'application/json'
}

r = requests.post('https://backend.flashback.tech/devices/trust', 
  headers = headers,
  json = {
    'fingerprint': 'string'
  })

print(r.json())

PHP

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'Bearer {access-token}',
    'Content-Type' => 'application/json',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array(
    'fingerprint' => 'string'
);

try {
    $response = $client->request('POST','https://backend.flashback.tech/devices/trust', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...

Java

URL obj = new URL("https://backend.flashback.tech/devices/trust");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("POST");
con.setRequestProperty("Content-Type", "application/json");
con.setRequestProperty("Accept", "application/json");
con.setRequestProperty("Authorization", "Bearer {access-token}");
con.setDoOutput(true);

String jsonInputString = "{\"fingerprint\":\"string\"}";

try(OutputStream os = con.getOutputStream()) {
    byte[] input = jsonInputString.getBytes("utf-8");
    os.write(input, 0, input.length);
}

int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

Go

package main

import (
       "bytes"
       "net/http"
       "encoding/json"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Authorization": []string{"Bearer {access-token}"},
        "Content-Type": []string{"application/json"},
    }

    data := map[string]string{
        "fingerprint": "string",
    }
    jsonData, _ := json.Marshal(data)

    req, err := http.NewRequest("POST", "https://backend.flashback.tech/devices/trust", bytes.NewBuffer(jsonData))
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

Example responses

200 Response

{
  "success": true,
  "message": "Device trusted successfully",
  "trustExpiresAt": "2019-08-24T14:15:22Z"
}

404 Response

{
  "success": false,
  "error": "Device not found"
}

500 Response

{
  "success": false,
  "error": "Failed to trust device"
}

Responses

Status	Meaning	Description	Schema
200	OK	Device trusted successfully	Inline
404	Not Found	Device not found	Inline
500	Internal Server Error	Server error	Inline

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
» success	boolean	false	none	Operation success status
» message	string	false	none	Success message
» trustExpiresAt	string(date-time)	false	none	When device trust expires

Status Code 404

Name	Type	Required	Restrictions	Description
» success	boolean	false	none	Operation success status
» error	string	false	none	Error message

Status Code 500

Name	Type	Required	Restrictions	Description
» success	boolean	false	none	Operation success status
» error	string	false	none	Error message

To perform this operation, you must be authenticated by means of one of the following methods: BearerAuth