Fecify-应用-更新

接口信息

  • 接口地址: {your-site-url}/api/skill/addons/update
  • 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/admin
  • 请求方式: POST
  • Content-Type: application/json
  • 说明: 更新应用的配置信息，包括名称、描述、状态、售价等。

认证

请求头中需要携带 skill-access-token：

Header 值
skill-access-token {your-skill-access-token} （请替换为你自己的 token）

请求参数

参数 类型 必填 说明
addons_id String 是 应用 ID
status Number 否 上架状态：1 上架，2 下架
name Object 否 应用名称（多语言结构），格式：{"name":"名称","lang_params":{"en":"","tw":""}}
description Object 否 应用描述（多语言结构）
img String 否 应用图片相对路径
pay_type Number 否 付费类型：1 付费，2 免费
is_forever Number 否 是否永久标识。仅 pay_type=1 时设置
buy_type Number 否 购买方式：1 在线支付。仅 pay_type=1 时设置
price_info Array 否 售价信息数组。仅 pay_type=1 时设置

price_info 子项

参数 类型 必填 说明
id String 是 售价方案 ID
is_forever Number 是 是否永久：1 永久，2 非永久
days Number / String 否 有效天数，is_forever=2 时必填
day_label String 否 天数标签
price Number 是 售卖价格
compare_at_price Number 是 划线价格

请求示例

cURL

curl --location --request POST '{your-site-url}/api/skill/addons/update' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "addons_id": "175",
    "status": 1,
    "name": {
        "name": "商品禁售",
        "lang_params": {
            "en": "",
            "tw": ""
        }
    },
    "description": {
        "name": "禁止特定商品：在特定国家销售、使用特定货运方式、或通过特定支付方式交易。",
        "lang_params": {
            "en": "",
            "tw": ""
        }
    },
    "price_info": [
        {
            "id": "AXVWDqh6wK",
            "is_forever": 2,
            "days": 1,
            "day_label": "1",
            "price": 1,
            "compare_at_price": 1
        }
    ],
    "is_forever": 1,
    "buy_type": 1,
    "pay_type": 1,
    "img": "/system/addons/prodban.png"
}'

返回结果

code 为 200 表示调用成功；code 不为 200 表示调用失败。

成功响应

{
    "code": 200,
    "data": [],
    "message": "success"
}

返回字段说明

字段 类型 说明
code Number 状态码，200 表示成功
message String 执行结果的文字描述
data Array 空数组

注意事项

  1. addons_id 为必填参数，通过 Fecify-应用-列表 获取。
  2. 更新前建议先通过 Fecify-应用-详细 获取当前信息，在此基础上修改后再提交。
  3. price_info 中的 id 需要保持与现有数据一致，否则无法正确更新。
  4. name 和 description 使用多语言 JSON 结构。
  5. pay_type 决定其他字段是否需要填写：
    • pay_type=1（付费应用）：需要设置 is_forever、price_info、buy_type
    • pay_type=2（免费应用）：不需要设置 is_forever、price_info、buy_type

results matching ""

    No results matching ""