Firstcycling Api

🚀 第一个骑行API

这是一个非官方的Python API封装库，可用于访问https://firstcycling.com/ ，为用户提供便捷的赛事、骑手和排名等信息查询服务。

🚀 快速开始

本API封装库支持以下端点：

• 赛事页面
• 骑手页面
• 排名页面

有关完整文档，请参阅https://firstcyclingapi.readthedocs.io/en/latest/ 。

💻 使用示例

基础用法

赛事结果

>>> from first_cycling_api import RaceEdition
>>> amstel_2019 = RaceEdition(race_id=9, year=2019) # race_id来自赛事页面URL
>>> amstel_2019.results().results_table.head() # 返回一个包含赛事结果的pandas DataFrame

骑手结果

>>> from first_cycling_api import RiderResults
>>> rider_results = RiderResults(rider_id=7569, year=2019)
>>> rider_results.results.head() # 返回一个包含指定骑手比赛结果的pandas DataFrame

排名表

>>> from first_cycling_api import RankingTable
>>> ranking = RankingTable(rank=1, y=2020, page=2) # 参数来自对应的URL
>>> ranking.table.head() # 返回一个包含排名表的pandas DataFrame

🤝 贡献

欢迎贡献！请随时打开问题、拉取请求和/或讨论。

特别是，以下领域有改进的空间：

• 映射更多端点（例如以https://firstcycling.com/team.php 开头的页面）
• 解析来自更多页面的结果（例如赛事出发名单、赛事统计）

要运行测试，请先pip install pytest和pip install vcrpy。然后在根目录的shell中运行py.test。

📄 许可证

见LICENSE文件。此项目与firstcycling.com没有任何关联。