Intégrez les trajets Bus Citoyens

curl -s -G "https://buscitoyens.fr/api/rdex/v2/journeys" \
  -H "api_key: $BUSCITOYENS_API_KEY" \
  --data-urlencode "departureLat=49.8941" \
  --data-urlencode "departureLng=2.2958" \
  --data-urlencode "arrivalLat=49.8463" \
  --data-urlencode "arrivalLng=2.4901" \
  --data-urlencode "departureRadius=10" \
  --data-urlencode "arrivalRadius=10"

{
  "journeys": [
    {
      "id": "cmpx9k2a10001g8ab12cd34ef",
      "operator": "Bus Citoyens",
      "operatorUrl": "https://buscitoyens.fr",
      "webUrl": "https://buscitoyens.fr/trajets/cmpx9k2a10001g8ab12cd34ef",
      "type": "planned",
      "carpoolerType": "driver",
      "availableSeats": 3,
      "from": { "latitude": 49.8463, "longitude": 2.4901, "city": "Marcelcave", "postalCode": "80800", "country": "FR" },
      "to": { "latitude": 49.8941, "longitude": 2.2958, "city": "Amiens", "postalCode": "80000", "country": "FR" },
      "distance": 15230,
      "duration": 1096,
      "frequency": "regular",
      "isRoundTrip": 1,
      "isStopped": 0,
      "outward": {
        "departureDate": 1768464000,
        "regularSchedule": [{ "mondayTime": "07:45:00", "mondayTimeDelta": 900, "tuesdayTime": "07:45:00", "tuesdayTimeDelta": 900 }],
        "timeDelta": 900
      },
      "return": {
        "departureDate": 1768464000,
        "regularSchedule": [{ "mondayTime": "17:30:00", "mondayTimeDelta": 900 }],
        "timeDelta": 900
      },
      "price": { "type": "free" },
      "user": { "id": "u_3f9a1c2b7d4e5f6a8b9c0d1e", "alias": "Membre Bus Citoyens" }
    }
  ],
  "nbJourneys": 1
}

api_key: bcrk_votre_cle_ici

// Réessaie sur 429 (en respectant Retry-After) et sur 5xx (backoff exponentiel).
async function rdexGet(url, apiKey, { retries = 3 } = {}) {
  for (let attempt = 0; attempt <= retries; attempt++) {
    const res = await fetch(url, { headers: { api_key: apiKey } });

    if (res.status === 429) {
      const wait = Number(res.headers.get("Retry-After") ?? 2);
      await new Promise((r) => setTimeout(r, wait * 1000));
      continue;
    }
    if (res.status >= 500) {
      await new Promise((r) => setTimeout(r, 2 ** attempt * 500));
      continue;
    }
    return res; // 2xx, ou 4xx définitif (clé invalide, paramètre manquant…)
  }
  throw new Error("RDEX+ indisponible après plusieurs tentatives");
}

{
  "errorCode": "missing_required_query_parameter",
  "errorMessage": "Paramètre obligatoire manquant : arrivalLat"
}

curl -s -G "https://buscitoyens.fr/api/rdex/v2/journeys" \
  -H "api_key: $BUSCITOYENS_API_KEY" \
  --data-urlencode "departureLat=49.8941" \
  --data-urlencode "departureLng=2.2958" \
  --data-urlencode "arrivalLat=49.8463" \
  --data-urlencode "arrivalLng=2.4901" \
  --data-urlencode "departureRadius=10" \
  --data-urlencode "arrivalRadius=10"

const params = new URLSearchParams({
  departureLat: "49.8941",
  departureLng: "2.2958",
  arrivalLat: "49.8463",
  arrivalLng: "2.4901",
  departureRadius: "10",
  arrivalRadius: "10",
});

const res = await fetch(
  `https://buscitoyens.fr/api/rdex/v2/journeys?${params}`,
  { headers: { api_key: process.env.BUSCITOYENS_API_KEY } },
);
if (!res.ok) throw new Error(`RDEX+ ${res.status}`);

const { journeys, nbJourneys } = await res.json();
console.log(`${nbJourneys} trajet(s) trouvé(s)`);

import os
import requests

resp = requests.get(
    "https://buscitoyens.fr/api/rdex/v2/journeys",
    headers={"api_key": os.environ["BUSCITOYENS_API_KEY"]},
    params={
        "departureLat": 49.8941,
        "departureLng": 2.2958,
        "arrivalLat": 49.8463,
        "arrivalLng": 2.4901,
        "departureRadius": 10,
        "arrivalRadius": 10,
    },
    timeout=10,
)
resp.raise_for_status()
data = resp.json()
print(data["nbJourneys"], "trajet(s)")

<?php
$query = http_build_query([
  'departureLat' => 49.8941,
  'departureLng' => 2.2958,
  'arrivalLat' => 49.8463,
  'arrivalLng' => 2.4901,
  'departureRadius' => 10,
  'arrivalRadius' => 10,
]);

$ch = curl_init("https://buscitoyens.fr/api/rdex/v2/journeys?$query");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['api_key: ' . getenv('BUSCITOYENS_API_KEY')],
  CURLOPT_TIMEOUT => 10,
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status !== 200) {
  throw new RuntimeException("RDEX+ erreur $status");
}
$data = json_decode($body, true);
echo $data['nbJourneys'], " trajet(s)\n";

// Types alignés sur la spec OpenAPI (générables via openapi-typescript).
interface Geopoint {
  latitude: number;
  longitude: number;
  city?: string;
  postalCode?: string;
  country?: string;
}
interface Journey {
  id: string;
  operator: string;
  webUrl?: string;
  carpoolerType: "driver" | "passenger" | "both";
  from: Geopoint;
  to: Geopoint;
  duration: number;
  frequency: "punctual" | "regular" | "both";
  price: { type: "free" | "fixed" | "variable" | "unknown" };
  user: { id: string; alias: string };
}
interface JourneysResponse {
  journeys: Journey[];
  nbJourneys: number;
}

export async function searchJourneys(apiKey: string): Promise<JourneysResponse> {
  const params = new URLSearchParams({
    departureLat: "49.8941",
    departureLng: "2.2958",
    arrivalLat: "49.8463",
    arrivalLng: "2.4901",
  });
  const res = await fetch(
    `https://buscitoyens.fr/api/rdex/v2/journeys?${params}`,
    { headers: { api_key: apiKey } },
  );
  if (!res.ok) throw new Error(`RDEX+ ${res.status}`);
  return (await res.json()) as JourneysResponse;
}