@youzan-cloud/zan-saas-cli 0.0.0-stage → 0.1.0-beta.4

package/src/commands/native/interaction/lottery/get/schema.json

@@ -0,0 +1,1004 @@
+{
+  "schemaVersion": 1,
+  "input": {
+    "type": "object",
+    "required": [
+      "activityId",
+      "kdtId"
+    ],
+    "additionalProperties": false,
+    "description": "CLI 解析并补全店铺后的业务输入，不是 CLI 接收的 JSON 或服务端请求体。",
+    "properties": {
+      "activityId": {
+        "$ref": "#/definitions/positiveInteger",
+        "description": "抽奖活动 ID，必需；不是活动别名、奖项或领奖标识。"
+      },
+      "kdtId": {
+        "$ref": "#/definitions/positiveInteger",
+        "description": "目标店铺 ID，省略选项时取有效 context.shopId；不证明授权。"
+      }
+    }
+  },
+  "output": {
+    "type": "object",
+    "required": [
+      "data"
+    ],
+    "additionalProperties": false,
+    "description": "本次读取的有限活动配置，不是可回写快照或客户实际奖励。",
+    "properties": {
+      "data": {
+        "type": "object",
+        "required": [
+          "lottery"
+        ],
+        "additionalProperties": false,
+        "description": "成功读取的单个活动结果，不含分页。",
+        "properties": {
+          "lottery": {
+            "$ref": "#/definitions/lottery",
+            "description": "与输入活动和目标店铺匹配的抽奖活动配置。"
+          }
+        }
+      }
+    }
+  },
+  "preview": {
+    "type": "object",
+    "required": [
+      "scope",
+      "prerequisites",
+      "requests",
+      "limits"
+    ],
+    "additionalProperties": false,
+    "description": "零认证、零网络的本地查询计划。",
+    "properties": {
+      "scope": {
+        "$ref": "#/definitions/scope",
+        "description": "本次解析的目标店铺，尚未核验授权。"
+      },
+      "prerequisites": {
+        "type": "array",
+        "const": [
+          "context",
+          "token-shop-binding"
+        ],
+        "description": "context 为有效上下文，token-shop-binding 为同凭证店铺核验。",
+        "items": {
+          "type": "string"
+        }
+      },
+      "requests": {
+        "type": "array",
+        "minItems": 2,
+        "maxItems": 2,
+        "additionalItems": false,
+        "description": "先核验店铺，再单次读取指定活动，不补查列表或奖励资产。",
+        "items": [
+          {
+            "type": "object",
+            "required": [
+              "method",
+              "api",
+              "body"
+            ],
+            "additionalProperties": false,
+            "properties": {
+              "method": {
+                "const": "POST",
+                "description": "核验请求方法。"
+              },
+              "api": {
+                "const": "youzan.shop.basic.get/3.0.0",
+                "description": "店铺核验接口及版本。"
+              },
+              "body": {
+                "type": "object",
+                "additionalProperties": false,
+                "description": "无业务参数。"
+              }
+            }
+          },
+          {
+            "type": "object",
+            "required": [
+              "method",
+              "api",
+              "body"
+            ],
+            "additionalProperties": false,
+            "properties": {
+              "method": {
+                "const": "POST",
+                "description": "活动读取请求方法。"
+              },
+              "api": {
+                "const": "youzan.ump.lottery.get/1.0.0",
+                "description": "活动详情接口及版本。"
+              },
+              "body": {
+                "type": "object",
+                "required": [
+                  "activity_id"
+                ],
+                "additionalProperties": false,
+                "description": "单次详情请求的精确参数。",
+                "properties": {
+                  "activity_id": {
+                    "$ref": "#/definitions/positiveInteger",
+                    "description": "输入活动 ID。"
+                  }
+                }
+              }
+            }
+          }
+        ]
+      },
+      "limits": {
+        "type": "object",
+        "required": [
+          "maxBusinessRequests",
+          "bindingResponseBytes",
+          "queryResponseBytes"
+        ],
+        "additionalProperties": false,
+        "description": "固定内部预算，不属于业务输入或上游配额。",
+        "properties": {
+          "maxBusinessRequests": {
+            "const": 2,
+            "description": "最多两次业务 API 请求，不含认证续期网络。"
+          },
+          "bindingResponseBytes": {
+            "const": 524288,
+            "description": "店铺核验响应的 UTF-8 字节上限。"
+          },
+          "queryResponseBytes": {
+            "const": 8388608,
+            "description": "活动详情响应的 UTF-8 字节上限。"
+          }
+        }
+      }
+    }
+  },
+  "error": {
+    "type": "object",
+    "required": [
+      "success",
+      "code",
+      "message",
+      "details"
+    ],
+    "additionalProperties": false,
+    "description": "失败只写入 stderr，stdout 为空，退出码为 1；不输出部分配置。",
+    "properties": {
+      "success": {
+        "const": false,
+        "description": "固定为失败。"
+      },
+      "code": {
+        "const": -10001,
+        "description": "CLI 查询错误码。"
+      },
+      "message": {
+        "type": "string",
+        "minLength": 1,
+        "description": "不含上游自由文本的安全错误说明。"
+      },
+      "details": {
+        "type": "object",
+        "required": [
+          "category",
+          "stage",
+          "command",
+          "targetScope",
+          "requestState",
+          "nextStep",
+          "errorVersion",
+          "recovery",
+          "execution"
+        ],
+        "additionalProperties": false,
+        "description": "失败阶段、发送事实和安全恢复指引。",
+        "properties": {
+          "category": {
+            "type": "string",
+            "enum": [
+              "parameter",
+              "validation",
+              "configuration",
+              "authentication",
+              "permission",
+              "http",
+              "transport",
+              "protocol",
+              "business_rejected",
+              "scope_unresolved",
+              "not_found",
+              "limit"
+            ],
+            "description": "parameter 参数解析错误；validation 输入格式错误；configuration 配置不足；authentication 身份失败；permission 权限拒绝；http HTTP 失败；transport 传输结果未知；protocol 响应不符；business_rejected 业务拒绝；scope_unresolved 活动、店铺或玩法不符；not_found 活动不存在；limit 响应超限。"
+          },
+          "stage": {
+            "type": "string",
+            "minLength": 1,
+            "description": "input 输入；context 公共上下文；scope 公共目标冲突；validation 公共店铺格式；configuration 配置；shop-binding 店铺核验；query 活动读取；response 正文预算或字段投影。"
+          },
+          "command": {
+            "const": "interaction.lottery.get",
+            "description": "失败命令。"
+          },
+          "targetScope": {
+            "type": "object",
+            "additionalProperties": false,
+            "description": "已解析目标，解析前失败时为空。",
+            "properties": {
+              "kdtId": {
+                "$ref": "#/definitions/positiveInteger",
+                "description": "本次目标店铺 ID。"
+              }
+            }
+          },
+          "requestState": {
+            "enum": [
+              "not_sent",
+              "sent",
+              "unknown"
+            ],
+            "description": "not_sent 尚未发送当前阶段请求；sent 已收到响应；unknown 已尝试发送但结果未知。"
+          },
+          "nextStep": {
+            "type": "string",
+            "minLength": 1,
+            "description": "停止后核查原目标及授权，不自动重试、换店或换身份。"
+          },
+          "api": {
+            "type": "string",
+            "description": "失败接口及版本。"
+          },
+          "httpStatus": {
+            "type": "integer",
+            "description": "实际 HTTP 状态码。"
+          },
+          "businessCode": {
+            "$ref": "#/definitions/diagnosticCode",
+            "description": "安全上游业务码，1605406001 表示活动不存在，1605407001 表示店铺信息获取失败。"
+          },
+          "gatewayCode": {
+            "$ref": "#/definitions/diagnosticCode",
+            "description": "安全网关拒绝码，不当作活动不存在。"
+          },
+          "trace_id": {
+            "type": "string",
+            "pattern": "^[a-zA-Z0-9_-]{1,128}$",
+            "description": "经过字符白名单校验的追踪标识。"
+          },
+          "request_id": {
+            "type": "string",
+            "pattern": "^[a-zA-Z0-9_-]{1,128}$",
+            "description": "经过字符白名单校验的请求标识。"
+          },
+          "errorVersion": {
+            "const": 2,
+            "description": "本命令采用错误诊断协议第二版。"
+          },
+          "issues": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 16,
+            "items": {
+              "$ref": "#/definitions/diagnosticIssue"
+            },
+            "description": "最多十六个已定位问题，不包含收到的原值。"
+          },
+          "issuesTruncated": {
+            "const": true,
+            "description": "问题超过返回上限，当前列表没有穷尽全部问题。"
+          },
+          "recovery": {
+            "$ref": "#/definitions/diagnosticRecovery",
+            "description": "受限的恢复说明，不会自动执行。"
+          },
+          "execution": {
+            "$ref": "#/definitions/diagnosticExecution",
+            "description": "整次调用的请求观察，独立于失败阶段的 requestState。"
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "diagnosticCode": {
+      "anyOf": [
+        {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991
+        },
+        {
+          "type": "string",
+          "pattern": "^-?\\d{1,12}$"
+        }
+      ]
+    },
+    "positiveInteger": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 9007199254740991
+    },
+    "integer": {
+      "type": "integer",
+      "minimum": -9007199254740991,
+      "maximum": 9007199254740991
+    },
+    "nonnegativeInteger": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 9007199254740991
+    },
+    "scope": {
+      "type": "object",
+      "required": [
+        "kdtId"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "kdtId": {
+          "$ref": "#/definitions/positiveInteger",
+          "description": "目标店铺 ID。"
+        }
+      }
+    },
+    "lottery": {
+      "type": "object",
+      "required": [
+        "activityId",
+        "ownerKdtId",
+        "title",
+        "kind"
+      ],
+      "additionalProperties": false,
+      "description": "活动配置；可选字段未返回则省略，返回 null 或错型整体失败。",
+      "properties": {
+        "activityId": {
+          "$ref": "#/definitions/positiveInteger",
+          "description": "活动数字主键，必须与输入一致。"
+        },
+        "ownerKdtId": {
+          "$ref": "#/definitions/positiveInteger",
+          "description": "接口报告的活动归属店铺，必须与目标一致。"
+        },
+        "title": {
+          "type": "string",
+          "pattern": "\\S",
+          "description": "活动名称，必需且非空白。"
+        },
+        "kind": {
+          "type": "string",
+          "enum": [
+            "cards",
+            "wheel",
+            "zodiac",
+            "crazyguess",
+            "shake"
+          ],
+          "description": "抽奖玩法字符串：cards 刮刮卡；wheel 幸运大抽奖；zodiac 生肖翻翻看；crazyguess 疯狂猜猜猜；shake 有赞摇一摇。未知玩法失败。"
+        },
+        "alias": {
+          "type": "string",
+          "pattern": "\\S",
+          "description": "活动别名，不能代替活动数字 ID。"
+        },
+        "startsAt": {
+          "type": "string",
+          "format": "beijing-date-time-ms",
+          "description": "配置开始时间，北京时间 yyyy-MM-dd HH:mm:ss.SSS，年份 0001..9999；不用于推算状态。"
+        },
+        "endsAt": {
+          "type": "string",
+          "format": "beijing-date-time-ms",
+          "description": "配置结束时间，北京时间 yyyy-MM-dd HH:mm:ss.SSS，年份 0001..9999；不用于推算状态。"
+        },
+        "participation": {
+          "$ref": "#/definitions/participation",
+          "description": "至少一个所选参与配置存在时返回，不判断当前客户资格。"
+        },
+        "winning": {
+          "$ref": "#/definitions/winning",
+          "description": "中奖、未中奖和奖项定义配置，源空对象保留为空对象。"
+        },
+        "wheelSlots": {
+          "type": "array",
+          "description": "同次返回的转盘槽位，保留源顺序、重复引用和空数组，不表示奖品总数。",
+          "items": {
+            "$ref": "#/definitions/slot"
+          }
+        },
+        "view": {
+          "$ref": "#/definitions/view",
+          "description": "页面展示配置，源空对象保留为空对象。"
+        },
+        "autoReplyEnabled": {
+          "type": "boolean",
+          "description": "活动是否启用自动回复：true 启用，false 不启用。源字段缺失时省略，null 或非布尔值整体失败；不执行回复。"
+        },
+        "autoReply": {
+          "$ref": "#/definitions/autoReply",
+          "description": "自动回复配置，不执行回复，源空对象保留为空对象。"
+        }
+      }
+    },
+    "participation": {
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": false,
+      "properties": {
+        "requireFollow": {
+          "type": "boolean",
+          "description": "true 参与需关注微信公众号，false 不要求；不证明客户已关注。"
+        },
+        "followValidationType": {
+          "$ref": "#/definitions/integer",
+          "description": "关注校验终端数字码：1 H5，2 小程序，3 两者都需要；requireFollow 为 true 时适用，未知安全整数保留。"
+        },
+        "filterUsers": {
+          "type": "boolean",
+          "description": "true 开启用户标签或会员卡等过滤，false 不开启，不直接理解成黑名单。"
+        },
+        "allowedTagIds": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/positiveInteger"
+          },
+          "description": "允许参与的用户标签白名单 ID，不推断多个白名单的 AND/OR 关系。"
+        },
+        "allowedCardIds": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/positiveInteger"
+          },
+          "description": "允许参与的会员卡白名单 ID，不证明客户持卡。"
+        },
+        "costPoints": {
+          "$ref": "#/definitions/nonnegativeInteger",
+          "description": "参与花费的积分数，单位积分，不换算货币。"
+        },
+        "givePoints": {
+          "$ref": "#/definitions/nonnegativeInteger",
+          "description": "参与赠送的积分数，单位积分。"
+        },
+        "giveOnlyWhenNotWinning": {
+          "type": "boolean",
+          "description": "true 仅未中奖参与者获赠积分，false 不是仅未中奖者。"
+        },
+        "limitType": {
+          "$ref": "#/definitions/integer",
+          "description": "参与次数限制数字码：1 一天 N 次，2 一人 N 次；N 见 limitCount，未知安全整数保留。"
+        },
+        "limitCount": {
+          "$ref": "#/definitions/nonnegativeInteger",
+          "description": "与 limitType 共同解释的次数 N，单位次；0 不自动表示不限次。"
+        },
+        "shareLimit": {
+          "$ref": "#/definitions/nonnegativeInteger",
+          "description": "配置分享次数限制，单位次，不推导额外抽奖次数。"
+        },
+        "conditionType": {
+          "$ref": "#/definitions/integer",
+          "description": "参与条件数字码：1 无限制，2 积分限制，3 购物限制；当前接口说明支持 1/2，未知安全整数保留，不计算客户资格。"
+        }
+      }
+    },
+    "winning": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "probabilityBasisPoints": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 10000,
+          "description": "活动级配置中奖概率，单位万分比，10000 为 100%，100 为 1%。"
+        },
+        "noPrizeName": {
+          "type": "string",
+          "description": "未中奖展示名称，空串保留。"
+        },
+        "noPrizeText": {
+          "type": "string",
+          "description": "未中奖展示文字，空串保留。"
+        },
+        "noPrizeImageUrl": {
+          "type": "string",
+          "description": "未中奖图片地址，空串保留，不访问。"
+        },
+        "jumpWhenNotWinning": {
+          "type": "boolean",
+          "description": "true 未中奖跳转配置推广页，false 不跳转；本命令不访问链接。"
+        },
+        "noPrizeLink": {
+          "$ref": "#/definitions/link",
+          "description": "未中奖推广链接配置，不用于定位抽奖活动。"
+        },
+        "awards": {
+          "type": "array",
+          "description": "中奖设置内的奖项定义，不表示客户中奖或资产到账。",
+          "items": {
+            "$ref": "#/definitions/award"
+          }
+        }
+      }
+    },
+    "link": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "alias": {
+          "type": "string",
+          "description": "推广链接别名，空串保留。"
+        },
+        "id": {
+          "type": "string",
+          "description": "推广目标编码，不是抽奖活动 ID，空串保留。"
+        },
+        "title": {
+          "type": "string",
+          "description": "推广链接展示标题，空串保留。"
+        },
+        "type": {
+          "type": "string",
+          "pattern": "\\S",
+          "description": "链接类型字符串：goods 商品链接，showcase 微页面链接；未知非空字符串保留，不自动访问。"
+        },
+        "url": {
+          "type": "string",
+          "description": "推广页地址，空串保留，不访问或执行内容。"
+        }
+      }
+    },
+    "award": {
+      "type": "object",
+      "required": [
+        "awardId"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "awardId": {
+          "$ref": "#/definitions/positiveInteger",
+          "description": "奖项配置 ID，不是活动或实际奖励资产 ID。"
+        },
+        "name": {
+          "type": "string",
+          "description": "奖项展示名称，空串保留。"
+        },
+        "type": {
+          "$ref": "#/definitions/integer",
+          "description": "奖项奖励数字码：1 优惠券，2 优惠码，3 赠品，4 积分；未知安全整数保留，不套用已知类型含义。"
+        },
+        "imageUrl": {
+          "type": "string",
+          "description": "奖项展示图片地址，空串保留，不访问。"
+        },
+        "originName": {
+          "type": "string",
+          "description": "所引赠品或优惠券原名，空串保留。"
+        },
+        "stockQuantity": {
+          "$ref": "#/definitions/integer",
+          "description": "接口报告的库存数量，负数不猜成不限量，不减去已发放次数计算剩余。"
+        },
+        "sourceRewardId": {
+          "$ref": "#/definitions/nonnegativeInteger",
+          "description": "源奖励引用编码，具体资产映射未证，不自动当作券活动或赠品主键，0 保留。"
+        },
+        "position": {
+          "$ref": "#/definitions/integer",
+          "description": "奖项排序值，不表示中奖优先级。"
+        },
+        "pointsValue": {
+          "$ref": "#/definitions/nonnegativeInteger",
+          "description": "奖励类型为 4 时每次发放的积分数，非积分类型返回时原值保留，不改变类型。"
+        },
+        "issuedCount": {
+          "$ref": "#/definitions/nonnegativeInteger",
+          "description": "接口报告的已发放次数，单位次，不代表履约完成。"
+        },
+        "probabilityPercent": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 100,
+          "description": "奖项配置概率，单位百分比，100 为 100%，1 为 1%；不推导本次真实中奖概率。"
+        }
+      }
+    },
+    "slot": {
+      "type": "object",
+      "required": [
+        "type",
+        "position"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "awardId": {
+          "$ref": "#/definitions/positiveInteger",
+          "description": "槽位引用奖项 ID，可重复，未中奖槽位可省略。"
+        },
+        "type": {
+          "$ref": "#/definitions/integer",
+          "description": "槽位结果数字码：0 未中奖，1 优惠券，2 优惠码，3 赠品，4 积分，31 优惠券礼包；未知安全整数保留。"
+        },
+        "name": {
+          "type": "string",
+          "description": "槽位展示名称，空串保留。"
+        },
+        "imageUrl": {
+          "type": "string",
+          "description": "槽位展示图片地址，空串保留，不访问。"
+        },
+        "originName": {
+          "type": "string",
+          "description": "槽位所引赠品或优惠券原名，空串保留。"
+        },
+        "position": {
+          "$ref": "#/definitions/positiveInteger",
+          "description": "从 1 开始的槽位位置，不按奖项 ID 合并或排序。"
+        }
+      }
+    },
+    "view": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "showWinnerList": {
+          "type": "boolean",
+          "description": "true 展示获奖名单，false 不展示。"
+        },
+        "showLogo": {
+          "type": "boolean",
+          "description": "true 展示商家 logo，false 不展示。"
+        },
+        "backgroundImageUrl": {
+          "type": "string",
+          "description": "背景图片地址，空串保留，不访问。"
+        },
+        "description": {
+          "type": "string",
+          "description": "活动说明文本，空串保留，不执行其中内容。"
+        }
+      }
+    },
+    "autoReply": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "content": {
+          "type": "string",
+          "description": "自动回复内容文本，空串保留，不发送回复。"
+        },
+        "ruleId": {
+          "$ref": "#/definitions/nonnegativeInteger",
+          "description": "自动回复规则 ID，0 表示没有规则。"
+        },
+        "keywords": {
+          "type": "array",
+          "description": "自动回复关键词配置，空数组保留。",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "name": {
+                "type": "string",
+                "description": "触发关键词文本，空串保留。"
+              },
+              "fullMatch": {
+                "type": "boolean",
+                "description": "true 全匹配，false 模糊匹配。"
+              }
+            }
+          }
+        }
+      }
+    },
+    "diagnosticExpected": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [],
+      "properties": {
+        "type": {
+          "anyOf": [
+            {
+              "type": "string",
+              "description": "预期的 JSON 类型。"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "description": "预期的 JSON 类型。"
+              }
+            }
+          ],
+          "description": "同版模型允许的类型。"
+        },
+        "enum": {
+          "type": "array",
+          "items": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "number"
+              },
+              {
+                "type": "boolean"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "契约声明的静态标量约束。"
+          },
+          "description": "同版模型允许的静态值。"
+        },
+        "const": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "number"
+            },
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "契约声明的静态标量约束。"
+        },
+        "minimum": {
+          "type": "number",
+          "description": "包含的最小值。"
+        },
+        "maximum": {
+          "type": "number",
+          "description": "包含的最大值。"
+        },
+        "exclusiveMinimum": {
+          "type": "number",
+          "description": "不包含的最小值。"
+        },
+        "exclusiveMaximum": {
+          "type": "number",
+          "description": "不包含的最大值。"
+        },
+        "minLength": {
+          "type": "integer",
+          "description": "最少字符数。"
+        },
+        "maxLength": {
+          "type": "integer",
+          "description": "最多字符数。"
+        },
+        "minItems": {
+          "type": "integer",
+          "description": "最少元素数。"
+        },
+        "maxItems": {
+          "type": "integer",
+          "description": "最多元素数。"
+        },
+        "format": {
+          "type": "string",
+          "description": "同版模型声明的格式。"
+        },
+        "pattern": {
+          "type": "string",
+          "description": "同版模型声明的字符约束。"
+        },
+        "additionalProperties": {
+          "const": false,
+          "description": "对象拒绝契约以外的属性。"
+        },
+        "contains": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "const"
+          ],
+          "properties": {
+            "const": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "number"
+                },
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "契约声明的静态标量约束。"
+            }
+          }
+        },
+        "items": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "enum"
+          ],
+          "properties": {
+            "enum": {
+              "type": "array",
+              "items": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "number"
+                  },
+                  {
+                    "type": "boolean"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "契约声明的静态标量约束。"
+              },
+              "description": "元素允许的静态值。"
+            }
+          }
+        }
+      }
+    },
+    "diagnosticIssue": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "source",
+        "reason"
+      ],
+      "properties": {
+        "source": {
+          "enum": [
+            "argv",
+            "input",
+            "context",
+            "output",
+            "preview"
+          ],
+          "description": "问题所属的参数、输入、上下文、结果或预览模型。"
+        },
+        "path": {
+          "type": "string",
+          "description": "对应模型中的 JSON Pointer；不含原始输入或动态字典键。"
+        },
+        "option": {
+          "type": "string",
+          "description": "可定位时给出的已注册 CLI 选项。"
+        },
+        "reason": {
+          "enum": [
+            "required",
+            "invalid_type",
+            "invalid_choice",
+            "out_of_range",
+            "invalid_format",
+            "conditional_required",
+            "constraint",
+            "unexpected_property",
+            "unknown_option",
+            "unknown_command",
+            "excess_arguments",
+            "missing_value"
+          ],
+          "description": "字段违反的约束类型，原始值不回显。"
+        },
+        "expected": {
+          "$ref": "#/definitions/diagnosticExpected",
+          "description": "同版契约的静态预期。"
+        },
+        "relatedPaths": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "description": "关联字段的 JSON Pointer。"
+          },
+          "description": "触发条件约束的关联字段。"
+        }
+      }
+    },
+    "diagnosticRecovery": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "action",
+        "automaticBusinessRetry"
+      ],
+      "properties": {
+        "action": {
+          "enum": [
+            "correct_input",
+            "complete_authentication",
+            "request_access_review",
+            "stop_and_inspect"
+          ],
+          "description": "依次表示修正本地输入、补认证、核对权限或停止核查；仅是说明，不执行操作或授予权限。"
+        },
+        "automaticBusinessRetry": {
+          "const": false,
+          "description": "不据此自动重放业务请求。"
+        }
+      }
+    },
+    "diagnosticExecution": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "requestState",
+        "coverage",
+        "observedAttempts"
+      ],
+      "properties": {
+        "requestState": {
+          "enum": [
+            "not_sent",
+            "sent",
+            "unknown"
+          ],
+          "description": "整次调用尚未发送、已有发送记录或无法排除未知请求；不代表业务完成。"
+        },
+        "coverage": {
+          "enum": [
+            "complete",
+            "partial"
+          ],
+          "description": "请求观察覆盖全部已接入路径，或存在未观测路径；部分覆盖不能声明零请求。"
+        },
+        "observedAttempts": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991,
+          "description": "本地已进入发送边界的观测次数下界，不是服务端执行次数。"
+        }
+      }
+    }
+  },
+  "modules": {
+    "lottery": {
+      "base": true,
+      "upstreamPath": "data",
+      "required": true,
+      "description": "单个同店活动的有限配置，默认返回已观测到的参与、奖项、转盘及页面设置。"
+    }
+  },
+  "api": {
+    "method": "POST",
+    "path": "youzan.ump.lottery.get/1.0.0"
+  },
+  "success": {
+    "description": "同凭证店铺核验通过，活动 ID、归属店铺、非空标题和已知玩法匹配，全部已返回的所选字段满足递归模型后成功。"
+  },
+  "errors": {
+    "description": "1605406001 为 not_found；1605407001 保持业务拒绝。HTTP 403 为权限拒绝。信号冲突、缺少核心对象、所选字段 null 或错型均失败，空配置不掩盖业务失败。停止后核对原目标及授权，不自动重试、换店或换身份。",
+    "diagnosticsVersion": 2
+  },
+  "notes": [
+    "仅核实微商城单店范围；本地 at: all 不证明产品、员工或对象授权。店铺核验不是员工 OAuth 验收。",
+    "每次最多同店核验和一次详情请求。核验响应上限 512 KiB，主响应上限 8 MiB，超限整体失败，不裁剪数组。",
+    "可选字段省略不补 0、false 或 null；源空对象和空数组保留。字段返回 null 或错型整体失败，不检查未选上游扩展。",
+    "不返回或推算当前活动状态，不扫描列表，不判断客户资格、中奖或奖励到账。不读取参与记录、中奖记录或奖励资产。",
+    "活动概率为万分比，奖项概率为百分比，转盘槽位概率缺少单位依据，不输出或换算。",
+    "时间统一北京时间并固定毫秒精度；Unix 毫秒 0 为 1970-01-01 08:00:00.000，不表示永久。",
+    "嵌套集合只表示同次返回的配置，不承诺历史全集；保留槽位顺序和重复奖项引用，不制造分页。",
+    "积分、库存和概率不是货币；不访问链接、下载图片、执行说明文本或发送回复。"
+  ]
+}