Instagram 的 GET/tags/<tag>/media/recent Pagination 是如何工作的？

Question

我正在尝试使用Real-time Photo Updates API 来获取所有带有特定标签的图片。因为来自此 API 的更新实际上只会告诉您 新内容存在（但不是什么），每当我收到有关某些事情发生变化的通知时，我都会使用我的标签查询最近的媒体。

我遇到的问题是我不断收到该查询返回的重复媒体。文档说这个 API 会分页，但我根本无法让它工作。

文档here 说要在查询字符串中使用min_id 和max_id 来控制分页，但是它说：

• MIN_ID - 返回此 min_id 之前的媒体。

• MAX_ID - 在此 max_id 之后返回媒体。

这似乎是倒退的（通常 min 应该返回高于最小值的项目，而 max 应该返回低于最大值的项目，这样当你指定两者时，你会得到一个有界的范围）。

我从查询中返回的实际 JSON 包括一个这样的分页对象：

"pagination":  {
    "next_max_tag_id": "1387272337517",
    "deprecation_warning": "next_max_id and min_id are deprecated for this endpoint; use min_tag_id and max_tag_id instead",
    "next_max_id": "1387272337517",
    "next_min_id": "1387272345517",
    "min_tag_id": "1387272345517",
    "next_url": "https://api.instagram.com/v1/tags/cats/media/recent?access_token=xxx&max_tag_id=1387272337517"
}

next_url 属性中指定的参数是max_tag_id，而不是文档中所说的max_id。

还有一个弃用警告指出 next_max_id 和 min_id 已弃用，但由于分页对象中有类似名称的属性，我不知道查询参数或对象属性是那些被弃用的..

我认为这意味着属性，因为查询字符串从未使用过next_max_id 的参数，但是弃用消息说使用min_tag_id 和max_tag_id 并且分页上没有max_tag_id 属性对象（只是一个next_max_tag_id）。

不管所有这些相互冲突的文档，我在查询字符串中传递的内容似乎都无关紧要 - 我继续在后续查询中获得重复媒体。有人可以帮我理解这个 API 吗？我真正想要的只是获得自上次查询以来新的标记媒体。

Answer 1

要获取特定标签的最新克数集，请使用以下命令：

https://api.instagram.com/v1/tags/latergram/media/recent?access_token=TOKEN

从该响应中，您可以通过从响应中获取min_tag_id（在分页下）并构建一个如下所示的网址，从同一标签中获取更新的克：

https://api.instagram.com/v1/tags/latergram/media/recent?access_token=TOKEN&min_tag_id=1387332980547

或者您可以使用原始响应中的 next_url 参数（也在分页下）获取下一组（较旧的）gram，如下所示：

https://api.instagram.com/v1/tags/latergram/media/recent?access_token=TOKEN&max_tag_id=1387332905573

确保您的后续查询（针对特定标签的新克）使用最新响应返回的min_tag_id。我做了一些测试，没有看到重复，但是我使用的是#latergram，而且那个帖子的数量很大

Answer 2

@zachallia 已现场回答，但我认为它不会伤害草图：

作为Instagram API says： MIN_TAG_ID Return media before this min_tag_id. MAX_TAG_ID Return media after this max_tag_id.

这是违反直觉的，带有轻微的坚果味。不过还是可以理解的。

/tags/MYTAG/media/recent 端点将为您提供克数，按使用 MYTAG 标记的新近程度排序。当然，你不会得到所有的克数，只会达到 Instagram 设置的限制：

|yesteryear ------------------ <---- LIMIT ----> now|

如果你像/tags/MYTAG/media/recent?min_tag_id=X 那样使用min_tag_id，你会从X 和之前（又名更早）获得克数：

|yesteryear ------- <---- LIMIT ---> min ------- now|

如果你像 /tags/MYTAG/media/recent?max_tag_id=Y 那样使用 max_tag_id，你会从 Y 和之后（又名更新）获得克数：

|yesteryear ------- max <---- LIMIT ---> ------- now|

这就是“max”表示“较新”和“min”表示“较旧”的方式。