RFC 8288 Link 標頭與分頁

分頁的 REST API 會回傳 Link: <...>; rel="next" 標頭,但沒有任何東西解析它,因此多頁抓取需要手動黏合。 本功能解析該標頭(處理含引號的參數值與多個連結)、依關係索引連結,並透過注入的傳輸走訪 rel="next"。

純標準函式庫(re);不匯入 PySide6。解析器為純函式,``paginate`` 接受注入的 fetch callable, 因此分頁可在無線上伺服器的情況下於 CI 測試。

無頭 API

from je_auto_control import parse_link_header, next_url, links_by_rel, paginate

header = '<https://api/x?page=2>; rel="next", <https://api/x?page=9>; rel="last"'
links = parse_link_header(header)            # [Link(uri=..., rel="next"), ...]
nxt = next_url(header)                        # "https://api/x?page=2"
last = links_by_rel(header)["last"].uri

# 透過注入的 fetch(傳輸 / 卡帶)走訪每一頁:
pages = paginate(start_url, fetch, max_pages=50)

parse_link_header 回傳 Link 清單(uri、rel 與所有 params),容許含逗號的引號值與單一 標頭中的多個連結。links_by_rel 依每個(以空白分隔的)關係索引,``next_url`` 是 rel="next" 的便利 函式,``paginate`` 抓取一個 URL 並透過提供的 fetch callable 跟隨 next 連結,上限為 max_pages。

執行器命令

AC_parse_link_header 把標頭 value 解析成 {links};``AC_next_url`` 回傳 rel="next" 的 {url}。兩者皆以 MCP 工具(ac_parse_link_header / ac_next_url)以及 Script Builder 中 Data 分類下的命令提供。