Passer au contenu principal

Pourquoi choisir l’integration API ?

Parfait pour les developpeurs et les entreprises qui ont besoin d’une flexibilite maximale et d’integrations sur mesure. Demarrez en 48 heures sans frais de setup.

Avantages cles

Aucun frais de setup - Commencez a construire immediatement • Deploiement en 48 heures - Integration API la plus rapide • APIs REST - Endpoints standards et predictibles • Flexibilite maximale - Construisez exactement ce dont vous avez besoin • Tarification scalable - Payez uniquement ce que vous utilisez

Ideal pour

• Equipes de dev avec experience API • Integrations d’applications sur mesure • Traitement d’inspections a haut volume • Exigences de workflows uniques • Extension d’applications existantes

Capacites API principales

APIs d’inspection vehicule

  • Inspection mecanique : Analyse diagnostique pilotee par IA
  • Inspection visuelle : Detection et evaluation des dommages a 360°
  • Traitement d’images : Vision par ordinateur avancee pour les dommages
  • Rapports d’inspection : Rapports complets PDF et JSON

APIs de tarification et valorisation

  • Valorisation marche : Analyse des prix marche en temps reel
  • Evaluation des dommages : Calcul de l’impact sur la valeur
  • Estimation de reparation : Prediction precise des couts
  • Tarification regionale : Ajustements par localisation

APIs d’integration business

  • Gestion des leads : Capacites d’integration CRM
  • Sync inventaire : Gestion d’inventaire en temps reel
  • Generation de contrats : Creation automatique de documents
  • Integration marketing : Outils marketing multi-plateformes

Demarrage rapide

1. Obtenir vos cles API

# Sign up and get your API keys
curl -X POST "https://api.steerai.autos/v1/auth/register" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "company": "Your Company Name"
  }'

2. Faire votre premier appel API

# Test your authentication
curl -X GET "https://api.steerai.autos/v1/auth/test" \
  -H "Authorization: Bearer YOUR_API_KEY"

3. Creer votre premiere inspection

# Submit vehicle images for inspection
curl -X POST "https://api.steerai.autos/v1/inspections" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vehicle": {
      "vin": "1HGBH41JXMN109186",
      "year": 2021,
      "make": "Honda",
      "model": "Civic"
    },
    "images": [
      "https://your-storage.com/image1.jpg",
      "https://your-storage.com/image2.jpg"
    ]
  }'

Architecture API

URLs de base

  • Production : https://api.steerai.autos/v1
  • Sandbox : https://api-sandbox.steerai.autos/v1

Authentification

Toutes les requetes API necessitent un token Bearer dans l’entete Authorization.

Format de reponse

Tous les endpoints renvoient du JSON avec une structure coherente :
{
  "status": "success|error",
  "data": { ... },
  "meta": {
    "request_id": "req_1234567890",
    "timestamp": "2024-01-15T10:30:00Z",
    "processing_time": 1.23
  }
}

Limites de taux

PlanRequetes/HeureConcurrentBurst Limit
Free1,000550
Starter10,00020200
Professional100,0001001,000
EnterpriseIllimiteCustomCustom

Entetes de rate limit

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1640995200
X-Retry-After: 60

Support SDK

Exemples d’integration

Workflow d’inspection basique

from steer_ai import SteerAI

# Initialize client
client = SteerAI(api_key="YOUR_API_KEY")

# Create inspection
inspection = client.inspections.create({
    "vehicle": {
        "vin": "1HGBH41JXMN109186",
        "year": 2021,
        "make": "Honda",
        "model": "Civic"
    },
    "images": ["image1.jpg", "image2.jpg"]
})

# Get results
result = client.inspections.get(inspection.id)
print(f"Inspection complete: {result.status}")
print(f"Damage detected: {result.damages}")

Integration webhook

from flask import Flask, request
import hmac
import hashlib

app = Flask(__name__)

@app.route('/webhooks/steerai', methods=['POST'])
def handle_webhook():
    # Verify webhook signature
    signature = request.headers.get('X-SteerAI-Signature')
    body = request.get_data()

    if verify_signature(body, signature):
        event = request.json

        if event['type'] == 'inspection.completed':
            # Handle completed inspection
            process_inspection_result(event['data'])

    return '', 200

Gestion des erreurs

Codes d’erreur courants

CodeDescriptionResolution
400Bad RequestVerifier le format et les champs requis
401UnauthorizedVerifier la cle API et les permissions
403ForbiddenVerifier les limites de plan et acces
404Not FoundVerifier l’ID ressource et l’URL
429Rate LimitedImplementer un backoff exponentiel
500Server ErrorReessayer ou contacter le support

Format de reponse d’erreur

{
  "status": "error",
  "error": {
    "code": "INVALID_VIN",
    "message": "The provided VIN is invalid",
    "type": "validation_error",
    "field": "vehicle.vin"
  },
  "meta": {
    "request_id": "req_1234567890"
  }
}

Bonnes pratiques

• Ne jamais exposer les cles API dans le code client • Utiliser des variables d’environnement pour les cles • Implementer une validation SSL correcte • Faire tourner les cles regulierement (tous les 90 jours) • Utiliser une liste blanche IP si possible
• Mettre en cache les requetes repetees • Utiliser des endpoints batch pour les operations multiples • Gerer les rate limits avec un backoff exponentiel • Optimiser la taille des images avant upload • Utiliser la compression pour les payloads lourds
• Toujours verifier les codes de statut • Implementer une logique de retry pour les erreurs temporaires • Logger les details d’erreur pour debug • Gerer les timeouts reseau avec grace • Fournir des messages d’erreur utiles aux utilisateurs
• Suivre l’usage et les metriques de performance • Surveiller les taux d’erreur et temps de reponse • Mettre en place des alertes pour les echecs critiques • Utiliser les request IDs pour le support • Implementer des health checks pour l’integration

Applications d’exemple

App d'inspection vehicule

Application mobile complete pour inspections terrainVoir sur GitHub →

Integration concession

Integration complete a un systeme de gestion de concessionVoir sur GitHub →

Prochaines etapes

Support

Besoin d’aide pour votre integration API ?
  • Documentation : Reference API complete avec exemples
  • SDKs : Bibliotheques officielles Python et JavaScript
  • Code d’exemple : Integrations reales
  • Support technique : [email protected]
  • Communaute : Discord community
Conseil pro : Commencez par l’environnement sandbox pour tester l’integration avant la mise en production. La plupart des developpeurs reussissent leur premiere integration en moins de 4 heures.