مستندات جامع API پنل مدیریت OpenVPN

curl -X GET "https://your-panel-domain.com/api/v1/status" \
  -H "Content-Type: application/json"

{
  "status": "success",
  "message": "Service is running",
  "timestamp": "2024-01-15T10:30:00Z",
  "version": "1.0.0"
}

curl -X POST "https://your-panel-domain.com/api/v1/users" \
  -H "X-API-KEY: YOUR_ADMIN_OR_SUB_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "user123",
    "max_clients": 2,
    "data_limit": 50,
    "data_limit_unit": "GB",
    "notes": "User for testing API",
    "nodes": [1, 3],
    "activation_type": "fixed_date",
    "expiry_date_str": "2024-12-31"
  }'

curl -X POST "https://your-panel-domain.com/api/v1/users" \
  -H "X-API-KEY: YOUR_ADMIN_OR_SUB_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "bulk_count": 5,
    "max_clients": 1,
    "data_limit": 10,
    "data_limit_unit": "GB",
    "nodes": [1],
    "activation_type": "flexible_days",
    "pending_activation_days": 30
  }'

{
  "status": "success",
  "message": "User(s) created successfully",
  "data": {
    "users": [
      {
        "username": "user123",
        "password": "generated_password",
        "config_url": "https://your-panel-domain.com/sub/user123",
        "expiry_date": "2024-12-31"
      }
    ]
  }
}

curl -X GET "https://your-panel-domain.com/api/v1/users/user123" \
  -H "X-API-KEY: YOUR_ADMIN_OR_SUB_KEY" \
  -H "Content-Type: application/json"

{
  "status": "success",
  "data": {
    "username": "user123",
    "status": "active",
    "max_clients": 2,
    "data_limit": 53687091200,
    "data_used": 1073741824,
    "data_limit_unit": "GB",
    "expiry_date": "2024-12-31",
    "activation_type": "fixed_date",
    "nodes": [1, 3],
    "notes": "User for testing API",
    "created_at": "2024-01-15T10:30:00Z",
    "online": false
  }
}

curl -X PUT "https://your-panel-domain.com/api/v1/users/user123" \
  -H "X-API-KEY: YOUR_ADMIN_OR_SUB_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "max_clients": 5,
    "data_limit": 200,
    "data_limit_unit": "GB",
    "notes": "Updated user limits",
    "nodes": [1, 2],
    "activation_type": "flexible_days",
    "pending_activation_days": 60,
    "reset_activation": true
  }'

{
  "status": "success",
  "message": "User updated successfully",
  "data": {
    "username": "user123",
    "changes": {
      "max_clients": 5,
      "data_limit": 214748364800,
      "activation_type": "flexible_days",
      "pending_activation_days": 60
    }
  }
}

curl -X POST "https://your-panel-domain.com/api/v1/users/user123/toggle" \
  -H "X-API-KEY: YOUR_ADMIN_OR_SUB_KEY" \
  -H "Content-Type: application/json"

{
  "status": "success",
  "message": "User disabled successfully",
  "data": {
    "username": "user123",
    "new_status": "disabled"
  }
}

curl -X DELETE "https://your-panel-domain.com/api/v1/users/user123" \
  -H "X-API-KEY: YOUR_ADMIN_OR_SUB_KEY" \
  -H "Content-Type: application/json"

{
  "status": "success",
  "message": "User deleted successfully",
  "data": {
    "username": "user123"
  }
}

curl -X POST "https://your-panel-domain.com/api/v1/users/user123/reset_traffic" \
  -H "X-API-KEY: YOUR_ADMIN_OR_SUB_KEY" \
  -H "Content-Type: application/json"

{
  "status": "success",
  "message": "User traffic reset successfully",
  "data": {
    "username": "user123",
    "previous_usage": 1073741824,
    "new_usage": 0
  }
}

curl -X GET "https://your-panel-domain.com/api/v1/users/user123/sub" \
  -H "X-API-KEY: YOUR_ADMIN_OR_SUB_KEY" \
  -H "Content-Type: application/json"

{
  "status": "success",
  "data": {
    "username": "user123",
    "subscription_url": "https://your-panel-domain.com/sub/user123",
    "qr_code_url": "https://your-panel-domain.com/sub/user123/qr"
  }
}

curl -X GET "https://your-panel-domain.com/api/v1/users/list_all" \
  -H "X-API-KEY: YOUR_ADMIN_OR_SUB_KEY" \
  -H "Content-Type: application/json"

{
  "status": "success",
  "data": {
    "users": [
      {
        "username": "user123",
        "status": "active",
        "max_clients": 2,
        "data_used": 1073741824,
        "data_limit": 53687091200,
        "expiry_date": "2024-12-31",
        "online": false,
        "sub_admin": "main",
        "created_at": "2024-01-15T10:30:00Z"
      },
      {
        "username": "user456",
        "status": "disabled",
        "max_clients": 1,
        "data_used": 0,
        "data_limit": null,
        "expiry_date": null,
        "online": true,
        "sub_admin": "reseller1",
        "created_at": "2024-01-14T15:45:00Z"
      }
    ],
    "total_count": 2,
    "active_count": 1,
    "online_count": 1
  }
}

