如何通过Instagram Graph API获取相册所有图片的media_url

核心逻辑说明 #

Graph API默认不会返回轮播帖的全量子媒体，不显式指定嵌套字段的情况下仅返回轮播首项/封面媒体；消息详情响应最外层的next/previous是会话线程的消息分页端点，和当前轮播帖的子媒体拉取无关，直接调用无法拿到全量轮播内容。

操作步骤 #

• 调整消息详情接口的fields参数，显式声明拉取轮播子媒体的嵌套字段，请求构造示例：

  # 替换为实际使用的Graph API版本，v16及以上版本均支持该字段结构
  GRAPH_API_VERSION = "v18.0"
  # 嵌套拉取附件、轮播子项的媒体类型、源地址字段
  request_fields = "id,created_time,message,attachments{media_type,media_url,children{media_type,media_url}}"
  message_detail_url = f"https://graph.facebook.com/{GRAPH_API_VERSION}/{message_id}?fields={request_fields}&platform=instagram&access_token={access_token}"
  

• 解析首屏响应：接口正常返回后，当前页的轮播媒体按发布顺序存储在attachments.data[0].children.data数组中，遍历数组即可提取每个子项的media_url，该字段对图片、视频类轮播子项通用。
• 处理子媒体分页：轮播子项数量超过单页返回上限（默认25条）时，children节点下会返回独立的paging结构：
  • 不要使用响应最外层的paging.next拉取轮播内容，该链接用于拉取会话内下一条消息，和当前轮播无关
  • 直接对children.paging.next返回的链接发起GET请求即可，链接已自带鉴权、字段配置参数，无需额外拼接内容，将返回的data数组内的media_url追加到结果集
  • 重复检查paging.next、拉取的操作，直到返回结果无next字段，即可拿到轮播帖内所有媒体的源地址。

注意事项 #

调用接口使用的access_token需要持有instagram_basic、pages_show_list、pages_messaging权限，否则会出现children字段为空的问题；接口返回的media_url为带有效期的临时鉴权链接，需长期存储的话要提前做资源转存。

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