> ## Documentation Index
> Fetch the complete documentation index at: https://docs.steerai.autos/llms.txt
> Use this file to discover all available pages before exploring further.

# Référence API

> Documentation REST complète pour la plateforme d'inspection et de tarification des véhicules de Steer AI

## 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.

<CardGroup cols={2}>
  <Card title="Démarrage rapide" icon="rocket" href="/fr/getting-started/quickstart">
    Obtenez vos clés API et effectuez votre première requête en quelques minutes
  </Card>

  <Card title="Authentification" icon="key" href="/fr/getting-started/authentication">
    Sécurisez vos requêtes API avec une authentification appropriée
  </Card>

  <Card title="Guide d'intégration" icon="plug" href="/fr/integration/api/overview">
    Guide complet pour intégrer l'API et appliquer les meilleures pratiques
  </Card>

  <Card title="Bonnes pratiques" icon="star" href="/fr/guides/best-practices">
    Recommandations de sécurité, performance et optimisation
  </Card>
</CardGroup>

## 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 :

```bash theme={null}
curl -X GET "https://api.steerai.autos/v1/inspections" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
```

<Warning>
  **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.
</Warning>

## Format des requêtes et réponses

### En-têtes de requête

Toutes les requêtes doivent inclure ces en-têtes :

```http theme={null}
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 :

```json theme={null}
{
  "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

<CardGroup cols={3}>
  <Card title="Inspection de véhicules" icon="search" href="/fr/features/inspection/overview">
    Soumettez des véhicules pour des inspections pilotées par l'IA et une analyse des dommages
  </Card>

  <Card title="Tarification et valorisation" icon="dollar-sign" href="/fr/features/pricing/overview">
    Obtenez des valorisations de marché en temps réel et des calculs d'impact des dommages
  </Card>

  <Card title="Gestion CRM" icon="users" href="/fr/features/crm/overview">
    Gérez prospects, clients et inventaire via nos API CRM
  </Card>
</CardGroup>

## Limites de débit

Les limites de débit sont appliquées par clé API et varient selon le plan :

| Plan             | Requêtes/heure | Concurrence | Limite burst |
| ---------------- | -------------- | ----------- | ------------ |
| **Free**         | 1,000          | 5           | 50           |
| **Starter**      | 10,000         | 20          | 200          |
| **Professional** | 100,000        | 100         | 1,000        |
| **Enterprise**   | Unlimited      | Custom      | Custom       |

## SDK et bibliothèques

<CardGroup cols={2}>
  <Card title="SDK Python" icon="python">
    ```bash theme={null}
    pip install steer-ai
    ```

    Bibliothèque Python complète avec support async
  </Card>

  <Card title="SDK JavaScript" icon="js">
    ```bash theme={null}
    npm install @steerai/sdk
    ```

    SDK compatible TypeScript pour Node.js et navigateurs
  </Card>
</CardGroup>

## Exemples de requêtes

### Inspection de véhicules

```bash theme={null}
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

```bash theme={null}
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

```bash theme={null}
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": "john@example.com",
    "phone": "+1234567890",
    "source": "website"
  }'
```

## Gestion des erreurs

Toutes les réponses d'erreur suivent un format cohérent :

```json theme={null}
{
  "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

| Code                  | Statut HTTP | Description                          |
| --------------------- | ----------- | ------------------------------------ |
| `INVALID_API_KEY`     | 401         | La clé API est invalide ou expirée   |
| `RATE_LIMIT_EXCEEDED` | 429         | Trop de requêtes                     |
| `VALIDATION_ERROR`    | 400         | Données de requête invalides         |
| `RESOURCE_NOT_FOUND`  | 404         | La ressource demandée n'existe pas   |
| `INTERNAL_ERROR`      | 500         | Erreur serveur, réessayez la requête |

## Webhooks

Configurez des webhooks pour recevoir des mises à jour en temps réel :

```bash theme={null}
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

* **Support technique :** [support@steerai.autos](mailto:support@steerai.autos)
* **Statut de l'API :** [status.steerai.autos](https://status.steerai.autos)
* **Changelog :** consultez notre [changelog](/fr/support/changelog) pour les mises à jour de l'API