curl -X GET "https://your-panel-domain.com/api/v1/users/user123/all_ovpn_links" \
  -H "X-API-KEY: YOUR_ADMIN_OR_SUB_KEY" \
  -H "Content-Type: application/json"

{
  "status": "success",
  "data": {
    "username": "user123",
    "configs": [
      {
        "name": "Single Server - Node 1",
        "download_url": "https://your-panel-domain.com/download/user123/node1.ovpn",
        "server": "node1.your-domain.com:1194",
        "protocol": "udp"
      },
      {
        "name": "Multi-Server Config",
        "download_url": "https://your-panel-domain.com/download/user123/multi.ovpn",
        "servers": [
          "node1.your-domain.com:1194",
          "node2.your-domain.com:1194"
        ],
        "protocol": "udp"
      }
    ]
  }
}

curl -X GET "https://your-panel-domain.com/api/v1/nodes" \
  -H "X-API-KEY: YOUR_MAIN_ADMIN_KEY" \
  -H "Content-Type: application/json"

{
  "status": "success",
  "data": {
    "nodes": [
      {
        "id": 1,
        "name": "Main Server",
        "ip_address": "192.168.1.100",
        "status": "online",
        "openvpn_port": "1194",
        "protocol": "udp",
        "user_count": 15,
        "online_users": 3,
        "last_sync": "2024-01-15T10:25:00Z"
      },
      {
        "id": 2,
        "name": "USA Node",
        "ip_address": "192.168.1.101",
        "status": "online",
        "openvpn_port": "1194",
        "protocol": "udp",
        "user_count": 8,
        "online_users": 2,
        "last_sync": "2024-01-15T10:28:00Z"
      }
    ]
  }
}

curl -X GET "https://your-panel-domain.com/api/v1/nodes/1" \
  -H "X-API-KEY: YOUR_MAIN_ADMIN_KEY" \
  -H "Content-Type: application/json"

{
  "status": "success",
  "data": {
    "id": 1,
    "name": "Main Server",
    "ip_address": "192.168.1.100",
    "status": "online",
    "openvpn_port": "1194",
    "protocol": "udp",
    "user_count": 15,
    "online_users": 3,
    "last_sync": "2024-01-15T10:25:00Z",
    "created_at": "2024-01-10T08:00:00Z",
    "ssh_status": "connected"
  }
}

curl -X POST "https://your-panel-domain.com/api/v1/nodes" \
  -H "X-API-KEY: YOUR_MAIN_ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "New Node USA",
    "ip_address": "192.168.1.100",
    "ssh_password": "secure_ssh_password_123",
    "openvpn_port": "1194",
    "protocol": "udp",
    "sync_all_users": true,
    "show_main_config": false
  }'

{
  "status": "accepted",
  "message": "Node creation process started",
  "data": {
    "node_id": 3,
    "name": "New Node USA",
    "installation_status": "in_progress",
    "estimated_completion_time": "5 minutes"
  }
}

curl -X PUT "https://your-panel-domain.com/api/v1/nodes/1" \
  -H "X-API-KEY: YOUR_MAIN_ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Node USA",
    "ip_address": "192.168.1.101",
    "ssh_password": "new_secure_password",
    "openvpn_port": "1195",
    "protocol": "tcp"
  }'

{
  "status": "success",
  "message": "Node updated successfully",
  "data": {
    "node_id": 1,
    "changes": {
      "name": "Updated Node USA",
      "ip_address": "192.168.1.101",
      "openvpn_port": "1195",
      "protocol": "tcp"
    }
  }
}

curl -X DELETE "https://your-panel-domain.com/api/v1/nodes/1" \
  -H "X-API-KEY: YOUR_MAIN_ADMIN_KEY" \
  -H "Content-Type: application/json"

{
  "status": "success",
  "message": "Node deleted successfully",
  "data": {
    "node_id": 1,
    "name": "Updated Node USA"
  }
}

curl -X GET "https://your-panel-domain.com/api/v1/public/servers_for_ports" \
  -H "X-API-KEY: YOUR_MAIN_ADMIN_KEY" \
  -H "Content-Type: application/json"

{
  "status": "success",
  "data": {
    "servers": [
      {
        "id": "main",
        "name": "Main Server",
        "ip_address": "192.168.1.100",
        "type": "main"
      },
      {
        "id": "node_1",
        "name": "USA Node",
        "ip_address": "192.168.1.101",
        "type": "node"
      },
      {
        "id": "node_2",
        "name": "Europe Node",
        "ip_address": "192.168.1.102",
        "type": "node"
      }
    ]
  }
}

curl -X GET "https://your-panel-domain.com/api/v1/public/ports" \
  -H "X-API-KEY: YOUR_MAIN_ADMIN_KEY" \
  -H "Content-Type: application/json"

