Nitrado API日志下载教程：避免404错误的正确姿势

import requests
import os

def download_nitrado_logs(server_id, username, password, game_log_path="/games/dayz/log", local_save_dir="nitrado_logs"):
    """
    从Nitrado服务器下载指定游戏路径下的所有日志文件。

    Args:
        server_id (str): 你的Nitrado服务器ID。
        username (str): 你的Nitrado账户用户名。
        password (str): 你的Nitrado账户密码。
        game_log_path (str): 服务器上日志文件的路径，例如 "/games/dayz/log"。
        local_save_dir (str): 本地保存日志文件的目录名称。
    """

    base_api_url = f"https://api.nitrado.net/services/{server_id}/gameservers/file_server"
    auth = (username, password)

    # 确保本地保存目录存在
    os.makedirs(local_save_dir, exist_ok=True)

    print(f"正在尝试从服务器路径 '{game_log_path}' 获取日志文件列表...")

    try:
        # 步骤1: 使用 'list' 端点获取日志文件列表
        list_endpoint_url = f"{base_api_url}/list"
        list_params = {"path": game_log_path}

        list_response = requests.get(list_endpoint_url, params=list_params, auth=auth)
        list_response.raise_for_status() # 如果响应状态码是 4xx 或 5xx，则抛出 HTTPError

        file_list_data = list_response.json()

        # 假设API响应结构为 {'data': {'files': [...]}}
        # 根据实际API文档调整解析逻辑
        if 'data' not in file_list_data or 'files' not in file_list_data['data']:
            print(f"API响应结构异常，无法解析文件列表: {file_list_data}")
            return

        log_files_to_download = []
        for item in file_list_data['data']['files']:
            if item['type'] == 'file': # 只处理文件，跳过目录
                log_files_to_download.append(item['path']) # 使用API返回的完整文件路径

        if not log_files_to_download:
            print(f"在路径 '{game_log_path}' 中未找到任何日志文件。")
            return

        print(f"找到以下日志文件（共 {len(log_files_to_download)} 个）：")
        for f_path in log_files_to_download:
            print(f"- {os.path.basename(f_path)}")

        # 步骤2: 遍历列表，使用 'download' 端点下载每个日志文件
        download_endpoint_url = f"{base_api_url}/download"
        downloaded_count = 0

        for log_file_full_path in log_files_to_download:
            file_name = os.path.basename(log_file_full_path) # 获取文件名用于本地保存
            local_file_path = os.path.join(local_save_dir, file_name)

            print(f"正在下载 '{file_name}' 到 '{local_file_path}'...")

            download_params = {"path": log_file_full_path}
            # 使用 stream=True 处理大文件，分块写入
            download_response = requests.get(download_endpoint_url, params=download_params, auth=auth, stream=True)
            download_response.raise_for_status()

            with open(local_file_path, 'wb') as f:
                for chunk in download_response.iter_content(chunk_size=8192):
                    if chunk: # 过滤掉保持连接的空数据块
                        f.write(chunk)
            print(f"成功下载：{file_name}")
            downloaded_count += 1

        print(f"\n所有日志文件下载完成。共下载 {downloaded_count} 个文件。")

    except requests.exceptions.HTTPError as e:
        print(f"HTTP错误发生: {e}")
        if e.response is not None:
            print(f"响应状态码: {e.response.status_code}")
            print(f"响应内容: {e.response.text}")
    except requests.exceptions.RequestException as e:
        print(f"请求错误发生 (例如网络连接问题): {e}")
    except KeyError as e:
        print(f"API响应结构异常，无法解析文件列表或数据: {e}")
        if 'list_response' in locals() and list_response is not None:
            print(f"原始列表响应: {list_response.text}")
    except Exception as e:
        print(f"发生未知错误: {e}")


# --- 配置你的Nitrado服务器信息 ---
# 替换为你的实际服务器ID、Nitrado账户用户名和密码
SERVER_ID = "YOUR_SERVER_ID"  
USERNAME = "YOUR_NITRADO_USERNAME"  
PASSWORD = "YOUR_NITRADO_PASSWORD"  

# 调用函数开始下载日志
if __name__ == "__main__":
    # 示例：下载DayZ服务器的日志
    download_nitrado_logs(SERVER_ID, USERNAME, PASSWORD, game_log_path="/games/dayz/log")

    # 如果你需要下载其他游戏的日志，只需修改 game_log_path 参数
    # 例如：download_nitrado_logs(SERVER_ID, USERNAME, PASSWORD, game_log_path="/games/minecraft/logs")