From ce61dbddeaeb0d1ad96bea1df2943a7018136c61 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Fri, 12 Jun 2026 11:23:54 +0800 Subject: [PATCH] =?UTF-8?q?changelog(v2):=20=E4=BF=9D=E9=99=A9=E4=BA=A7?= =?UTF-8?q?=E5=93=81=E5=85=A8=E9=87=8F=E5=88=97=E8=A1=A8=E6=8E=A5=E5=8F=A3?= =?UTF-8?q?(=E4=B8=8D=E5=88=86=E9=A1=B5)=E4=BF=AE=E5=A4=8D=E6=96=B9?= =?UTF-8?q?=E6=A1=88=E5=BC=B9=E7=AA=97=20pageSize=3D200=20=E6=8A=A5?= =?UTF-8?q?=E9=94=99=20(PR=20#3717)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...©äº§å“å…¨é‡åˆ—表接å£ä¸åˆ†é¡µ-新增接å£-管ç†åŽå°.md | 63 +++++++++++++++++++ 1 file changed, 63 insertions(+) create mode 100644 changelogs-v2/2026-06/12_3717_ä¿é™©äº§å“å…¨é‡åˆ—表接å£ä¸åˆ†é¡µ-新增接å£-管ç†åŽå°.md diff --git a/changelogs-v2/2026-06/12_3717_ä¿é™©äº§å“å…¨é‡åˆ—表接å£ä¸åˆ†é¡µ-新增接å£-管ç†åŽå°.md b/changelogs-v2/2026-06/12_3717_ä¿é™©äº§å“å…¨é‡åˆ—表接å£ä¸åˆ†é¡µ-新增接å£-管ç†åŽå°.md new file mode 100644 index 0000000..22d777d --- /dev/null +++ b/changelogs-v2/2026-06/12_3717_ä¿é™©äº§å“å…¨é‡åˆ—表接å£ä¸åˆ†é¡µ-新增接å£-管ç†åŽå°.md @@ -0,0 +1,63 @@ +# ã€æ–°å¢žæŽ¥å£Â·ç®¡ç†åŽå°ã€‘ä¿é™©ç®¡ç†â€”—ä¿é™©äº§å“å…¨é‡åˆ—表(ä¸åˆ†é¡µ),ä¿®å¤æ–¹æ¡ˆå¼¹çª— pageSize=200 报错 + +> æœåŠ¡:hl-order-service-v3(8086/8186) | 分支:dev-v3 | PR:#3717 | 已部署测试æœå¹¶å®žæµ‹é€šè¿‡(2026-06-12) +> 背景:ä¿é™©æ–¹æ¡ˆæ–°å¢žå¼¹çª—的产å“下拉调 `GET /v3/admin/insurance/products?page=1&pageSize=200` è¢«å…¨å±€åˆ†é¡µä¸Šé™æ‹¦æˆª,页é¢çº¢ toast「æ¯é¡µæ¡æ•°æœ€å¤§ä¸º100〠+ +## âš ï¸ å…³é”®è¯´æ˜Ž + +1. **`pageSize` 全平å°ä¸Šé™æ˜¯ 100**(PageParam 全局校验,所有分页接å£ä¸€è‡´),ä¼  >100 一律返 `code=400`「æ¯é¡µæ¡æ•°æœ€å¤§ä¸º100ã€ã€‚**请勿用大 pageSize æ¨¡æ‹Ÿå…¨é‡æ‹‰å–**。 +2. 需è¦å…¨éƒ¨æ•°æ®çš„下拉/选择器场景,改用本次新增的**ä¸åˆ†é¡µå…¨é‡æŽ¥å£** `GET /v3/admin/insurance/products/all`。 +3. åŽŸåˆ†é¡µæŽ¥å£ `/products` 行为完全ä¸å˜,列表页继续用它。 + +## 1. 新增端点 + +`GET /v3/admin/insurance/products/all` + +### å…¥å‚(query) + +| 字段 | 类型 | å¿…å¡« | 说明 | +|---|---|---|---| +| isOverseas | boolean | å¦ | true=仅境外 / false=仅境内 / ä¸ä¼ =全部(方案弹窗「产å“类型ã€å•选å¯ç›´æŽ¥æ˜ å°„æ­¤å‚æ•°) | + +### 请求示例 + +```bash +# å…¨éƒ¨äº§å“ +curl -k "https://web.test.1814.love:9443/v3/admin/insurance/products/all" \ + -H "Authorization: Bearer {token}" + +# 仅境内(æ–¹æ¡ˆå¼¹çª—é€‰ã€Œå¢ƒå†…ã€æ—¶) +curl -k "https://web.test.1814.love:9443/v3/admin/insurance/products/all?isOverseas=false" \ + -H "Authorization: Bearer {token}" +``` + +### å“应示例(测试æœå®žæµ‹,当å‰å…¨é‡ 10 æ¡/境内 8 æ¡) + +```json +{ + "code": 200, + "message": "æˆåŠŸ", + "data": [ + { + "insuranceProductId": "2054773831589232641", + "productId": "2054773831589232641", + "productName": "山河令(太ä¿å±±ä¸œæ–°ï¼‰", + "productCode": "4810725b34654e1e88a7509e5b241c3a" + // ...其余字段与分页版 /products 的列表项完全一致(åŒä¸€ InsuranceProductVO) + } + ] +} +``` + +| å‡ºå‚ | 说明 | +|---|---| +| data | **直接是数组**(æ—  total/page 包装),元素结构与分页版列表项一致,å‰ç«¯å¯æ— ç¼å¤ç”¨æ¸²æŸ“逻辑 | + +## 2. 回归确认(测试æœå®žæµ‹) + +| 调用 | 结果 | +|---|---| +| `/products/all` | 200,è¿”å›žå…¨é‡ 10 æ¡ | +| `/products/all?isOverseas=false` | 200,返回境内 8 æ¡ | +| `/products?page=1&pageSize=200` | 400「æ¯é¡µæ¡æ•°æœ€å¤§ä¸º100ã€(ç»´æŒä¸å˜,å‰ç«¯è¯·æ”¹è°ƒ all) | +| `/products?page=1&pageSize=100` | 200,分页正常 |