仅靠用户名密码能否用Python调用SharePoint REST API下载文件？

我没有SharePoint使用经验，需要用Python从SharePoint服务器下载文件。目前有两个指向同一文件的URL：

https://connect.[our-partner].com/sites/ftp/[i think an FTP site name]/[path-to-file]

and

https://connect.[our-partner].com/sites/ftp/_api/Web/GetFileByServerRelativePath(decodedurl='/sites/ftp/[i think an FTP site name]/[path-to-file]')

我的首选方案是通过REST方式下载，若无法实现，FTP方式也可接受。但我仅有用户名和密码，想了解是否仅靠这些凭证无法完成操作，是否需要其他类型的凭证？我实在不想通过Selenium登录来下载文件。

一、REST方式下载（优先推荐） #

凭证说明 #

仅用户名和密码通常足够，具体取决于对方SharePoint的认证方式：

• 若是NTLM认证（企业内部SharePoint常见配置），直接用用户名密码就能通过验证；
• 若是OAuth2/SAML这类现代认证，可能需要额外的应用注册信息（如客户端ID、租户ID），但普通用户的下载权限一般不需要，用用户名密码的NTLM或基本认证就能搞定。

Python代码示例 #

需要先安装依赖库：pip install requests requests_ntlm

import requests
from requests_ntlm import HttpNtlmAuth

# 替换为实际信息
rest_url = "https://connect.[our-partner].com/sites/ftp/_api/Web/GetFileByServerRelativePath(decodedurl='/sites/ftp/[i think an FTP site name]/[path-to-file]')/$value"
username = "你的用户名"
password = "你的密码"

# 发起请求并保存文件
response = requests.get(rest_url, auth=HttpNtlmAuth(username, password), verify=False)
# 注意：verify=False用于跳过SSL验证，生产环境建议配置正确证书路径
if response.status_code == 200:
    with open("本地保存的文件名.ext", "wb") as f:
        f.write(response.content)
    print("文件下载成功")
else:
    print(f"下载失败，状态码：{response.status_code}")

关键提示：REST URL必须加上/$value后缀，否则只会返回文件元数据，而非实际文件内容。

二、FTP方式下载 #

凭证说明 #

如果这个SharePoint的ftp路径确实映射了FTP服务，用户名密码通常可直接使用，但需确认：

• 对方是否开启FTP服务，且支持用户名密码登录；
• 实际服务是普通FTP还是SFTP，两者端口和协议不同（FTP默认21，SFTP默认22）。

Python代码示例 #

普通FTP（用标准库）

from ftplib import FTP

ftp_host = "connect.[our-partner].com"
username = "你的用户名"
password = "你的密码"
remote_path = "/sites/ftp/[i think an FTP site name]/[path-to-file]"
local_filename = "本地保存的文件名.ext"

with FTP(ftp_host) as ftp:
    ftp.login(username, password)
    with open(local_filename, "wb") as f:
        ftp.retrbinary(f"RETR {remote_path}", f.write)
    print("文件下载成功")

SFTP（用paramiko库，需先安装：pip install paramiko）

import paramiko

sftp_host = "connect.[our-partner].com"
username = "你的用户名"
password = "你的密码"
remote_path = "/sites/ftp/[i think an FTP site name]/[path-to-file]"
local_filename = "本地保存的文件名.ext"

with paramiko.SSHClient() as ssh:
    ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())
    ssh.connect(sftp_host, username=username, password=password)
    with ssh.open_sftp() as sftp:
        sftp.get(remote_path, local_filename)
    print("文件下载成功")

三、常见问题排查 #

• 若REST请求返回401，说明认证失败，可尝试把HttpNtlmAuth换成HTTPBasicAuth（从requests.auth导入），或检查用户名密码是否正确；
• 若FTP/SFTP连接失败，先确认端口是否正确，再排查对方是否限制了你的IP地址；
• 跳过SSL验证仅用于测试，正式使用时务必配置合法的证书路径。

内容的提问来源于stack exchange，提问作者Stephen