名创优品接口说明

名创优品任务监控接口 · 自动化任务管理与上传

接口基本信息

GET/POSThttps://api.sicxs.cn/i/mcyp_api.php
项目说明
用途名创优品任务数据管理，支持查询、添加、删除与批量上传。
返回格式application/json
编码UTF-8

接口列表

action方法说明主要参数
listGET获取任务列表（无需鉴权）无（action 省略时默认 list）
add_taskPOST新增单条任务task_id、task_name
batch_addPOST批量添加任务（重复自动跳过）请求体 JSON 数组 [{"task_id":..,"task_name":..}]
deletePOST删除指定任务task_id
clearPOST清空所有任务无

字段说明

字段是否必须说明
task_id是任务 ID（名创官方 taskId，数字）。
task_name是任务名称，服务端存储时自动加「任务-」前缀。
api_key是*鉴权密钥，所有 POST 操作必须。通过 URL ?api_key= 或请求头 X-API-KEY 传入（*list 查询无需）。

调用示例

查询
新增
Python
curl "https://api.sicxs.cn/i/mcyp_api.php?action=list"
# 单条新增
curl -X POST "https://api.sicxs.cn/i/mcyp_api.php?action=add_task&api_key=密钥" \
  -d "task_id=285" \
  -d "task_name=浏览CK新品页"

# 批量新增（JSON 请求体）
curl -X POST "https://api.sicxs.cn/i/mcyp_api.php?action=batch_add&api_key=密钥" \
  -H "Content-Type: application/json" \
  -d '[{"task_id":285,"task_name":"浏览CK新品页"},{"task_id":284,"task_name":"浏览哈利波特新品页"}]'

# 删除 / 清空
curl -X POST "https://api.sicxs.cn/i/mcyp_api.php?action=delete&api_key=密钥" -d "task_id=285"
curl -X POST "https://api.sicxs.cn/i/mcyp_api.php?action=clear&api_key=密钥"
import requests

url = "https://api.sicxs.cn/i/mcyp_api.php"
params = {"action": "list"}
print(requests.get(url, params=params, timeout=15).json())

返回示例

{
  "ok": true,
  "message": "获取成功",
  "data": [
    { "msg": 200, "name": "任务-浏览潮玩新品发售页", "added_at": "2026-08-22 18:46:05" }
  ]
}
// msg = task_id；batch_add 返回 {"ok":true,"data":{"added":N,"skipped":N}}