REST API分页问题：返回的nextUri缺失divisionId参数如何处理？

问题核心 #

调用接口 /api/v2/externalcontacts/scan/contacts?limit=200&divisionId=8d8d8d49-7c14-4fa7-a4c1-9940eebf1cdc 时，返回的nextUri未携带divisionId参数，导致后续分页请求无法过滤指定部门的数据。以下是三种手动配置分页的可靠方案：

方案一：手动拼接完整分页URL #

1. 从接口返回结果中提取nextUri原始值（例：/api/v2/externalcontacts/scan/contacts?limit=200&after=xxx）
2. 根据nextUri是否包含?，选择合适的符号追加divisionId参数：
   • 若已有?，用&拼接：${nextUri}&divisionId=8d8d8d49-7c14-4fa7-a4c1-9940eebf1cdc
   • 若未包含?（极端兼容场景），用?拼接：${nextUri}?divisionId=8d8d8d49-7c14-4fa7-a4c1-9940eebf1cdc
3. 使用拼接后的完整URL发起下一页请求，确保每次请求都携带部门过滤参数。

方案二：提取cursor参数，重新构造请求 #

1. 从接口返回的cursor对象中提取after字段值（例：xxx）
2. 基于原始接口的基础参数，重新构造分页请求URL：

   /api/v2/externalcontacts/scan/contacts?limit=200&divisionId=8d8d8d49-7c14-4fa7-a4c1-9940eebf1cdc&after=${after_value}
   

3. 每次分页仅替换after的值，复用原始的limit和divisionId参数。

方案三：通过请求拦截器自动追加参数 #

如果使用HTTP客户端（如Python Requests、JS Axios），可通过全局拦截器自动为所有分页请求添加divisionId，避免手动拼接：
示例（Python Requests）：

import requests

session = requests.Session()

# 定义请求钩子，自动追加divisionId参数
def inject_division_id(request):
    request.params['divisionId'] = '8d8d8d49-7c14-4fa7-a4c1-9940eebf1cdc'
    return request

session.hooks['request'].append(inject_division_id)

# 初始请求
resp = session.get('/api/v2/externalcontacts/scan/contacts', params={'limit': 200})
# 后续分页请求直接调用nextUri，拦截器自动补全参数
next_resp = session.get(resp.json()['nextUri'])

排查建议 #

• 检查之前手动拼接时的语法错误：比如误将相对URL当作绝对URL拼接，或参数连接符号用错（把&写成?）
• 确认cursor.after值的提取是否正确，部分API的after值含特殊字符，需确保URL编码正确

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