get__node

GET /node

List Nodes

Get all available Flashgate nodes. Returns a structured response with success status, data array, and total count.

Query Parameters

Name

Type

Required

Description

nodeServices

number

yes

Filters nodes by service flag using a bitwise AND operation. If 0, all nodes are returned.

Service Flags (BridgeTypes.ServiceFlag)

The nodeServices parameter uses a bitwise flag mode to filter nodes based on their capabilities. The available flags defined in the enum are:

SERVICE_FLAG_NONE = 0 (Returns all nodes)
SERVICE_FLAG_STORAGE = 1
SERVICE_FLAG_AILLM = 2
SERVICE_FLAG_CHAT = 4

To query for multiple services at once, combine them using the bitwise OR (|) operator.

Example: For example, if you want to list all storage and aillm nodes, you must pass: ?nodeServices=BridgeTypes.ServiceFlag.SERVICE_FLAG_STORAGE | SERVICE_FLAG_AILLM (Note: In raw HTTP requests, this evaluates to the integer 3)

TypeScript Client Library

// Using the Flashgate TypeScript client
import { FlashgateClient, BridgeTypes } from '@flashgate/client';

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

// Get all storage and AI LLM nodes
try {
  const result = await client.nodes.list({
    nodeServices: BridgeTypes.ServiceFlag.SERVICE_FLAG_STORAGE | BridgeTypes.ServiceFlag.SERVICE_FLAG_AILLM
  });
  console.log('Available nodes:', result);
} catch (error) {
  console.error('Failed to retrieve nodes:', error);
}

Code Samples

# You can also use wget
curl -X GET https://backend.flashback.tech/node?nodeServices=3 \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

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

fetch('https://backend.flashback.tech/node?nodeServices=3',
{
  method: 'GET',
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

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

result = RestClient.get 'https://backend.flashback.tech/node?nodeServices=3',
  params: {
  }, headers: headers

p JSON.parse(result)

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

r = requests.get('https://backend.flashback.tech/node?nodeServices=3', headers = headers)

print(r.json())

<?php

require 'vendor/autoload.php';

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

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','https://backend.flashback.tech/node?nodeServices=3', 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());
 }

 // ...

URL obj = new URL("https://backend.flashback.tech/node?nodeServices=3");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("GET");
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());

package main

import (
       "bytes"
       "net/http"
)

func main() {

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

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "https://backend.flashback.tech/node?nodeServices=3", data)
    req.Header = headers

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

Example responses

200 Response

{
  "success": true,
  "data": [
    {
      "nodeServices": 3,
      "url": "string",
      "ip": "string",
      "region": "string",
      "version": "string",
      "status": "string",
      "lastUpdated": "2019-08-24T14:15:22Z"
    }
  ],
  "total": 1
}

Responses

Status

Meaning

Description

Schema

200

Nodes retrieved successfully

Inline

Response Schema

Status Code 200

Name

Type

Required

Restrictions

Description

» success

boolean

false

none

Indicates if the request was successful

» data

[NodeInfo]

false

none

Array of available nodes

» total

number

false

none

Total number of nodes returned

NodeInfo Object

Name

Type

Required

Restrictions

Description

» nodeServices

number

false

none

Service capability flags of the node

» url

string

false

none

Endpoint URL of the node

» ip

string

false

none

IP address of the node

» region

string

false

none

Geographic region of the node

» version

string

false

none

Version of the node software

» status

string

false

none

Current status of the node

» lastUpdated

string(date-time)

false

none

Last update timestamp

PreviousBridge Node Status Nextget__stats_nodes_minute

Last updated 2 days ago

Was this helpful?