AmadeusAPIlimit参数使用教程

本文深入解析了 Amadeus Python SDK 中分页参数 `page[limit]` 的正确使用方式，指出其并非独立参数，而是必须以字典形式（如 `page={'limit': 5}`）传入 `page` 参数中，否则将被静默忽略；文章通过清晰的代码示例、常见错误对比和关键注意事项（如键名大小写敏感、offset 配合使用、响应字段验证等），帮助开发者避开典型陷阱，高效实现精准分页——无论调用 by_square、by_circle 还是 search 等 POI 端点，这一嵌套字典模式都是统一且必需的实践准则。

在 Amadeus Python SDK 中，分页参数 `page[limit]` 并非以独立关键字传入，而是需通过字典形式嵌套在 `page` 参数中，如 `page={'limit': 5}`，方可生效。

Amadeus 的 Points of Interest（POI）API 支持分页控制，其中 page[limit] 是官方文档中声明的查询参数，用于限制单页返回结果数量（默认为 10）。但在 Python SDK 中，该参数不能直接写成 page_limit=5 或 page[limit]=5（后者语法非法），也不能用方括号作为关键字名（Python 不支持）。

✅ 正确用法是将分页配置封装为一个字典，并作为 page 参数传入：

response = amadeus.reference_data.locations.points_of_interest.by_square.get(
    north=41.42,
    west=2.11,
    south=41.347463,
    east=2.228208,
    categories=['SIGHTS', 'NIGHTLIFE'],
    page={'limit': 5}  # ✅ 正确：page 接收 dict，内含 'limit' 键
)

你还可以同时指定起始偏移量（offset），实现精准分页：

# 获取第 2 页（每页 5 条），即跳过前 5 条
page={'offset': 5, 'limit': 5}

⚠️ 注意事项：

• page 必须是 dict 类型，键名严格为 'limit' 和/或 'offset'（小写，无空格）；
• 若传入无效 key（如 'page_limit'）或类型错误（如 page=5），SDK 将静默忽略，仍使用默认分页行为；
• 建议始终检查响应中的 meta.count 和 meta.offset 字段，验证分页是否生效；
• 所有 POI 相关端点（如 by_square、by_circle、search）均遵循相同的 page 字典约定。

总结：Amadeus Python SDK 将 RESTful API 中的 page[limit] 这类带方括号的参数映射为嵌套字典结构，开发者需主动构造 page={'limit': N} —— 这是 SDK 的统一设计模式，适用于所有支持分页的端点。

今天关于《AmadeusAPIlimit参数使用教程》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！