キャリア統計付きのライダープロフィールページ

ファンアプリ、ファンタジーゲーム、ニュースサイトには、ライダーごとのページが必要です。プロフィールカードに必要なものは、ライダー情報とキャリア合計の 2 回の呼び出しで揃います。

2 つの呼び出し

GET /riders/93
GET /riders/93/career-stats

/riders/{rider_number} はプロフィールを返します。

{
  "rider_number": 93,
  "full_name": "Marc Márquez",
  "nationality": "Spain",
  "flag": "🇪🇸",
  "birth_date": "1993-02-17",
  "height_cm": 168,
  "weight_kg": 59,
  "team_name": "Gresini Racing MotoGP",
  "image_url": null
}

/riders/{rider_number}/career-stats は合計を返します。

{
  "rider_number": 93,
  "rider_name": "Marc Márquez",
  "total_wins": 44,
  "total_podiums": 66,
  "total_points": 1302,
  "world_titles": 2,
  "total_races": 118
}

キャリア合計は、ライダーのキャリア全体ではなく、API で利用可能なシーズンから算出されます。「2024 年以降」のように、その旨を明記してください。

2 つを並列で取得する

import os
from concurrent.futures import ThreadPoolExecutor
from dataclasses import dataclass
from datetime import date

import requests

HOST = "motogp-api-championship-data-statistics.p.rapidapi.com"
HEADERS = {"X-RapidAPI-Key": os.environ["RAPIDAPI_KEY"], "X-RapidAPI-Host": HOST}


def get(path: str) -> dict:
    res = requests.get(f"https://{HOST}{path}", headers=HEADERS, timeout=10)
    res.raise_for_status()
    return res.json()["data"]


@dataclass(frozen=True)
class RiderCard:
    number: int
    name: str
    flag: str
    team: str
    age: int
    wins: int
    podiums: int
    titles: int
    races: int

    @property
    def podium_rate(self) -> float:
        return self.podiums / self.races if self.races else 0.0


def age_on(birth: str, today: date) -> int:
    born = date.fromisoformat(birth)
    return today.year - born.year - ((today.month, today.day) < (born.month, born.day))


def rider_card(number: int) -> RiderCard:
    with ThreadPoolExecutor(max_workers=2) as pool:
        profile_f = pool.submit(get, f"/riders/{number}")
        stats_f = pool.submit(get, f"/riders/{number}/career-stats")
        profile, stats = profile_f.result(), stats_f.result()
    return RiderCard(
        number=profile["rider_number"],
        name=profile["full_name"],
        flag=profile["flag"],
        team=profile["team_name"],
        age=age_on(profile["birth_date"], date.today()),
        wins=stats["total_wins"],
        podiums=stats["total_podiums"],
        titles=stats["world_titles"],
        races=stats["total_races"],
    )


card = rider_card(93)
print(f"{card.flag} #{card.number} {card.name} — {card.team}, {card.age}")
print(f"{card.wins} wins, {card.podiums} podiums in {card.races} races ({card.podium_rate:.0%})")

一覧ページを作る

プロフィールページへのリンク元となる一覧が必要です。

ページ	エンドポイント
今シーズンのグリッド	GET /riders/seasons/{year}?category=MOTOGP
国別ライダー	GET /riders/nationality/{nationality}（例: Italy）
データベース内の全ライダー	GET /riders?page=1&size=200

URL のスラッグには rider_number（/riders/93/）を使ってください。ファンが検索するのはこの番号です。

欠損データを扱う

• image_url は null の場合があります。壊れた画像の代わりに、色付きのバッジでレースナンバーを表示してください。
• 使われていない番号は 404 を返します。エラーではなく「ライダーが見つかりません」ページを表示してください。
• ライダーはシーズン間でナンバーを変えることがあります。お気に入りを保存する場合は、そのナンバーを取得したシーズンと一緒に保存してください。