/api/raida/version

GET

Query software version information from all 25 RAIDA servers. Returns version dates in human-readable format and identifies any version mismatches across the network.

http://localhost:8080/api/raida/version

Description

The `/api/raida/version` endpoint queries all 25 RAIDA servers to retrieve their current software versions. Version information is returned in YYYYMMDD format and automatically converted to human-readable dates (e.g., "2024-March-15").

💡 Version Consistency

In a healthy CloudCoin network, all RAIDAs should run the same software version. Version mismatches may indicate:

  • Ongoing rolling updates across the network
  • Individual RAIDAs behind on updates
  • Potential compatibility issues

Parameters

This endpoint requires no parameters.

Response

Success Response Properties

command string
Always "raida_version".
pass_count integer
Number of RAIDAs that returned valid version information.
raida_versions array
Array of 25 objects containing version information for each RAIDA.

Success Response Example

{
  "command": "raida_version",
  "success": true,
  "task_id": "Nov-21-25_01-23-45-PM-c3d4",
  "pass_count": 24,
  "raida_versions": [
    {
      "raida_id": 0,
      "status": "success",
      "version": "2024-March-15"
    }
  ]
}

Examples

cURL

curl "http://localhost:8080/api/raida/version"

JavaScript (fetch)

const response = await fetch('http://localhost:8080/api/raida/version');
const result = await response.json();
console.log(result);

Use Cases

  • Version Verification: Confirm all RAIDAs are running expected software version
  • Update Monitoring: Track rolling updates across the RAIDA network
  • Compatibility Checking: Verify version compatibility before performing operations