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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (329) hide show
  1. package/DEPENDENCIES.json +50 -0
  2. package/INSTALL.md +79 -0
  3. package/LICENSE +21 -0
  4. package/NOTICE +1 -0
  5. package/README.md +151 -2
  6. package/THIRD_PARTY_NOTICES.txt +162 -0
  7. package/bin/zan-saas-cli.js +28 -0
  8. package/internal/registry/index.js +123 -0
  9. package/internal/registry/manifest.json +424 -0
  10. package/npm-shrinkwrap.json +86 -0
  11. package/package.json +33 -4
  12. package/skills/README.md +30 -0
  13. package/skills/zan-saas/SKILL.md +54 -0
  14. package/skills/zan-saas/references/host-entry.md +25 -0
  15. package/skills/zan-saas-access/SKILL.md +37 -0
  16. package/skills/zan-saas-access/references/role-list.md +11 -0
  17. package/skills/zan-saas-access/references/staff-perms-get.md +11 -0
  18. package/skills/zan-saas-aftersale/SKILL.md +31 -0
  19. package/skills/zan-saas-aftersale/references/case-list.md +13 -0
  20. package/skills/zan-saas-aftersale/references/case-scan.md +31 -0
  21. package/skills/zan-saas-benefit/SKILL.md +46 -0
  22. package/skills/zan-saas-benefit/references/card-get.md +7 -0
  23. package/skills/zan-saas-benefit/references/card-grant-list.md +11 -0
  24. package/skills/zan-saas-benefit/references/card-list.md +7 -0
  25. package/skills/zan-saas-benefit/references/customer-card-get.md +7 -0
  26. package/skills/zan-saas-benefit/references/customer-card-list.md +7 -0
  27. package/skills/zan-saas-coupon/SKILL.md +41 -0
  28. package/skills/zan-saas-coupon/references/activity-get.md +11 -0
  29. package/skills/zan-saas-coupon/references/activity-list.md +15 -0
  30. package/skills/zan-saas-coupon/references/voucher-get.md +13 -0
  31. package/skills/zan-saas-coupon/references/voucher-list.md +25 -0
  32. package/skills/zan-saas-customer/SKILL.md +73 -0
  33. package/skills/zan-saas-customer/references/customer-scan.md +11 -0
  34. package/skills/zan-saas-customer/references/segment-list.md +22 -0
  35. package/skills/zan-saas-fulfillment/SKILL.md +36 -0
  36. package/skills/zan-saas-fulfillment/references/delivery-get.md +11 -0
  37. package/skills/zan-saas-fulfillment/references/shipment-list.md +11 -0
  38. package/skills/zan-saas-fulfillment/references/waybill-get.md +9 -0
  39. package/skills/zan-saas-interaction/SKILL.md +37 -0
  40. package/skills/zan-saas-interaction/references/lottery-get.md +11 -0
  41. package/skills/zan-saas-interaction/references/lottery-list.md +19 -0
  42. package/skills/zan-saas-item/SKILL.md +61 -0
  43. package/skills/zan-saas-item/references/attribute-list.md +11 -0
  44. package/skills/zan-saas-item/references/brand-list.md +7 -0
  45. package/skills/zan-saas-item/references/classification-get.md +7 -0
  46. package/skills/zan-saas-item/references/classification-list.md +7 -0
  47. package/skills/zan-saas-item/references/group-list.md +9 -0
  48. package/skills/zan-saas-item/references/item-content.md +9 -0
  49. package/skills/zan-saas-item/references/item-get.md +9 -0
  50. package/skills/zan-saas-item/references/item-search.md +23 -0
  51. package/skills/zan-saas-item/references/product-identity.md +11 -0
  52. package/skills/zan-saas-member/SKILL.md +41 -0
  53. package/skills/zan-saas-member/references/customer-level-get.md +7 -0
  54. package/skills/zan-saas-member/references/growth-log-list.md +17 -0
  55. package/skills/zan-saas-member/references/membership-get.md +7 -0
  56. package/skills/zan-saas-order/SKILL.md +56 -0
  57. package/skills/zan-saas-order/references/order-get.md +26 -0
  58. package/skills/zan-saas-order/references/order-list.md +25 -0
  59. package/skills/zan-saas-order/references/order-scan.md +35 -0
  60. package/skills/zan-saas-org/SKILL.md +37 -0
  61. package/skills/zan-saas-org/references/staff-get.md +15 -0
  62. package/skills/zan-saas-org/references/staff-role-get.md +11 -0
  63. package/skills/zan-saas-org/references/unit-get.md +11 -0
  64. package/skills/zan-saas-org/references/unit-list.md +15 -0
  65. package/skills/zan-saas-points/SKILL.md +42 -0
  66. package/skills/zan-saas-points/references/account-get.md +7 -0
  67. package/skills/zan-saas-points/references/log-list.md +17 -0
  68. package/skills/zan-saas-points/references/rule-list.md +2 -0
  69. package/skills/zan-saas-privacy/SKILL.md +30 -0
  70. package/skills/zan-saas-privacy/references/field-decrypt.md +19 -0
  71. package/skills/zan-saas-shared/SKILL.md +94 -0
  72. package/skills/zan-saas-shared/references/authentication.md +52 -0
  73. package/skills/zan-saas-shared/references/value-processing.md +27 -0
  74. package/skills/zan-saas-stock/SKILL.md +28 -0
  75. package/skills/zan-saas-stock/references/log-list.md +11 -0
  76. package/skills/zan-saas-valuecard/SKILL.md +37 -0
  77. package/skills/zan-saas-valuecard/references/card-get.md +13 -0
  78. package/skills/zan-saas-valuecard/references/card-list.md +11 -0
  79. package/src/auth/browser.js +28 -0
  80. package/src/auth/callback-server.js +99 -0
  81. package/src/auth/config.js +53 -0
  82. package/src/auth/credential-store.js +109 -0
  83. package/src/auth/oauth-client.js +105 -0
  84. package/src/auth/pkce.js +28 -0
  85. package/src/auth/session.js +178 -0
  86. package/src/auth/tool.js +25 -0
  87. package/src/cli/command-paths.js +126 -0
  88. package/src/cli/context-help.js +102 -0
  89. package/src/cli/diagnostic-command.js +57 -0
  90. package/src/cli/domain-catalog.js +42 -0
  91. package/src/cli/help-text.js +32 -0
  92. package/src/cli/native-loader.js +120 -0
  93. package/src/cli/native-path.js +22 -0
  94. package/src/cli/parser-policy.js +141 -0
  95. package/src/cli/program.js +134 -0
  96. package/src/cli/skill-catalog.js +241 -0
  97. package/src/commands/native/access/commands.index.json +24 -0
  98. package/src/commands/native/access/domain.json +3 -0
  99. package/src/commands/native/access/role/list/command.js +141 -0
  100. package/src/commands/native/access/role/list/schema.json +393 -0
  101. package/src/commands/native/access/staff-perms/get/command.js +119 -0
  102. package/src/commands/native/access/staff-perms/get/schema.json +703 -0
  103. package/src/commands/native/aftersale/case/get/command.js +104 -0
  104. package/src/commands/native/aftersale/case/get/exact-json.js +52 -0
  105. package/src/commands/native/aftersale/case/get/money.js +28 -0
  106. package/src/commands/native/aftersale/case/get/projection.js +120 -0
  107. package/src/commands/native/aftersale/case/get/query.js +72 -0
  108. package/src/commands/native/aftersale/case/get/schema.json +134 -0
  109. package/src/commands/native/aftersale/case/list/command.js +135 -0
  110. package/src/commands/native/aftersale/case/list/schema.json +1095 -0
  111. package/src/commands/native/aftersale/case/scan/command.js +110 -0
  112. package/src/commands/native/aftersale/case/scan/query.js +62 -0
  113. package/src/commands/native/aftersale/case/scan/scan.js +78 -0
  114. package/src/commands/native/aftersale/case/scan/schema.json +964 -0
  115. package/src/commands/native/aftersale/case/scan/search.js +108 -0
  116. package/src/commands/native/aftersale/commands.index.json +42 -0
  117. package/src/commands/native/aftersale/domain.json +3 -0
  118. package/src/commands/native/aftersale/refund/list/command.js +97 -0
  119. package/src/commands/native/aftersale/refund/list/money.js +25 -0
  120. package/src/commands/native/aftersale/refund/list/projection.js +50 -0
  121. package/src/commands/native/aftersale/refund/list/query.js +73 -0
  122. package/src/commands/native/aftersale/refund/list/schema.json +130 -0
  123. package/src/commands/native/aftersale/shared/query.js +58 -0
  124. package/src/commands/native/aftersale/shared/search.js +128 -0
  125. package/src/commands/native/benefit/card-definition/get/command.js +110 -0
  126. package/src/commands/native/benefit/card-definition/get/schema.json +545 -0
  127. package/src/commands/native/benefit/card-definition/list/command.js +105 -0
  128. package/src/commands/native/benefit/card-definition/list/schema.json +690 -0
  129. package/src/commands/native/benefit/card-grant/list/command.js +135 -0
  130. package/src/commands/native/benefit/card-grant/list/schema.json +758 -0
  131. package/src/commands/native/benefit/commands.index.json +51 -0
  132. package/src/commands/native/benefit/customer-card/get/command.js +110 -0
  133. package/src/commands/native/benefit/customer-card/get/schema.json +340 -0
  134. package/src/commands/native/benefit/customer-card/list/command.js +102 -0
  135. package/src/commands/native/benefit/customer-card/list/schema.json +731 -0
  136. package/src/commands/native/benefit/domain.json +3 -0
  137. package/src/commands/native/coupon/activity/get/command.js +183 -0
  138. package/src/commands/native/coupon/activity/get/schema.json +624 -0
  139. package/src/commands/native/coupon/activity/list/command.js +169 -0
  140. package/src/commands/native/coupon/activity/list/schema.json +845 -0
  141. package/src/commands/native/coupon/commands.index.json +42 -0
  142. package/src/commands/native/coupon/domain.json +3 -0
  143. package/src/commands/native/coupon/shared/query.js +15 -0
  144. package/src/commands/native/coupon/voucher/get/command.js +113 -0
  145. package/src/commands/native/coupon/voucher/get/schema.json +147 -0
  146. package/src/commands/native/coupon/voucher/list/command.js +155 -0
  147. package/src/commands/native/coupon/voucher/list/schema.json +772 -0
  148. package/src/commands/native/customer/commands.index.json +96 -0
  149. package/src/commands/native/customer/customer/get/adapter.js +82 -0
  150. package/src/commands/native/customer/customer/get/command.js +106 -0
  151. package/src/commands/native/customer/customer/get/schema.json +958 -0
  152. package/src/commands/native/customer/customer/list/command.js +78 -0
  153. package/src/commands/native/customer/customer/list/input.js +145 -0
  154. package/src/commands/native/customer/customer/list/query.js +103 -0
  155. package/src/commands/native/customer/customer/list/schema.json +969 -0
  156. package/src/commands/native/customer/customer/scan/command.js +80 -0
  157. package/src/commands/native/customer/customer/scan/scan.js +92 -0
  158. package/src/commands/native/customer/customer/scan/schema.json +211 -0
  159. package/src/commands/native/customer/customer-tag/get/command.js +166 -0
  160. package/src/commands/native/customer/customer-tag/get/schema.json +317 -0
  161. package/src/commands/native/customer/customer-tag/list/command.js +143 -0
  162. package/src/commands/native/customer/customer-tag/list/schema.json +259 -0
  163. package/src/commands/native/customer/domain.json +3 -0
  164. package/src/commands/native/customer/segment/list/command.js +96 -0
  165. package/src/commands/native/customer/segment/list/query.js +98 -0
  166. package/src/commands/native/customer/segment/list/schema.json +135 -0
  167. package/src/commands/native/customer/segment-customer/list/command.js +171 -0
  168. package/src/commands/native/customer/segment-customer/list/schema.json +123 -0
  169. package/src/commands/native/customer/shared/search-input.js +179 -0
  170. package/src/commands/native/customer/shared/search-page.js +54 -0
  171. package/src/commands/native/customer/tag/get/command.js +73 -0
  172. package/src/commands/native/customer/tag/get/schema.json +339 -0
  173. package/src/commands/native/customer/tagcategory/get/command.js +80 -0
  174. package/src/commands/native/customer/tagcategory/get/query.js +98 -0
  175. package/src/commands/native/customer/tagcategory/get/schema.json +339 -0
  176. package/src/commands/native/customer/tagcategory/list/command.js +127 -0
  177. package/src/commands/native/customer/tagcategory/list/schema.json +394 -0
  178. package/src/commands/native/fulfillment/commands.index.json +33 -0
  179. package/src/commands/native/fulfillment/delivery/get/command.js +107 -0
  180. package/src/commands/native/fulfillment/delivery/get/projection.js +142 -0
  181. package/src/commands/native/fulfillment/delivery/get/schema.json +173 -0
  182. package/src/commands/native/fulfillment/domain.json +3 -0
  183. package/src/commands/native/fulfillment/shipment/list/command.js +83 -0
  184. package/src/commands/native/fulfillment/shipment/list/projection.js +130 -0
  185. package/src/commands/native/fulfillment/shipment/list/schema.json +752 -0
  186. package/src/commands/native/fulfillment/waybill/get/command.js +193 -0
  187. package/src/commands/native/fulfillment/waybill/get/response.js +68 -0
  188. package/src/commands/native/fulfillment/waybill/get/schema.json +190 -0
  189. package/src/commands/native/interaction/commands.index.json +24 -0
  190. package/src/commands/native/interaction/domain.json +3 -0
  191. package/src/commands/native/interaction/lottery/get/command.js +61 -0
  192. package/src/commands/native/interaction/lottery/get/query.js +152 -0
  193. package/src/commands/native/interaction/lottery/get/schema.json +1004 -0
  194. package/src/commands/native/interaction/lottery/list/command.js +176 -0
  195. package/src/commands/native/interaction/lottery/list/schema.json +898 -0
  196. package/src/commands/native/item/attribute/list/command.js +122 -0
  197. package/src/commands/native/item/attribute/list/schema.json +727 -0
  198. package/src/commands/native/item/brand/list/command.js +114 -0
  199. package/src/commands/native/item/brand/list/schema.json +725 -0
  200. package/src/commands/native/item/classification/get/command.js +87 -0
  201. package/src/commands/native/item/classification/get/schema.json +596 -0
  202. package/src/commands/native/item/classification/list/command.js +105 -0
  203. package/src/commands/native/item/classification/list/schema.json +676 -0
  204. package/src/commands/native/item/commands.index.json +87 -0
  205. package/src/commands/native/item/domain.json +1 -0
  206. package/src/commands/native/item/group/list/command.js +122 -0
  207. package/src/commands/native/item/group/list/schema.json +809 -0
  208. package/src/commands/native/item/item/get/command.js +122 -0
  209. package/src/commands/native/item/item/get/schema.json +3799 -0
  210. package/src/commands/native/item/item/list/command.js +7 -0
  211. package/src/commands/native/item/item/list/schema.json +1118 -0
  212. package/src/commands/native/item/item/scan/command.js +7 -0
  213. package/src/commands/native/item/item/scan/schema.json +1046 -0
  214. package/src/commands/native/item/item-content/get/command.js +54 -0
  215. package/src/commands/native/item/item-content/get/schema.json +677 -0
  216. package/src/commands/native/item/shared/api.js +31 -0
  217. package/src/commands/native/item/shared/content.js +20 -0
  218. package/src/commands/native/item/shared/diagnostics.js +61 -0
  219. package/src/commands/native/item/shared/h5.js +63 -0
  220. package/src/commands/native/item/shared/identity.js +62 -0
  221. package/src/commands/native/item/shared/normalize.js +49 -0
  222. package/src/commands/native/item/shared/scope.js +22 -0
  223. package/src/commands/native/item/shared/search-command.js +61 -0
  224. package/src/commands/native/item/shared/search-options.js +150 -0
  225. package/src/commands/native/item/shared/search.js +158 -0
  226. package/src/commands/native/member/commands.index.json +60 -0
  227. package/src/commands/native/member/customer-level/get/command.js +122 -0
  228. package/src/commands/native/member/customer-level/get/schema.json +300 -0
  229. package/src/commands/native/member/domain.json +3 -0
  230. package/src/commands/native/member/growth/get/command.js +64 -0
  231. package/src/commands/native/member/growth/get/schema.json +283 -0
  232. package/src/commands/native/member/growth-log/list/command.js +203 -0
  233. package/src/commands/native/member/growth-log/list/schema.json +695 -0
  234. package/src/commands/native/member/level/get/command.js +70 -0
  235. package/src/commands/native/member/level/get/query.js +125 -0
  236. package/src/commands/native/member/level/get/schema.json +339 -0
  237. package/src/commands/native/member/level/list/command.js +50 -0
  238. package/src/commands/native/member/level/list/query.js +109 -0
  239. package/src/commands/native/member/level/list/schema.json +104 -0
  240. package/src/commands/native/member/membership/get/command.js +78 -0
  241. package/src/commands/native/member/membership/get/schema.json +283 -0
  242. package/src/commands/native/order/commands.index.json +33 -0
  243. package/src/commands/native/order/domain.json +3 -0
  244. package/src/commands/native/order/order/get/command.js +155 -0
  245. package/src/commands/native/order/order/get/schema.json +1167 -0
  246. package/src/commands/native/order/order/list/command.js +230 -0
  247. package/src/commands/native/order/order/list/schema.json +1363 -0
  248. package/src/commands/native/order/order/scan/command.js +148 -0
  249. package/src/commands/native/order/order/scan/scan.js +89 -0
  250. package/src/commands/native/order/order/scan/schema.json +1445 -0
  251. package/src/commands/native/order/shared/projection.js +183 -0
  252. package/src/commands/native/order/shared/query.js +84 -0
  253. package/src/commands/native/order/shared/search.js +112 -0
  254. package/src/commands/native/org/commands.index.json +42 -0
  255. package/src/commands/native/org/domain.json +3 -0
  256. package/src/commands/native/org/shared/single-staff.js +115 -0
  257. package/src/commands/native/org/staff/get/command.js +148 -0
  258. package/src/commands/native/org/staff/get/schema.json +114 -0
  259. package/src/commands/native/org/staff-role/get/command.js +45 -0
  260. package/src/commands/native/org/staff-role/get/schema.json +93 -0
  261. package/src/commands/native/org/unit/get/command.js +131 -0
  262. package/src/commands/native/org/unit/get/schema.json +478 -0
  263. package/src/commands/native/org/unit/list/command.js +187 -0
  264. package/src/commands/native/org/unit/list/schema.json +828 -0
  265. package/src/commands/native/points/account/get/command.js +65 -0
  266. package/src/commands/native/points/account/get/schema.json +303 -0
  267. package/src/commands/native/points/commands.index.json +33 -0
  268. package/src/commands/native/points/domain.json +3 -0
  269. package/src/commands/native/points/log/list/command.js +141 -0
  270. package/src/commands/native/points/log/list/schema.json +761 -0
  271. package/src/commands/native/points/rule/list/command.js +82 -0
  272. package/src/commands/native/points/rule/list/schema.json +294 -0
  273. package/src/commands/native/privacy/commands.index.json +15 -0
  274. package/src/commands/native/privacy/domain.json +3 -0
  275. package/src/commands/native/privacy/field/decrypt/command.js +185 -0
  276. package/src/commands/native/privacy/field/decrypt/schema.json +656 -0
  277. package/src/commands/native/privacy/shared/order-source.js +33 -0
  278. package/src/commands/native/stock/commands.index.json +15 -0
  279. package/src/commands/native/stock/domain.json +3 -0
  280. package/src/commands/native/stock/log/list/command.js +207 -0
  281. package/src/commands/native/stock/log/list/schema.json +922 -0
  282. package/src/commands/native/valuecard/card/get/command.js +107 -0
  283. package/src/commands/native/valuecard/card/get/schema.json +683 -0
  284. package/src/commands/native/valuecard/card/list/command.js +136 -0
  285. package/src/commands/native/valuecard/card/list/pagination.js +23 -0
  286. package/src/commands/native/valuecard/card/list/schema.json +780 -0
  287. package/src/commands/native/valuecard/commands.index.json +24 -0
  288. package/src/commands/native/valuecard/domain.json +3 -0
  289. package/src/commands/native/valuecard/shared/projection.js +57 -0
  290. package/src/commands/system/api.js +47 -0
  291. package/src/commands/system/auth.js +118 -0
  292. package/src/commands/system/contracts.js +373 -0
  293. package/src/commands/system/doctor.js +24 -0
  294. package/src/commands/system/install.js +41 -0
  295. package/src/commands/system/printer.js +16 -0
  296. package/src/commands/system/schema.js +162 -0
  297. package/src/commands/system/shop-guidance.js +9 -0
  298. package/src/commands/system/shop.js +237 -0
  299. package/src/commands/system/skills.js +49 -0
  300. package/src/execution/beijing-date-time.js +29 -0
  301. package/src/execution/beijing-time.js +21 -0
  302. package/src/execution/bounded-input.js +42 -0
  303. package/src/execution/command-io.js +137 -0
  304. package/src/execution/command-policy.js +41 -0
  305. package/src/execution/command-schema.js +131 -0
  306. package/src/execution/datetime.js +83 -0
  307. package/src/execution/error-details.js +399 -0
  308. package/src/execution/error-model.js +82 -0
  309. package/src/execution/exact-json.js +80 -0
  310. package/src/execution/list-total.js +10 -0
  311. package/src/execution/money.js +59 -0
  312. package/src/execution/parser-error.js +66 -0
  313. package/src/execution/privacy.js +197 -0
  314. package/src/execution/public-schema.js +52 -0
  315. package/src/execution/query-api.js +101 -0
  316. package/src/execution/range.js +84 -0
  317. package/src/execution/request-state.js +55 -0
  318. package/src/execution/schema-completeness.js +116 -0
  319. package/src/execution/shop-query.js +54 -0
  320. package/src/execution/target-shop-default.js +23 -0
  321. package/src/execution/target-shop.js +49 -0
  322. package/src/identity/context-store.js +54 -0
  323. package/src/identity/context.js +38 -0
  324. package/src/installation/install.js +158 -0
  325. package/src/installation/npm-error.js +93 -0
  326. package/src/installation/skill.js +113 -0
  327. package/src/transport/account-api.js +152 -0
  328. package/src/transport/api.js +199 -0
  329. package/src/transport/shop-app.js +63 -0
