Início rápido: sua primeira chamada à MotoGP API

Este guia leva você do zero a uma requisição funcionando em cerca de cinco minutos. Você precisa de uma conta na RapidAPI e de um terminal.

1. Assine e copie sua chave

1. Abra a MotoGP API na RapidAPI e escolha um plano.
2. No playground da RapidAPI, copie o valor de X-RapidAPI-Key. Essa chave identifica sua assinatura; a RapidAPI mede sua cota por ela.

Guarde a chave em uma variável de ambiente em vez de colá-la no código:

export RAPIDAPI_KEY="paste-your-key-here"

2. Envie sua primeira requisição

Toda requisição precisa de dois headers: sua chave e o host da API.

curl -s "https://motogp-api-championship-data-statistics.p.rapidapi.com/standings/seasons/2026/riders?category=MOTOGP" \
  -H "X-RapidAPI-Key: $RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: motogp-api-championship-data-statistics.p.rapidapi.com"

A resposta é o campeonato de pilotos de MotoGP de 2026, já ordenado por posição:

{
  "data": [
    {
      "position": 1,
      "total_points": 365,
      "wins": 6,
      "podiums": 6,
      "season_year": 2026,
      "rider_name": "Marc Márquez",
      "rider_number": 93,
      "team_name": "Ducati Lenovo Team",
      "category": "MOTOGP"
    }
  ],
  "meta": { "total": 32, "page": null, "size": null, "total_pages": null }
}

3. Não fixe a temporada no código

GET /seasons/latest retorna a temporada mais recente, então seu código continua funcionando quando um novo campeonato começa. Encadeie essa chamada com a de classificação:

JavaScript (Node.js 18+)

const HOST = "motogp-api-championship-data-statistics.p.rapidapi.com";
const headers = {
  "X-RapidAPI-Key": process.env.RAPIDAPI_KEY,
  "X-RapidAPI-Host": HOST,
};

async function get(path) {
  const res = await fetch(`https://${HOST}${path}`, { headers });
  const body = await res.json();
  if (!res.ok) throw new Error(`${res.status} ${body.message ?? res.statusText}`);
  return body.data;
}

const season = await get("/seasons/latest");
const standings = await get(`/standings/seasons/${season.year}/riders?category=MOTOGP`);

for (const row of standings.slice(0, 5)) {
  console.log(`${row.position}. ${row.rider_name} (#${row.rider_number}) – ${row.total_points} pts`);
}

Python

import os
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, **params):
    res = requests.get(f"https://{HOST}{path}", headers=HEADERS, params=params, timeout=10)
    res.raise_for_status()
    return res.json()["data"]


season = get("/seasons/latest")
standings = get(f"/standings/seasons/{season['year']}/riders", category="MOTOGP")

for row in standings[:5]:
    print(f"{row['position']}. {row['rider_name']} (#{row['rider_number']}) – {row['total_points']} pts")

Saída:

1. Marc Márquez (#93) – 365 pts
2. Jorge Martín (#89) – 355 pts
3. Marco Bezzecchi (#72) – 315 pts
...

Próximos passos

• Leia Convenções para categorias, paginação, erros e cache.
• Crie uma tabela de classificação para o seu site.
• Explore todos os endpoints na referência da MotoGP API.