Tensor 合集查询缺项：核对身份过滤、页码与验证字段
链小知 · 进阶 · 核验 · 依官方文档整理
把展示slug、合集ID、链上collection mint和first verified creator分开，再按原请求条件对照每页结果，解释列表缺项而非凭名称判断合集不存在。
开始前准备
- 一组已有脱敏的GET /api/v1/collections请求参数与响应；没有记录时可用本页方法schema逐项建立核对表。
- 记录请求日期、mainnet baseURL、sortBy、limit/page及过滤值；移除x-tensor-api-key，不上传凭据。
- 核对对象为Tensor Data API1.0.0 Alpha参考，非钱包资产列表或所有Solana链上合集。
1. 确认方法与请求资格
在官方Get Verified Collections页确认GET https://api.mainnet.tensordev.io/api/v1/collections。记录所在mainnet环境与参考版本，把响应文件和请求日期配对。
请求认证在x-tensor-api-key头；公开读文档不代表可以匿名调用。Quickstart的key申请对象是大型trader/market-maker或公共项目，先核对已有记录属于获准访问的产品，认证值留在原系统中。
检查结果：核对表保留baseURL、方法、日期及资格状态；没有响应的部分标“待核”，不填空列表。
2. 按身份字段选择过滤
把tensor.trade/trade/路径中的展示标识放入slugDisplays，响应的合集ID用collIds。vocs是verified on-chain collection mints，fvcs是first verified creators；不要把NFT单枚mint、展示名称或任意creator替代这两类过滤。
从已有记录选择一个身份条件核对；需要组合时完整保留原组合，不猜多个条件的AND/OR规则。原文写max 10 vocs/fvcs，不将它扩写成两组各10个的总20额度。
检查结果：每个过滤值都有来源与类型；同名合集仍用collId和对应链上身份分别记录。
3. 锁定排序与从1开始的页码
sortBy与limit必填，limit为1–100；page最小1。可按官方枚举写核对示例sortBy=slugDisplay:asc、limit=20、page=1；这只是参数示例，不是已调用结果。
比较第2页时保持同一sortBy、limit与过滤值。statsV2.volume24h:desc等滚动指标排序可能随着请求时刻变化，页面没有提供跨页固定快照承诺，不能仅因重复项断言后台错误。
检查结果：页号不是0起点，比较页的过滤与排序一致；请求时刻变化单独标出。
4. 逐页核对结果与缺项范围
响应使用collections数组、total和page，不是cursor/next分页。记录每页collections.length、响应page、total与全部collId；发现重复ID时先保留重复的位置，再计算这一组已取得记录的唯一ID数。
200空数组只能说明该时刻这组已记录条件下没有结果或到达空页；方法本身只描述verified collections，不等于全链合集全集。若total变化、缺中间页或仍未覆盖后续页，将盘点状态写成不完整。400保存message；422按Validation Error核对参数，不把错误页纳入资产计数。
检查结果：能说明缺项来自身份过滤、页缺失、排序变动、方法范围或仍未知；没有把缺项写成合集销毁。
5. 把验证、白名单和隐藏标记分列
准确读取tensorVerified、tensorWhitelisted、hidden与flagReason；这些字段不是同一个verified开关。slugDisplay、tokenStandard、tokenProgram、flagReason允许null；缺字段或null分别保留，不转成false、空字符串或假定SPL_TOKEN。
compressed和tokenProgram描述资产程序/形式，页面枚举也包含SPL_TOKEN_2022、MPL_CORE、BUBBLEGUM，但枚举不是所有交易流程支持验收。验证/白名单标记不等于版权授权、项目安全或图片真实性；对身份仍以对应mint/creator与collId核对。
检查结果：输出逐collId对照表，包含原始状态值、过滤来源、页与日期；未知标记没有被补成结论。
怎样确认完成
- 形成带请求条件、时间、页范围与collId的结果对照表。
- 每个遗漏项都有证据支持的分支或保留未知；区分验证/白名单/隐藏与资产真实性。
常见错误与边界
- 把slugDisplay、collId、collection mint与first verified creator视为同一个字符串。
- 把GET verified collections当全部链上合集，或将tensorWhitelisted自动解释为tensorVerified。
- 仅依据一页、滚动排序或400/422响应判断目标合集不存在。
- 此Alpha参考与当前实际API权限、费用和字段兼容未实测；不能把文档允许值当全部程序的当前交易支持。