Integrer l'API Sparepilot : guide pour developpeurs

L'API REST SparePilot ouvre l'acces a la plus grande base de donnees independante de pieces detachees motoculture : 27 754 machines, 92 439 produits et 397 710 references OEM. Gratuite en beta (100 req/min), elle permet aux developpeurs B2B d'integrer la recherche de pieces, les cross-references et la comparaison de prix directement dans leurs applications.

Points cles
- Acces gratuit pendant la beta (100 requetes/minute), plans Pro a 49 euros/mois
- Endpoints REST avec reponses JSON, pagination par offset
- Exemples Python et JavaScript inclus dans ce guide
- Cas d'usage : e-commerce, ERP/gestion de stock, ateliers de reparation, apps mobiles

Pourquoi utiliser l'API SparePilot ?

L'API REST SparePilot donne acces a la plus grande base de donnees de pieces detachees motoculture. Elle permet de rechercher des pieces, consulter les fiches produits, trouver des equivalences et comparer les prix depuis vos propres applications.

L'API est conçue pour les developpeurs B2B : e-commercants, distributeurs, ateliers de reparation, et editeurs de logiciels de gestion.

Consultez la page API Developpeurs pour les tarifs et la reference complete des endpoints.

Getting Started

1. Obtenir une cle API

Contactez-nous a contact@blueproject.org pour recevoir votre cle d'acces. L'acces Basic est gratuit pendant la beta.

2. Authentification

Ajoutez votre cle API dans le header X-API-Key de chaque requete :

X-API-Key: votre_cle_api

3. Base URL

https://sparepilot.com/api/v1

Comment integrer l'API en Python ?

Recherche full-text avec la librairie requests :

import requests

API_KEY = "votre_cle_api"
BASE = "https://sparepilot.com/api/v1"

# Recherche par mot-cle
resp = requests.get(
    f"{BASE}/parts/search",
    params={"q": "lame honda hrx"},
    headers={"X-API-Key": API_KEY},
)
results = resp.json()

for r in results:
    part = r["part"]
    print(f"{part['canonical_name']} - Score: {r['score']}")
    for ref in part.get("oem_refs", []):
        print(f"  OEM: {ref}")

Lookup par reference OEM :

import requests

# Cross-reference : trouver les equivalences
resp = requests.get(
    f"{BASE}/parts/crossref",
    params={"oem_ref": "72511-VH7-000"},
    headers={"X-API-Key": API_KEY},
)
equivalences = resp.json()

for eq in equivalences:
    print(f"{eq['brand']} - {eq['ref']} - {eq['price']}EUR")

Comment integrer l'API en JavaScript ?

Recherche avec fetch (Node.js / navigateur) :

const API_KEY = "votre_cle_api";
const BASE = "https://sparepilot.com/api/v1";

// Recherche par mot-cle
const res = await fetch(
  `${BASE}/parts/search?q=courroie+husqvarna`,
  { headers: { "X-API-Key": API_KEY } }
);
const results = await res.json();

results.forEach(r => {
  console.log(`${r.part.canonical_name} - Score: ${r.score}`);
});

Detail d'une piece avec ses prix :

// Detail + comparaison de prix
const detail = await fetch(
  `${BASE}/parts/42`,
  { headers: { "X-API-Key": API_KEY } }
).then(r => r.json());

const prices = await fetch(
  `${BASE}/parts/42/prices`,
  { headers: { "X-API-Key": API_KEY } }
).then(r => r.json());

console.log(detail.canonical_name);
prices.forEach(p => {
  console.log(`  ${p.source}: ${p.price}EUR`);
});

Cas d'usage B2B

• E-commerce : enrichissez vos fiches produits avec les cross-references et les prix concurrents.
• ERP / gestion de stock : automatisez la recherche de references equivalentes pour optimiser vos achats.
• Ateliers de reparation : integrez la recherche de pieces directement dans votre logiciel de devis.
• Applications mobiles : offrez a vos clients un outil de recherche de pieces par reference ou par machine.

Limites et bonnes pratiques

• Rate limiting : respectez les limites de votre plan (100, 500 ou 2000 req/min).
• Caching : les donnees produits changent rarement. Cachez les reponses pendant au moins 1 heure.
• Pagination : utilisez les parametres page et limit pour naviguer dans les resultats.
• Gestion d'erreurs : l'API retourne des codes HTTP standards. Gerez les 429 (rate limit) avec un backoff exponentiel.