{
  "status": "success",
  "data": {
    "default_ports": [
      {
        "port": 1194,
        "protocol": "udp",
        "servers": ["main", "node_1", "node_2"]
      }
    ],
    "custom_ports": [
      {
        "id": 5,
        "port": 8080,
        "protocol": "tcp",
        "servers": ["main", "node_1"],
        "created_at": "2024-01-15T09:00:00Z"
      },
      {
        "id": 6,
        "port": 8081,
        "protocol": "udp",
        "servers": ["node_2"],
        "created_at": "2024-01-15T09:15:00Z"
      }
    ]
  }
}

curl -X POST "https://your-panel-domain.com/api/v1/public/ports" \
  -H "X-API-KEY: YOUR_MAIN_ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "public_port": 8080,
    "protocol": "tcp",
    "server_ids": ["main", "node_1", "node_2"]
  }'

{
  "status": "success",
  "message": "Port added successfully to specified servers",
  "data": {
    "port_id": 7,
    "port": 8080,
    "protocol": "tcp",
    "servers": ["main", "node_1", "node_2"],
    "installation_status": "in_progress"
  }
}

curl -X DELETE "https://your-panel-domain.com/api/v1/public/ports/assignment" \
  -H "X-API-KEY: YOUR_MAIN_ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "port_id": 5,
    "server_identifier": "node_1"
  }'

{
  "status": "success",
  "message": "Port assignment removed successfully",
  "data": {
    "port_id": 5,
    "server": "node_1",
    "removed_services": ["haproxy", "firewall_rules"]
  }
}

curl -X GET "https://your-panel-domain.com/api/v1/sub_admins" \
  -H "X-API-KEY: YOUR_MAIN_ADMIN_KEY" \
  -H "Content-Type: application/json"

{
  "status": "success",
  "data": {
    "sub_admins": [
      {
        "id": 1,
        "username": "reseller1",
        "is_active": true,
        "max_users_limit": 100,
        "current_users": 25,
        "total_usage_quota_gb": 500,
        "current_usage_gb": 125.5,
        "expiry_date": "2024-12-31",
        "allowed_servers": ["node_1", "node_2"],
        "created_at": "2024-01-01T00:00:00Z"
      }
    ]
  }
}

curl -X GET "https://your-panel-domain.com/api/v1/sub_admins/1" \
  -H "X-API-KEY: YOUR_MAIN_ADMIN_KEY" \
  -H "Content-Type: application/json"

{
  "status": "success",
  "data": {
    "id": 1,
    "username": "reseller1",
    "is_active": true,
    "max_users_limit": 100,
    "current_users": 25,
    "total_usage_quota_gb": 500,
    "current_usage_gb": 125.5,
    "expiry_date": "2024-12-31",
    "allowed_servers": ["node_1", "node_2"],
    "notes": "Reseller for USA region",
    "created_at": "2024-01-01T00:00:00Z",
    "last_login": "2024-01-15T09:30:00Z"
  }
}

curl -X POST "https://your-panel-domain.com/api/v1/sub_admins" \
  -H "X-API-KEY: YOUR_MAIN_ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "subadmin1",
    "password": "secure_password_123",
    "is_active": true,
    "max_users_limit": 100,
    "total_usage_quota_gb": 500,
    "expiry_date": "2024-12-31",
    "allowed_servers": ["node_1", "node_2"],
    "notes": "Sub-admin for reseller program"
  }'

{
  "status": "success",
  "message": "Sub-admin created successfully",
  "data": {
    "id": 2,
    "username": "subadmin1",
    "api_key": "generated_api_key_here",
    "created_at": "2024-01-15T11:00:00Z"
  }
}

curl -X PUT "https://your-panel-domain.com/api/v1/sub_admins/5" \
  -H "X-API-KEY: YOUR_MAIN_ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "updated_subadmin",
    "password": "new_secure_password",
    "is_active": false,
    "max_users_limit": 150,
    "total_usage_quota_gb": 750,
    "expiry_date": "2025-06-30",
    "allowed_servers": ["node_1", "node_2", "node_3"],
    "notes": "Updated sub-admin details"
  }'

{
  "status": "success",
  "message": "Sub-admin updated successfully",
  "data": {
    "id": 5,
    "username": "updated_subadmin",
    "changes": {
      "is_active": false,
      "max_users_limit": 150,
      "total_usage_quota_gb": 750,
      "expiry_date": "2025-06-30"
    }
  }
}

curl -X DELETE "https://your-panel-domain.com/api/v1/sub_admins/5" \
  -H "X-API-KEY: YOUR_MAIN_ADMIN_KEY" \
  -H "Content-Type: application/json"

{
  "status": "success",
  "message": "Sub-admin deleted successfully",
  "data": {
    "id": 5,
    "username": "updated_subadmin"
  }
}

curl -X POST "https://your-panel-domain.com/api/v1/sub_admins/5/reset_usage" \
  -H "X-API-KEY: YOUR_MAIN_ADMIN_KEY" \
  -H "Content-Type: application/json"

{
  "status": "success",
  "message": "Sub-admin usage reset successfully",
  "data": {
    "id": 5,
    "username": "updated_subadmin",
    "previous_usage_gb": 450.75,
    "new_usage_gb": 0
  }
}