Fecify-店铺-更新

接口信息

  • 接口地址: {your-site-url}/api/skill/shop/update
  • 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/admin
  • 请求方式: POST
  • Content-Type: application/json
  • 说明: 更新已存在店铺的信息，可修改域名、IP、HTTPS、防关联、Cloudflare、多语言等配置。先通过 店铺-详细 获取当前值，修改后再提交。

认证

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

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

请求参数

字段 类型 必填 说明
id String 是 店铺 ID，从 激活店铺-列表 等列表接口获取
name String 否 店铺名称
status Number 否 店铺状态：1 = 激活，2 = 关闭
domain String 否 店铺域名
ip String 否 店铺域名对应的 IP，绑定时先通过 店铺-测试绑定IP 验证
https Number 否 HTTPS 证书：1 = 开启，2 = 关闭
product_max_count Number 否 商品最大数量，0 = 无限制
is_not_expire Number 否 过期类型：1 = 永不过期，2 = 指定过期时间
expired_at String 否 过期时间，格式 YYYY-MM-DD HH:mm:ss；is_not_expire=2 时有效
associate_status Number 否 防关联状态：1 = 不设置，2 = 绑定 IP，3 = 使用代理
proxy_id String 否 代理 ID，associate_status=3 时有效，从 Fecify-代理-select列表 获取
cfsaas_id Number 否 Cloudflare SaaS ID
language_codes String 否 店铺支持的多语言简码，多个用逗号分隔。空字符串表示支持全部语言

请求示例

cURL

curl --location --request POST '{your-site-url}/api/skill/shop/update' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": "353",
    "domain": "84b96f9b85.fecmall.cn",
    "ip": "172.18.141.195",
    "https": 1,
    "name": "rewrwe",
    "status": 1,
    "product_max_count": 0,
    "expired_at": "",
    "is_not_expire": 1,
    "associate_status": 2,
    "proxy_id": "",
    "cfsaas_id": 4,
    "language_codes": ""
}'

返回结果

code 为 200 表示更新成功；code 不为 200 表示失败。

成功响应

{
    "code": 200,
    "data": {
        "id": 353,
        "name": "rewrwe",
        "domain": "84b96f9b85.fecmall.cn",
        "https": 1,
        "status": 1,
        "ip": "172.18.141.195",
        "associate_status": 2,
        "proxy_id": 0,
        "product_max_count": 0,
        "main_manager_id": 138,
        "created_at": "2026-07-21 14:03:07",
        "updated_at": "2026-07-21 14:17:14"
    },
    "message": "success"
}

返回字段说明

字段 类型 说明
code Number 状态码，200 表示成功
message String 执行结果的文字描述
data Object 更新后的店铺信息，字段含义与 店铺-详细 返回字段一致

注意事项

  1. 先通过 店铺-详细 获取当前店铺信息，修改各字段后再调用本接口。
  2. id 必填，其余字段按需传入，未传入的字段保持原值。
  3. ip 建议先通过 店铺-测试绑定IP 验证可用性。
  4. associate_status=3 时需配合 店铺-测试代理IP 验证代理可用性。
  5. proxy_id 从 Fecify-代理-select列表 获取对应的代理 ID。

results matching ""

    No results matching ""