创建生产套图配置

POST

/v4/gateway/podmall.management.product.render.create

需有效 accessToken 及有效的当前租户 X-Tenant-Key。需 RES_PRODUCT / OP_ADD 权限。创建产品级裁片生产配置，同时写入关联SKU 胚品与设计版本均按 tenantKey 校验；同胚品+版本+cutType 下 SKU 不可被多个配置占用；configJson 须为合法 JSON，校验全部通过后才上传 OSS 落 configJsonUrl，再在事务内建配置与关联 SKU。返回新配置 ID。该配置 JSON 是生产图链路的真源：调度器 RenderProcess 及 xpod-render 的 RenderPiecesTask 按 configJsonUrl 读取。

接口 ID：podmall.management.product.render.create

源文档：config/api/podmall/management/render/create.json

权限级别：1。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "productId": 0,
    "name": "string",
    "designVersionId": 0,
    "cutType": "laser",
    "configJson": "string",
    "dpi": 300,
    "fabricMaxWidth": 0,
    "pieceFileFormat": "pdf",
    "compositedFileFormat": "pdf",
    "fileConcat": "n",
    "remarks": "string",
    "skus": [
        null
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v4/gateway/podmall.management.product.render.create' \
--header 'Access-Token-Type;' \
--header 'Access-Token-Type: JWT' \
--header 'Locale;' \
--header 'X-Tenant-Key;' \
--header 'Appkey: 1000' \
--header 'Content-Type: application/json' \
--data '{
    "productId": 0,
    "name": "string",
    "designVersionId": 0,
    "cutType": "laser",
    "configJson": "string",
    "dpi": 300,
    "fabricMaxWidth": 0,
    "pieceFileFormat": "pdf",
    "compositedFileFormat": "pdf",
    "fileConcat": "n",
    "remarks": "string",
    "skus": [
        null
    ]
}'

返回响应

🟢200成功

application/json

网关 JSON 响应；业务结果由 success/status 判断。响应字段按源文档保留。

Bodyapplication/json

示例

{
    "status": 0,
    "success": true,
    "data": 0
}

修改于 2026-09-22 02:13:10

修改PSD文件

取生产套图配置