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

Shell

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

HTTP

GET https://backend.flashback.tech/node?nodeServices=3 HTTP/1.1
Host: localhost:3000
Accept: application/json

JavaScript

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);
});

Ruby

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)

Python

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

<?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());
 }

 // ...

Java

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());

Go

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	OK	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