Piwigo API中图片上传的正确实现方式

在使用Piwigo图库系统的API进行图片上传时，开发者可能会遇到405错误提示"图片文件缺失"的问题。本文将详细介绍如何正确使用Python通过Piwigo API上传图片到指定分类。

常见错误分析

许多开发者会尝试直接通过POST请求的data参数传递图片路径，如以下错误示例：

payload = {
    "image": "image.jpg",
    "method": "pwg.images.addSimple",
    "category": 15,
    "name": "Test",
}
response = session.post(api_url, data=payload)

这种方法会导致405错误，因为Piwigo API期望接收的是图片的二进制数据，而非简单的文件路径。

正确实现方法

正确的做法是使用multipart/form-data格式上传文件，将图片作为请求的附件发送：

with open(image_path, 'rb') as img_file:
    files = {'image': (image_path, img_file, 'image/jpeg')}
    response = session.post(
        api_url,
        data={
            "method": "pwg.images.addSimple",
            "category": 15,
            "name": "Test",
        },
        files=files
    )

关键点说明

1. 文件打开模式：必须使用二进制模式('rb')打开图片文件
2. files参数：需要构造一个包含文件信息的字典，其中：
   • 键为'image'（固定值）
   • 值为一个元组，包含(文件名, 文件对象, MIME类型)
3. 其他参数：如分类ID、图片名称等应放在data参数中

完整示例代码

import requests

# 初始化会话
session = requests.Session()
auth_data = {
    "username": "your_username",
    "password": "your_password",
}
login_url = "https://your-piwigo-site/ws.php?format=json&method=pwg.session.login"
session.post(login_url, data=auth_data)

# 图片上传
image_path = "test.jpg"
api_url = "https://your-piwigo-site/ws.php?format=json"

with open(image_path, 'rb') as img_file:
    files = {'image': (image_path, img_file, 'image/jpeg')}
    response = session.post(
        api_url,
        data={
            "method": "pwg.images.addSimple",
            "category": 15,
            "name": "Test Image",
        },
        files=files
    )

if response.status_code == 200:
    print("图片上传成功")
else:
    print(f"上传失败: {response.status_code}, {response.text}")

通过这种方式，开发者可以可靠地将图片上传到Piwigo图库系统的指定分类中。