erpnew/docs/2026-01-20_summary.md

2026-01-20 工作日志

背景

前端反馈“腾讯云搜图 API 一次只返回 10 条结果太少”，需要确认腾讯云 TIIA SearchImage 是否支持分页/返回条数控制，并在项目的简化搜图 API 中开放相应参数。

---

今日完成

1) TIIA 搜图接口支持分页参数（limit/offset）

确认腾讯云 TIIA SearchImage 支持 Limit（返回条数）与 Offset（偏移），其中 Limit 默认 10、最大 100。

项目侧改动：

• api_v1/views/tiia.py
  • POST /api/v1/tiia/search-image/ 新增可选入参：
    • limit：1~100
    • offset：>= 0
    • matchThreshold：0~100（可选）
  • 将以上参数透传到 api_v1/utils/tencentcloud_tiia.search_image_url_in_tencent_tiia()，从而调用 SDK 的 req.Limit/req.Offset/req.MatchThreshold

测试：

• api_v1/views/test_tiia_search_image_api.py
  • 新增用例覆盖 limit/offset/matchThreshold 透传与边界校验（limit>100、offset<0）