APS Forms API调用GET /photos?filter[type]=FORM仅返回单张照片，如何获取表单所有照片？

• 补充关键过滤参数：containerId
  仅用type=FORM会返回全平台所有表单的媒体文件，而非目标表单的专属内容。必须添加containerId参数，值为你要查询的表单ID，才能精准筛选出该表单关联的所有照片。

• 处理API分页机制
  APS媒体API默认启用分页，单页返回数量有限（通常默认10条）。如果表单照片数量超过单页限制，需检查响应体中的nextPageToken字段，携带该参数发起后续请求，迭代获取所有剩余照片。

• 正确的API调用示例
  发起GET请求到媒体端点：

  GET /construction/media?type=FORM&containerId={FORM_ID}&limit=100
  

  • 将{FORM_ID}替换为目标表单的实际ID
  • limit=100是API允许的最大单页返回量，可减少分页请求次数
  • 若响应包含nextPageToken，继续调用获取剩余数据：

    GET /construction/media?type=FORM&containerId={FORM_ID}&limit=100&pageToken={NEXT_PAGE_TOKEN}
    

• 验证权限完整性
  确保你的访问令牌拥有forms:read和media:read权限，权限不足会导致返回数据不完整或请求失败。

内容的提问来源于stack exchange，提问作者Rosh Ashrafi