编辑下载器

PATCH

http://127.0.0.1:9897/api/downloaders/{downloaderId}

最后修改时间：2025-06-05 06:44:09

责任人：未设置

建议在创建/保存之前，先调用下载器测试接口，测试用户填写的配置有效再调用此接口。
当 DraftDownloader 中的 name 和请求 Param {downloadName} 不同时，PBH 会按照重命名处理，删除 downloadName 并添加 name

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

downloaderId

string

必需

Body 参数application/json

config

object

JSON 配置块

必需

配置文件块，根据下载器的类型不同，其中的字段和参数可能均不相同

示例

{
    "config": {
        "id": "random id string",
        "name": "MyDownloader",
        "type": "qbittorrent",
        "endpoint": "http://localhost:58081",
        "username": "admin",
        "password": "adminadmin",
        "basicAuth": {
            "user": "",
            "pass": ""
        },
        "httpVersion": "HTTP_1_1",
        "incrementBan": false,
        "verifySsl": true,
        "ignorePrivate": false
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PATCH 'http://127.0.0.1:9897/api/downloaders/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "config": {
        "id": "random id string",
        "name": "MyDownloader",
        "type": "qbittorrent",
        "endpoint": "http://localhost:58081",
        "username": "admin",
        "password": "adminadmin",
        "basicAuth": {
            "user": "",
            "pass": ""
        },
        "httpVersion": "HTTP_1_1",
        "incrementBan": false,
        "verifySsl": true,
        "ignorePrivate": false
    }
}'

返回响应

🟢200成功

application/json

Body

message

string

提示信息

必需

test

boolean

测试是否通过

必需

示例

{
    "message": "Successfully to test the downloader",
    "test": true
}

🟠403未登录或Token错误

🟠429IP地址因频繁失败尝试而被封禁

🔴500内部服务器错误

🟠400参数有误

修改于 2025-06-05 06:44:09

创建下载器

测试下载器配置