RALE icon

RALE API Reference

Distributed consensus engine API

Complete API reference for RALE's distributed consensus engine and cluster management interface.

API Features

Cluster Management

Complete cluster lifecycle management with dynamic node membership.

Consensus API

Raft-based consensus protocol with leader election and log replication.

Database Integration

Seamless PostgreSQL integration with ACID transaction support.

High Performance

Optimized for low-latency consensus operations and high throughput.

API Endpoints

GET/api/v1/cluster/status

Get current cluster status and node information

GET /api/v1/cluster/status
POST/api/v1/cluster/join

Join a new node to the cluster

POST /api/v1/cluster/join {"node_id": "node3", "address": "192.168.1.10:8080"}
DELETE/api/v1/cluster/nodes/{node_id}

Remove a node from the cluster

DELETE /api/v1/cluster/nodes/node3
GET/api/v1/consensus/leader

Get current leader node information

GET /api/v1/consensus/leader
POST/api/v1/consensus/propose

Propose a new consensus value

POST /api/v1/consensus/propose {"value": "configuration_update"}
GET/api/v1/logs/{node_id}

Get consensus log entries for a specific node

GET /api/v1/logs/node1

Consensus Operations

Leader Election

Automatic leader election when the current leader fails or becomes unavailable.

GET /api/v1/consensus/leader

Log Replication

Replicate consensus decisions across all cluster nodes for consistency.

POST /api/v1/consensus/propose

State Synchronization

Synchronize cluster state across all nodes to maintain consistency.

GET /api/v1/cluster/status

Node Membership

Dynamic addition and removal of nodes from the cluster.

POST /api/v1/cluster/join

PostgreSQL Integration

RALE seamlessly integrates with PostgreSQL to provide persistent storage and ACID transaction support for consensus operations.

Database Features

Consensus Storage

  • • Log entry persistence
  • • State snapshots
  • • Node membership records
  • • Configuration storage

Transaction Support

  • • ACID compliance
  • • Multi-node coordination
  • • Rollback capabilities
  • • Consistency guarantees