Passer au contenu principal

​
Bienvenue sur l’API Steer AI

L’API Steer AI offre un accès programmatique à notre plateforme d’inspection de véhicules, de tarification et de CRM pilotée par l’IA. Créez des intégrations sur mesure, automatisez vos workflows et développez des applications automobiles puissantes.

Démarrage rapide

Obtenez vos clés API et effectuez votre première requête en quelques minutes

Authentification

Sécurisez vos requêtes API avec une authentification appropriée

Guide d'intégration

Guide complet pour intégrer l’API et appliquer les meilleures pratiques

Bonnes pratiques

Recommandations de sécurité, performance et optimisation

​
URL de base

Tous les endpoints API sont relatifs à l’URL de base : Production : https://api.steerai.autos/v1 Sandbox : https://api-sandbox.steerai.autos/v1

​
Authentification

Toutes les requêtes API nécessitent une authentification via des tokens Bearer : 
curl -X GET "https://api.steerai.autos/v1/inspections" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
Note de sécurité : n’exposez jamais vos clés API dans du code côté client. Utilisez toujours des implémentations côté serveur pour les applications en production.

​
Format des requêtes et réponses

​
En-têtes de requête

Toutes les requêtes doivent inclure ces en-têtes : 
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
User-Agent: YourApp/1.0

​
Format des réponses

Toutes les réponses de l’API suivent cette structure cohérente : 
{
  "status": "success",
  "data": {
    // Response data here
  },
  "meta": {
    "request_id": "req_1234567890abcdef",
    "timestamp": "2024-01-15T10:30:00Z",
    "processing_time": 1.234,
    "rate_limit": {
      "limit": 1000,
      "remaining": 999,
      "reset": 1640995200
    }
  }
}

​
Endpoints principaux

Inspection de véhicules

Soumettez des véhicules pour des inspections pilotées par l’IA et une analyse des dommages

Tarification et valorisation

Obtenez des valorisations de marché en temps réel et des calculs d’impact des dommages

Gestion CRM

Gérez prospects, clients et inventaire via nos API CRM

​
Limites de débit

Les limites de débit sont appliquées par clé API et varient selon le plan :
PlanRequêtes/heureConcurrenceLimite burst
Free1,000550
Starter10,00020200
Professional100,0001001,000
EnterpriseUnlimitedCustomCustom

​
SDK et bibliothèques

SDK Python

pip install steer-ai
Bibliothèque Python complète avec support async

SDK JavaScript

npm install @steerai/sdk
SDK compatible TypeScript pour Node.js et navigateurs

​
Exemples de requêtes

​
Inspection de véhicules

curl -X POST "https://api.steerai.autos/v1/inspections" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vehicle": {
      "vin": "1HGBH41JXMN109186",
      "make": "Honda",
      "model": "Civic",
      "year": 2021
    },
    "inspection_type": "full"
  }'

​
Valorisation de prix

curl -X POST "https://api.steerai.autos/v1/pricing/valuate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vehicle_id": "veh_1234567890",
    "mileage": 50000,
    "condition": "good"
  }'

​
Création d’un prospect CRM

curl -X POST "https://api.steerai.autos/v1/crm/leads" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "John Doe",
    "email": "[email protected]",
    "phone": "+1234567890",
    "source": "website"
  }'

​
Gestion des erreurs

Toutes les réponses d’erreur suivent un format cohérent : 
{
  "status": "error",
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid VIN format",
    "type": "validation_error",
    "field": "vehicle.vin"
  },
  "meta": {
    "request_id": "req_1234567890abcdef"
  }
}

​
Codes d’erreur courants

CodeStatut HTTPDescription
INVALID_API_KEY401La clé API est invalide ou expirée
RATE_LIMIT_EXCEEDED429Trop de requêtes
VALIDATION_ERROR400Données de requête invalides
RESOURCE_NOT_FOUND404La ressource demandée n’existe pas
INTERNAL_ERROR500Erreur serveur, réessayez la requête

​
Webhooks

Configurez des webhooks pour recevoir des mises à jour en temps réel : 
curl -X POST "https://api.steerai.autos/v1/webhooks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-app.com/webhooks/steerai",
    "events": ["inspection.completed", "pricing.calculated"]
  }'

​
Support