@ridec/partner-sdk

SDK ufficiale RideConnect per concessionarie, motoclub e partner.

Installazione

npm install @ridec/partner-sdk

Quick Start

import { RideConnectPartner } from '@ridec/partner-sdk';

const rc = new RideConnectPartner({
  apiKey: 'rc_pk_...',   // Ottieni la tua API key dalla dashboard RideConnect
  region: 'eu',           // 'eu' (Francoforte) o 'us' (Oregon)
});

// Eventi in Lombardia
const events = await rc.events.list({ province: 'MI', page: 1 });
console.log(`${events.pagination.total} eventi trovati`);

// Dettaglio evento
const event = await rc.events.getById('uuid-evento');

// Chapter attivi
const chapters = await rc.chapters.list({ province: 'MI' });

// Dealer vicini (30km da Milano)
const dealers = await rc.dealers.list({
  lat: 45.4642,
  lng: 9.1900,
  radius_km: 30,
});

API Reference

new RideConnectPartner(config)

| Parametro | Tipo | Default | Descrizione | |---|---|---|---| | apiKey | string | required | API key dalla dashboard | | region | 'eu' \| 'us' | 'eu' | Regione del server | | baseUrl | string | auto | Override URL (per staging) | | timeout | number | 10000 | Timeout in ms |

.events

| Metodo | Descrizione | |---|---| | .list(params?) | Lista eventi con filtri (page, province, date, search) | | .getById(id) | Dettaglio evento |

.chapters

| Metodo | Descrizione | |---|---| | .list(params?) | Lista chapter (page, province) | | .getById(id) | Dettaglio chapter + eventi futuri |

.dealers

| Metodo | Descrizione | |---|---| | .list(params?) | Lista dealer con geolocalizzazione (lat, lng, radius_km) | | .getById(id) | Dettaglio dealer |

.health

| Metodo | Descrizione | |---|---| | .check() | Verifica stato API regionale |

Caratteristiche

• ✅ Zero dipendenze — solo fetch nativo (Node 18+ o browser)
• ✅ TypeScript — tipi completi inclusi
• ✅ Auto-retry — retry con exponential backoff su errori 5xx e network
• ✅ Rate limit — gestione automatica header Retry-After
• ✅ Multi-region — routing automatico EU/US

Ottenere una API Key

1. Vai su rideconnect.it/dashboard
2. Naviga in Impostazioni → API Keys
3. Clicca Genera Nuova Chiave
4. Seleziona i permessi (events, chapters, dealers)
5. Copia la chiave e usala nel SDK

Licenza

MIT