@@ -0,0 +1,898 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "input": {
4
+ "type": "object",
5
+ "description": "CLI完成解析及上下文补全后的业务输入;原始选项与默认值见options,不直接传入JSON。",
6
+ "required": [
7
+ "kind",
8
+ "kdtId",
9
+ "state",
10
+ "pageNo",
11
+ "pageSize"
12
+ ],
13
+ "additionalProperties": false,
14
+ "properties": {
15
+ "kind": {
16
+ "$ref": "#/definitions/kind"
17
+ },
18
+ "kdtId": {
19
+ "$ref": "#/definitions/positiveInteger",
20
+ "description": "目标店铺ID;默认有效context.shopId,非总部不可跨店。"
21
+ },
22
+ "state": {
23
+ "type": "integer",
24
+ "enum": [
25
+ 0,
26
+ 1,
27
+ 2,
28
+ 3
29
+ ],
30
+ "description": "活动筛选,数字0全部、1未开始、2活动中、3已结束;默认0,不是返回status的字典。"
31
+ },
32
+ "keyword": {
33
+ "type": "string",
34
+ "minLength": 1,
35
+ "pattern": "^[^\\u0000-\\u001f\\u007f-\\u009f]+$",
36
+ "description": "活动名称关键字;trim后非空,不含控制字符,服务端模糊查询,不在本地过滤。"
37
+ },
38
+ "pageNo": {
39
+ "type": "integer",
40
+ "minimum": 1,
41
+ "maximum": 1000,
42
+ "description": "要读取的页码,从1开始,默认1,最多1000。"
43
+ },
44
+ "pageSize": {
45
+ "type": "integer",
46
+ "minimum": 1,
47
+ "maximum": 200,
48
+ "description": "每页条数上限,默认20,最多200。"
49
+ }
50
+ }
51
+ },
52
+ "output": {
53
+ "type": "object",
54
+ "required": [
55
+ "data"
56
+ ],
57
+ "additionalProperties": false,
58
+ "description": "同次查询的一页活动与分页信息;只有完整校验通过才输出。",
59
+ "properties": {
60
+ "data": {
61
+ "type": "object",
62
+ "required": [
63
+ "lotteries",
64
+ "pagination"
65
+ ],
66
+ "additionalProperties": false,
67
+ "description": "本次玩法和筛选范围内的查询结果。",
68
+ "properties": {
69
+ "lotteries": {
70
+ "type": "array",
71
+ "maxItems": 200,
72
+ "items": {
73
+ "$ref": "#/definitions/lottery"
74
+ },
75
+ "description": "本页活动摘要;空数组不证明全局不存在,可选字段缺失省略。"
76
+ },
77
+ "pagination": {
78
+ "type": "object",
79
+ "required": [
80
+ "pageNo",
81
+ "pageSize",
82
+ "hasMore",
83
+ "nextPageNo",
84
+ "windowLimitReached"
85
+ ],
86
+ "additionalProperties": false,
87
+ "description": "本次查询范围的分页信号;total 不保证跨页快照。",
88
+ "properties": {
89
+ "pageNo": {
90
+ "type": "integer",
91
+ "minimum": 1,
92
+ "maximum": 1000,
93
+ "description": "本次返回页码,必须与请求一致。"
94
+ },
95
+ "pageSize": {
96
+ "type": "integer",
97
+ "minimum": 1,
98
+ "maximum": 200,
99
+ "description": "本次采用的每页条数上限,必须与请求一致,不是实际条数。"
100
+ },
101
+ "total": {
102
+ "$ref": "#/definitions/nonNegativeInteger",
103
+ "description": "匹配本次查询条件的总记录数,不是当前页返回条数;上游未提供可确认总数时省略。",
104
+ "type": "integer",
105
+ "minimum": 0
106
+ },
107
+ "hasMore": {
108
+ "type": ["boolean", "null"],
109
+ "description": "true 表示还有后续页,false 表示已确认没有后续页;无法确定时为 null,不以空页或短页推算。"
110
+ },
111
+ "nextPageNo": {
112
+ "type": [
113
+ "integer",
114
+ "null"
115
+ ],
116
+ "minimum": 1,
117
+ "maximum": 1000,
118
+ "description": "已确认且未超过页码上限的下一页;无法确认或到达上限时为 null。"
119
+ },
120
+ "windowLimitReached": {
121
+ "type": "boolean",
122
+ "description": "仍有后续但已到本入口页码上限时为 true;不能宣称已取完或继续请求下一页。"
123
+ }
124
+ }
125
+ }
126
+ }
127
+ }
128
+ }
129
+ },
130
+ "preview": {
131
+ "type": "object",
132
+ "required": [
133
+ "scope",
134
+ "prerequisites",
135
+ "requests",
136
+ "limits"
137
+ ],
138
+ "additionalProperties": false,
139
+ "description": "本地查询计划;零认证、零网络,不证明对象存在、权限或结果。",
140
+ "properties": {
141
+ "scope": {
142
+ "$ref": "#/definitions/scope"
143
+ },
144
+ "prerequisites": {
145
+ "type": "array",
146
+ "const": [
147
+ "context",
148
+ "token-shop-binding"
149
+ ],
150
+ "items": {
151
+ "type": "string",
152
+ "description": "字符串context表示有效上下文,token-shop-binding表示同店凭证核验。"
153
+ }
154
+ },
155
+ "requests": {
156
+ "type": "array",
157
+ "minItems": 2,
158
+ "maxItems": 2,
159
+ "additionalItems": false,
160
+ "description": "按顺序核验店铺并查询一页活动,最多两次业务请求。",
161
+ "items": [
162
+ {
163
+ "type": "object",
164
+ "required": [
165
+ "method",
166
+ "api",
167
+ "body"
168
+ ],
169
+ "additionalProperties": false,
170
+ "properties": {
171
+ "method": {
172
+ "type": "string",
173
+ "const": "POST",
174
+ "description": "字符串POST表示读取请求使用POST方法。"
175
+ },
176
+ "api": {
177
+ "type": "string",
178
+ "const": "youzan.shop.basic.get/3.0.0",
179
+ "description": "本次同店核验接口与版本。"
180
+ },
181
+ "body": {
182
+ "type": "object",
183
+ "additionalProperties": false,
184
+ "description": "无参数店铺核验,不补写目标ID。"
185
+ }
186
+ }
187
+ },
188
+ {
189
+ "type": "object",
190
+ "required": [
191
+ "method",
192
+ "api",
193
+ "body"
194
+ ],
195
+ "additionalProperties": false,
196
+ "properties": {
197
+ "method": {
198
+ "type": "string",
199
+ "const": "POST",
200
+ "description": "字符串POST表示读取请求使用POST方法。"
201
+ },
202
+ "api": {
203
+ "type": "string",
204
+ "const": "youzan.ump.lottery.list/1.0.0",
205
+ "description": "本次活动列表接口与版本。"
206
+ },
207
+ "body": {
208
+ "type": "object",
209
+ "required": [
210
+ "search_condition_d_t_o"
211
+ ],
212
+ "additionalProperties": false,
213
+ "properties": {
214
+ "search_condition_d_t_o": {
215
+ "type": "object",
216
+ "required": [
217
+ "state",
218
+ "app_name",
219
+ "page_no",
220
+ "page_size"
221
+ ],
222
+ "additionalProperties": false,
223
+ "description": "同次查询的筛选条件对象,不是JSON字符串。",
224
+ "properties": {
225
+ "state": {
226
+ "type": "integer",
227
+ "enum": [
228
+ 0,
229
+ 1,
230
+ 2,
231
+ 3
232
+ ],
233
+ "description": "数字0全部、1未开始、2活动中、3已结束,默认0。"
234
+ },
235
+ "app_name": {
236
+ "$ref": "#/definitions/kind"
237
+ },
238
+ "page_no": {
239
+ "type": "integer",
240
+ "minimum": 1,
241
+ "maximum": 1000,
242
+ "description": "本次页码,默认1。"
243
+ },
244
+ "page_size": {
245
+ "type": "integer",
246
+ "minimum": 1,
247
+ "maximum": 200,
248
+ "description": "本次每页条数上限,默认20。"
249
+ },
250
+ "keyword": {
251
+ "type": "string",
252
+ "minLength": 1,
253
+ "description": "规范化后的活动名称查询关键字。"
254
+ }
255
+ }
256
+ }
257
+ }
258
+ }
259
+ }
260
+ }
261
+ ]
262
+ },
263
+ "limits": {
264
+ "type": "object",
265
+ "required": [
266
+ "maxBusinessRequests",
267
+ "bindingResponseBytes",
268
+ "queryResponseBytes"
269
+ ],
270
+ "additionalProperties": false,
271
+ "description": "内部请求及接收正文预算,非业务输入。",
272
+ "properties": {
273
+ "maxBusinessRequests": {
274
+ "type": "integer",
275
+ "const": 2,
276
+ "description": "最多一次核验加一次主请求,不重放。"
277
+ },
278
+ "bindingResponseBytes": {
279
+ "type": "integer",
280
+ "const": 524288,
281
+ "description": "核验响应最多512 KiB,超出整体失败。"
282
+ },
283
+ "queryResponseBytes": {
284
+ "type": "integer",
285
+ "const": 8388608,
286
+ "description": "主响应最多8 MiB,超出整体失败,不截断。"
287
+ }
288
+ }
289
+ }
290
+ }
291
+ },
292
+ "error": {
293
+ "type": "object",
294
+ "required": [
295
+ "success",
296
+ "code",
297
+ "message",
298
+ "details"
299
+ ],
300
+ "additionalProperties": false,
301
+ "properties": {
302
+ "success": {
303
+ "const": false,
304
+ "description": "布尔false表示本次查询失败。"
305
+ },
306
+ "code": {
307
+ "const": -10001,
308
+ "description": "数字-10001表示CLI查询错误。"
309
+ },
310
+ "message": {
311
+ "type": "string",
312
+ "minLength": 1,
313
+ "description": "本地生成的安全错误说明,不回显上游自由文本。"
314
+ },
315
+ "details": {
316
+ "type": "object",
317
+ "required": [
318
+ "command",
319
+ "category",
320
+ "stage",
321
+ "targetScope",
322
+ "requestState",
323
+ "nextStep",
324
+ "errorVersion",
325
+ "recovery",
326
+ "execution"
327
+ ],
328
+ "additionalProperties": false,
329
+ "properties": {
330
+ "command": {
331
+ "const": "interaction.lottery.list"
332
+ },
333
+ "category": {
334
+ "type": "string",
335
+ "enum": [
336
+ "parameter",
337
+ "validation",
338
+ "configuration",
339
+ "authentication",
340
+ "permission",
341
+ "scope_unresolved",
342
+ "transport",
343
+ "http",
344
+ "protocol",
345
+ "business_rejected",
346
+ "not_found",
347
+ "limit"
348
+ ],
349
+ "description": "字符串parameter参数解析、validation输入校验、configuration上下文或配置、authentication认证、permission权限、scope_unresolved目标范围、transport传输、http其他HTTP错误、protocol协议模型、business_rejected业务拒绝、not_found明确不存在、limit预算超限。"
350
+ },
351
+ "stage": {
352
+ "type": "string",
353
+ "enum": [
354
+ "context",
355
+ "input",
356
+ "configuration",
357
+ "shop-binding",
358
+ "query",
359
+ "response"
360
+ ],
361
+ "description": "字符串context上下文、input输入、configuration运行配置、shop-binding店铺核验、query主查询成败、response正文预算和适配。"
362
+ },
363
+ "targetScope": {
364
+ "type": "object",
365
+ "additionalProperties": false,
366
+ "properties": {
367
+ "kdtId": {
368
+ "$ref": "#/definitions/positiveInteger",
369
+ "description": "已确定的目标店铺,未确定时不出现。"
370
+ }
371
+ }
372
+ },
373
+ "requestState": {
374
+ "type": "string",
375
+ "enum": [
376
+ "not_sent",
377
+ "sent",
378
+ "unknown"
379
+ ],
380
+ "description": "字符串not_sent表示当前阶段未发送,sent表示已取得响应或收到正文超限,unknown表示无法确定发送及结果;核验已发送而主请求未发送仍为sent。"
381
+ },
382
+ "nextStep": {
383
+ "type": "string",
384
+ "minLength": 1,
385
+ "description": "核对原店铺、玩法、筛选或权限的安全动作。"
386
+ },
387
+ "api": {
388
+ "type": "string",
389
+ "description": "实际取得诊断的接口及版本。"
390
+ },
391
+ "httpStatus": {
392
+ "type": "integer",
393
+ "minimum": 100,
394
+ "maximum": 599,
395
+ "description": "实际HTTP状态码,401认证失败、403权限拒绝,其他失败不猜测业务含义。"
396
+ },
397
+ "businessCode": {
398
+ "$ref": "#/definitions/diagnosticCode",
399
+ "description": "安全原始业务码;1605405001参数有误、1605407001店铺信息获取失败,均非活动不存在。"
400
+ },
401
+ "gatewayCode": {
402
+ "$ref": "#/definitions/diagnosticCode",
403
+ "description": "实际取得的安全网关码,不解释未知值。"
404
+ },
405
+ "trace_id": {
406
+ "type": "string",
407
+ "pattern": "^[a-zA-Z0-9_-]{1,128}$",
408
+ "description": "实际取得的安全追踪标识。"
409
+ },
410
+ "request_id": {
411
+ "type": "string",
412
+ "pattern": "^[a-zA-Z0-9_-]{1,128}$",
413
+ "description": "实际取得的安全请求标识。"
414
+ },
415
+ "errorVersion": {
416
+ "const": 2,
417
+ "description": "本命令采用错误诊断协议第二版。"
418
+ },
419
+ "issues": {
420
+ "type": "array",
421
+ "minItems": 1,
422
+ "maxItems": 16,
423
+ "items": {
424
+ "$ref": "#/definitions/diagnosticIssue"
425
+ },
426
+ "description": "最多十六个已定位问题,不包含收到的原值。"
427
+ },
428
+ "issuesTruncated": {
429
+ "const": true,
430
+ "description": "问题超过返回上限,当前列表没有穷尽全部问题。"
431
+ },
432
+ "recovery": {
433
+ "$ref": "#/definitions/diagnosticRecovery",
434
+ "description": "受限的恢复说明,不会自动执行。"
435
+ },
436
+ "execution": {
437
+ "$ref": "#/definitions/diagnosticExecution",
438
+ "description": "整次调用的请求观察,独立于失败阶段的 requestState。"
439
+ }
440
+ }
441
+ }
442
+ }
443
+ },
444
+ "definitions": {
445
+ "safeInteger": {
446
+ "type": "integer",
447
+ "minimum": -9007199254740991,
448
+ "maximum": 9007199254740991
449
+ },
450
+ "positiveInteger": {
451
+ "type": "integer",
452
+ "minimum": 1,
453
+ "maximum": 9007199254740991
454
+ },
455
+ "nonNegativeInteger": {
456
+ "type": "integer",
457
+ "minimum": 0,
458
+ "maximum": 9007199254740991
459
+ },
460
+ "kind": {
461
+ "type": "string",
462
+ "enum": [
463
+ "cards",
464
+ "wheel",
465
+ "zodiac",
466
+ "crazyguess",
467
+ "shake"
468
+ ],
469
+ "description": "玩法字符串cards刮刮卡、wheel幸运大抽奖、zodiac生肖翻翻看、crazyguess疯狂猜猜猜、shake有赞摇一摇;必须明确选择,不默认wheel。"
470
+ },
471
+ "scope": {
472
+ "type": "object",
473
+ "required": [
474
+ "kdtId"
475
+ ],
476
+ "additionalProperties": false,
477
+ "properties": {
478
+ "kdtId": {
479
+ "$ref": "#/definitions/positiveInteger",
480
+ "description": "本次核验及查询的目标店铺ID。"
481
+ }
482
+ }
483
+ },
484
+ "diagnosticCode": {
485
+ "oneOf": [
486
+ {
487
+ "$ref": "#/definitions/safeInteger"
488
+ },
489
+ {
490
+ "type": "string",
491
+ "pattern": "^-?\\d{1,12}$"
492
+ }
493
+ ]
494
+ },
495
+ "lottery": {
496
+ "type": "object",
497
+ "required": [
498
+ "activityId",
499
+ "title",
500
+ "kind",
501
+ "status"
502
+ ],
503
+ "additionalProperties": false,
504
+ "description": "当前查询范围的一条抽奖活动摘要;不含客户参与或资产到账事实。",
505
+ "properties": {
506
+ "activityId": {
507
+ "$ref": "#/definitions/positiveInteger",
508
+ "description": "抽奖活动ID,用于定位活动,区别于奖项或实际奖励资产ID。"
509
+ },
510
+ "title": {
511
+ "type": "string",
512
+ "pattern": "\\S",
513
+ "description": "非空活动名称。"
514
+ },
515
+ "kind": {
516
+ "$ref": "#/definitions/kind"
517
+ },
518
+ "status": {
519
+ "$ref": "#/definitions/safeInteger",
520
+ "description": "活动状态,数字1未开始、2进行中、3暂停中、4已结束;未知安全整数原样保留,与输入state分别解释,不按时钟重算。"
521
+ },
522
+ "alias": {
523
+ "type": "string",
524
+ "minLength": 1,
525
+ "description": "活动别名,不当作数字活动ID。"
526
+ },
527
+ "startsAt": {
528
+ "type": "string",
529
+ "format": "beijing-date-time-ms",
530
+ "description": "活动开始时间,固定北京时间YYYY-MM-DD HH:mm:ss.SSS,年份0001..9999;毫秒0为1970-01-01 08:00:00.000,不作永久哨兵。"
531
+ },
532
+ "endsAt": {
533
+ "type": "string",
534
+ "format": "beijing-date-time-ms",
535
+ "description": "活动结束时间,固定北京时间YYYY-MM-DD HH:mm:ss.SSS,年份0001..9999;毫秒0正常转换,不作永久哨兵。"
536
+ },
537
+ "limits": {
538
+ "type": "object",
539
+ "minProperties": 1,
540
+ "additionalProperties": false,
541
+ "description": "已返回的参与次数限制;缺失不代表无限次。",
542
+ "properties": {
543
+ "type": {
544
+ "$ref": "#/definitions/safeInteger",
545
+ "description": "数字1一天N次、2一人N次,N取count;未知安全整数保留,不猜测周期。"
546
+ },
547
+ "count": {
548
+ "$ref": "#/definitions/nonNegativeInteger",
549
+ "description": "参与限制次数N,单位次;与type共同解释,缺失不补0或无限。"
550
+ }
551
+ }
552
+ },
553
+ "awards": {
554
+ "type": "array",
555
+ "description": "本次返回奖项摘要,缺失省略,空数组不证明历史无奖品;不补查详情,不代表已获奖。",
556
+ "items": {
557
+ "type": "object",
558
+ "required": [
559
+ "awardId"
560
+ ],
561
+ "additionalProperties": false,
562
+ "properties": {
563
+ "awardId": {
564
+ "$ref": "#/definitions/positiveInteger",
565
+ "description": "奖项配置ID,区别于活动及实际奖励资产ID。"
566
+ },
567
+ "name": {
568
+ "type": "string",
569
+ "description": "奖项展示名称,保留空串。"
570
+ }
571
+ }
572
+ }
573
+ },
574
+ "statistics": {
575
+ "type": "object",
576
+ "minProperties": 1,
577
+ "additionalProperties": false,
578
+ "description": "已返回的活动汇总计数,不派生转化率或保证实时、去重及总和关系。",
579
+ "properties": {
580
+ "participantCount": {
581
+ "$ref": "#/definitions/nonNegativeInteger",
582
+ "description": "活动总参与人数,单位人。"
583
+ },
584
+ "participationCount": {
585
+ "$ref": "#/definitions/nonNegativeInteger",
586
+ "description": "活动总参与次数,单位次。"
587
+ },
588
+ "winningCount": {
589
+ "$ref": "#/definitions/nonNegativeInteger",
590
+ "description": "活动中奖次数,单位次,不等于中奖人数。"
591
+ },
592
+ "winnerCount": {
593
+ "$ref": "#/definitions/nonNegativeInteger",
594
+ "description": "活动中奖人数,单位人。"
595
+ },
596
+ "nonWinnerCount": {
597
+ "$ref": "#/definitions/nonNegativeInteger",
598
+ "description": "活动未中奖人数,单位人,具体去重口径未公开。"
599
+ }
600
+ }
601
+ }
602
+ }
603
+ },
604
+ "diagnosticExpected": {
605
+ "type": "object",
606
+ "additionalProperties": false,
607
+ "required": [],
608
+ "properties": {
609
+ "type": {
610
+ "anyOf": [
611
+ {
612
+ "type": "string",
613
+ "description": "预期的 JSON 类型。"
614
+ },
615
+ {
616
+ "type": "array",
617
+ "items": {
618
+ "type": "string",
619
+ "description": "预期的 JSON 类型。"
620
+ }
621
+ }
622
+ ],
623
+ "description": "同版模型允许的类型。"
624
+ },
625
+ "enum": {
626
+ "type": "array",
627
+ "items": {
628
+ "anyOf": [
629
+ {
630
+ "type": "string"
631
+ },
632
+ {
633
+ "type": "number"
634
+ },
635
+ {
636
+ "type": "boolean"
637
+ },
638
+ {
639
+ "type": "null"
640
+ }
641
+ ],
642
+ "description": "契约声明的静态标量约束。"
643
+ },
644
+ "description": "同版模型允许的静态值。"
645
+ },
646
+ "const": {
647
+ "anyOf": [
648
+ {
649
+ "type": "string"
650
+ },
651
+ {
652
+ "type": "number"
653
+ },
654
+ {
655
+ "type": "boolean"
656
+ },
657
+ {
658
+ "type": "null"
659
+ }
660
+ ],
661
+ "description": "契约声明的静态标量约束。"
662
+ },
663
+ "minimum": {
664
+ "type": "number",
665
+ "description": "包含的最小值。"
666
+ },
667
+ "maximum": {
668
+ "type": "number",
669
+ "description": "包含的最大值。"
670
+ },
671
+ "exclusiveMinimum": {
672
+ "type": "number",
673
+ "description": "不包含的最小值。"
674
+ },
675
+ "exclusiveMaximum": {
676
+ "type": "number",
677
+ "description": "不包含的最大值。"
678
+ },
679
+ "minLength": {
680
+ "type": "integer",
681
+ "description": "最少字符数。"
682
+ },
683
+ "maxLength": {
684
+ "type": "integer",
685
+ "description": "最多字符数。"
686
+ },
687
+ "minItems": {
688
+ "type": "integer",
689
+ "description": "最少元素数。"
690
+ },
691
+ "maxItems": {
692
+ "type": "integer",
693
+ "description": "最多元素数。"
694
+ },
695
+ "format": {
696
+ "type": "string",
697
+ "description": "同版模型声明的格式。"
698
+ },
699
+ "pattern": {
700
+ "type": "string",
701
+ "description": "同版模型声明的字符约束。"
702
+ },
703
+ "additionalProperties": {
704
+ "const": false,
705
+ "description": "对象拒绝契约以外的属性。"
706
+ },
707
+ "contains": {
708
+ "type": "object",
709
+ "additionalProperties": false,
710
+ "required": [
711
+ "const"
712
+ ],
713
+ "properties": {
714
+ "const": {
715
+ "anyOf": [
716
+ {
717
+ "type": "string"
718
+ },
719
+ {
720
+ "type": "number"
721
+ },
722
+ {
723
+ "type": "boolean"
724
+ },
725
+ {
726
+ "type": "null"
727
+ }
728
+ ],
729
+ "description": "契约声明的静态标量约束。"
730
+ }
731
+ }
732
+ },
733
+ "items": {
734
+ "type": "object",
735
+ "additionalProperties": false,
736
+ "required": [
737
+ "enum"
738
+ ],
739
+ "properties": {
740
+ "enum": {
741
+ "type": "array",
742
+ "items": {
743
+ "anyOf": [
744
+ {
745
+ "type": "string"
746
+ },
747
+ {
748
+ "type": "number"
749
+ },
750
+ {
751
+ "type": "boolean"
752
+ },
753
+ {
754
+ "type": "null"
755
+ }
756
+ ],
757
+ "description": "契约声明的静态标量约束。"
758
+ },
759
+ "description": "元素允许的静态值。"
760
+ }
761
+ }
762
+ }
763
+ }
764
+ },
765
+ "diagnosticIssue": {
766
+ "type": "object",
767
+ "additionalProperties": false,
768
+ "required": [
769
+ "source",
770
+ "reason"
771
+ ],
772
+ "properties": {
773
+ "source": {
774
+ "enum": [
775
+ "argv",
776
+ "input",
777
+ "context",
778
+ "output",
779
+ "preview"
780
+ ],
781
+ "description": "问题所属的参数、输入、上下文、结果或预览模型。"
782
+ },
783
+ "path": {
784
+ "type": "string",
785
+ "description": "对应模型中的 JSON Pointer;不含原始输入或动态字典键。"
786
+ },
787
+ "option": {
788
+ "type": "string",
789
+ "description": "可定位时给出的已注册 CLI 选项。"
790
+ },
791
+ "reason": {
792
+ "enum": [
793
+ "required",
794
+ "invalid_type",
795
+ "invalid_choice",
796
+ "out_of_range",
797
+ "invalid_format",
798
+ "conditional_required",
799
+ "constraint",
800
+ "unexpected_property",
801
+ "unknown_option",
802
+ "unknown_command",
803
+ "excess_arguments",
804
+ "missing_value"
805
+ ],
806
+ "description": "字段违反的约束类型,原始值不回显。"
807
+ },
808
+ "expected": {
809
+ "$ref": "#/definitions/diagnosticExpected",
810
+ "description": "同版契约的静态预期。"
811
+ },
812
+ "relatedPaths": {
813
+ "type": "array",
814
+ "items": {
815
+ "type": "string",
816
+ "description": "关联字段的 JSON Pointer。"
817
+ },
818
+ "description": "触发条件约束的关联字段。"
819
+ }
820
+ }
821
+ },
822
+ "diagnosticRecovery": {
823
+ "type": "object",
824
+ "additionalProperties": false,
825
+ "required": [
826
+ "action",
827
+ "automaticBusinessRetry"
828
+ ],
829
+ "properties": {
830
+ "action": {
831
+ "enum": [
832
+ "correct_input",
833
+ "complete_authentication",
834
+ "request_access_review",
835
+ "stop_and_inspect"
836
+ ],
837
+ "description": "依次表示修正本地输入、补认证、核对权限或停止核查;仅是说明,不执行操作或授予权限。"
838
+ },
839
+ "automaticBusinessRetry": {
840
+ "const": false,
841
+ "description": "不据此自动重放业务请求。"
842
+ }
843
+ }
844
+ },
845
+ "diagnosticExecution": {
846
+ "type": "object",
847
+ "additionalProperties": false,
848
+ "required": [
849
+ "requestState",
850
+ "coverage",
851
+ "observedAttempts"
852
+ ],
853
+ "properties": {
854
+ "requestState": {
855
+ "enum": [
856
+ "not_sent",
857
+ "sent",
858
+ "unknown"
859
+ ],
860
+ "description": "整次调用尚未发送、已有发送记录或无法排除未知请求;不代表业务完成。"
861
+ },
862
+ "coverage": {
863
+ "enum": [
864
+ "complete",
865
+ "partial"
866
+ ],
867
+ "description": "请求观察覆盖全部已接入路径,或存在未观测路径;部分覆盖不能声明零请求。"
868
+ },
869
+ "observedAttempts": {
870
+ "type": "integer",
871
+ "minimum": 0,
872
+ "maximum": 9007199254740991,
873
+ "description": "本地已进入发送边界的观测次数下界,不是服务端执行次数。"
874
+ }
875
+ }
876
+ }
877
+ },
878
+ "api": {
879
+ "method": "POST",
880
+ "path": "youzan.ump.lottery.list/1.0.0"
881
+ },
882
+ "success": {
883
+ "description": "同店核验及主查询成功,整页活动和分页满足模型、范围及正文预算后输出一次;不输出部分结果。"
884
+ },
885
+ "errors": {
886
+ "description": "失败stdout为空,stderr单条脱敏JSON,退出1;不自动重试、切店、换token或以失败空数组报告成功。",
887
+ "diagnosticsVersion": 2
888
+ },
889
+ "notes": [
890
+ "支持微商城单店、教育多校区总部。需要有效上下文、同店凭证及服务端授权;at可用和店铺核验不证明产品或员工权限。",
891
+ "只读取指定玩法、state和keyword下的一页;hasMore为true时保持筛选与pageSize逐页读取,但1000页是可达上限,不保证无重无漏快照。",
892
+ "可选字段源缺失省略,已返回null、错型、不安全整数整体失败;未知未选择扩展不校验、不透传。",
893
+ "不返回ownerKdtId,不把目标店铺填成活动归属;不补查详情或透传废弃奖品字段。",
894
+ "最多一次店铺核验和一次主查询,核验响应512 KiB、主响应8 MiB,预算含边界;超限整体失败,不截断数组。",
895
+ "--dry-run零认证零网络,只证明本地计划;没有include、fields、selection、任意JSON或自动全分页。",
896
+ "total 是接口报告的本次筛选总数;继续读取 nextPageNo,windowLimitReached=true 时停止该入口,不把当前页当成全量。"
897
+ ]
898
+ }