راهنمای API

Authorization: Bearer <api_key>

authorization: Bearer <api_key>

https://your-node-address:port/

Content-Type: application/x-protobuf

message Backend {
  BackendType type;      // نوع بکند (XRAY = 0)
  string config;         // پیکربندی بکند
  repeated User users;   // لیست کاربران
  uint64 keepAlive;      // مدت زمان keep alive به ثانیه
}

message User {
  string email;           // شناسه یکتای ایمیل کاربر
  Proxy proxies;          // پیکربندی‌های پروکسی
  repeated string inbounds; // لیست تگ‌های ورودی
}

message StatRequest {
  string name;      // ایمیل کاربر یا تگ ورودی/خروجی
  bool reset;       // بازنشانی آمار ترافیک پس از بازیابی
  StatType type;    // نوع آمار برای بازیابی
}

enum StatType {
  Outbounds = 0;   // تمام آمار خروجی
  Outbound = 1;    // آمار خروجی تکی
  Inbounds = 2;    // تمام آمار ورودی
  Inbound = 3;     // آمار ورودی تکی
  UsersStat = 4;   // تمام آمار کاربران
  UserStat = 5;    // آمار کاربر تکی
}

message BaseInfoResponse {
  string version;
  string core_type;
  bool running;
}

message Log {
  string detail;  // Log message
}

message SystemStatsResponse {
  uint64 mem_total;                  // Total memory
  uint64 mem_used;                   // Used memory
  uint64 cpu_cores;                  // CPU cores
  double cpu_usage;                  // CPU usage %
  uint64 incoming_bandwidth_speed;   // Download speed
  uint64 outgoing_bandwidth_speed;   // Upload speed
}

message BackendStatsResponse {
  uint32 num_goroutine;    // Active goroutines
  uint32 num_gc;           // GC runs
  uint64 alloc;            // Allocated memory
  uint64 total_alloc;      // Total allocated
  uint64 sys;              // System memory
  uint64 mallocs;          // Malloc count
  uint64 frees;            // Free count
  uint64 live_objects;     // Live objects
  uint64 pause_total_ns;   // Total GC pause
  uint32 uptime;           // Uptime in seconds
}

StatRequest {
  type: UsersStat,
  reset: false
}

StatRequest {
  name: "user@example.com",
  type: UserStat,
  reset: true  // Reset after retrieval
}

message StatResponse {
  repeated Stat stats;
}

message Stat {
  string name;   // User email or tag
  string type;   // Stat type
  string link;   // Link identifier
  int64 value;   // Traffic value in bytes
}

message OnlineStatResponse {
  string name;   // User email
  int64 value;   // Online connection count
}

{
  "error": "Error description",
  "code": "ERROR_CODE"
}