You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何通过单次Jama API调用同时获取条目及其关联标签数据?

JAMA API 单次请求获取带关联标签条目数据方案
  • 直接利用JAMA API原生的关联资源嵌入能力,不需要拆分多次请求查询标签。
  • 单条条目查询:调用GET /items/{itemId}接口时,追加查询参数include=tags,返回结果会直接在条目属性中挂载所有关联标签数据,无需额外调用标签查询接口。
  • 批量条目查询:不要循环调用单条查询接口,直接使用列表类接口:
    • 全实例范围拉取用GET /items
    • 指定项目范围拉取用GET /projects/{projectId}/items
      接口同样携带include=tags参数,搭配分页参数startAt(分页偏移量,从0开始)、maxResults(单页返回条数,最大支持50),单次请求即可拉取最多50条携带完整标签信息的条目,请求量可从原有「N条条目对应2N次请求」压缩到「ceil(N/50)次请求」,查询效率提升明显。
  • 扩展用法:include参数支持同时传入多个关联资源,用英文逗号分隔即可,例如需要同时获取条目关联的标签、附件,传入include=tags,attachments即可,不需要为不同关联字段单独发起请求。

请求示例
单条查询:GET https://[你的JAMA实例域名]/rest/v1/items/123?include=tags
批量查询:GET https://[你的JAMA实例域名]/rest/v1/projects/45/items?include=tags&startAt=0&maxResults=50

内容的提问来源于stack exchange,提问作者Yelmalem

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.31 12:21:19