如何用POSTMAN构建Contentful API查询关联字段的指定视频链接

核心思路
要同时基于person.name和关联video.title筛选并获取videoURL，需要利用Contentful的关联字段查询和内容展开（include）功能，通过GET请求一次性完成筛选与关联内容的拉取。

请求结构说明 #

基础端点：

https://cdn.contentful.com/spaces/{SPACE_ID}/entries

必填查询参数：

• access_token={ACCESS_TOKEN}：你的Contentful内容交付API令牌
• content_type=person：指定查询主内容类型为person
• include=1：展开一级关联内容（拉取videos字段对应的完整video条目，而非仅返回ID）

筛选条件参数：

• 精确匹配person.name：fields.name={目标人名}
• 模糊匹配person.name：fields.name[contains]={关键词}
• 精确匹配关联video.title：fields.videos.fields.title={目标视频标题}
• 模糊匹配关联video.title：fields.videos.fields.title[contains]={关键词}

完整请求示例 #

假设空间ID为abc123、访问令牌为xyz789，要查询名为「张三」的person下标题为「前端入门实战」的视频URL，请求URL如下：

https://cdn.contentful.com/spaces/abc123/entries?access_token=xyz789&content_type=person&include=1&fields.name=张三&fields.videos.fields.title=前端入门实战

提取目标videoURL #

请求返回的JSON数据中：

1. 符合条件的person条目在items数组内，其fields.videos字段是匹配的video对象数组，直接读取fields.videoURL即可
2. 关联的video条目也会出现在includes.Entry数组中，可通过sys.id与person的videos字段关联匹配

额外注意点 #

• 查询条件默认区分大小写，如需忽略大小写可使用[match]操作符（仅支持文本字段）
• 如需匹配多个值，可用[in]操作符，例如fields.name[in]=张三,李四
• 若存在多级关联，需调整include的数值（如二级关联设为include=2）

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