Skip to main content

Documentation de l'API

Integrate vehicle depreciation calculations into your applications.

📖

Aperçu

AssetDropper fournit une API REST gratuite pour les calculs de dépréciation des véhicules. Parfait pour les développeurs créant des outils automobiles, des guides d'achat de voitures ou des applications de planification financière.

🔌

RESTful API

Simple JSON-based API with predictable resource-oriented URLs

⏱️

Limites de Débit

  • 100 requêtes par jour par adresse IP
  • Aucune authentification requise
  • La limite de débit se réinitialise à minuit UTC
🔗

Points de Terminaison

POST/api/depreciate

Calculez la dépréciation du véhicule en fonction de l'année d'achat, du prix et du type de véhicule.

Corps de Requête

JSON
{
  "purchaseYear": 2020,
  "purchasePrice": 25000,
  "vehicleType": "sedan",
  "currentMileage": 50000
}

Paramètres

ChampTypeRequisDescription
purchaseYearnumberOuiAnnée d'achat du véhicule (1900 à l'année en cours)
purchasePricenumberOuiPrix d'achat en USD (positif, maximum 10 000 000)
vehicleTypestringOuiType: sedan, suv, truck, luxury, economy, sports, ev, motorcycle, rv
currentMileagenumberNonKilométrage actuel (non négatif, par défaut 0)

Exemple de Réponse

{
  "success": true,
  "data": {
    "currentValue": 15712,
    "totalDepreciation": 9288,
    "totalDepreciationPercent": 37.2,
    "monthlyDepreciation": 155,
    "yearlyBreakdown": [
      {
        "year": 2020,
        "age": 0,
        "value": 25000,
        "depreciation": 0,
        "depreciationPercent": 0
      },
      {
        "year": 2021,
        "age": 1,
        "value": 21250,
        "depreciation": 3750,
        "depreciationPercent": 15
      }
      // ... more years
    ]
  },
  "meta": {
    "vehicleType": "sedan",
    "vehicleAge": 5,
    "calculatedAt": "2025-11-08T22:21:54.914Z"
  }
}
💻

Exemples de Code

🚀

Quick Start

Copy any of these examples to get started in seconds

cURL

cURL

bash
curl -X POST https://assetdropper.com/api/depreciate \
  -H "Content-Type: application/json" \
  -d '{
    "purchaseYear": 2020,
    "purchasePrice": 25000,
    "vehicleType": "sedan",
    "currentMileage": 50000
  }'
JS

JavaScript (fetch)

javascript
const response = await fetch('https://assetdropper.com/api/depreciate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    purchaseYear: 2020,
    purchasePrice: 25000,
    vehicleType: 'sedan',
    currentMileage: 50000,
  }),
});

const data = await response.json();
console.log('Current Value:', data.data.currentValue);
PY

Python (requests)

python
import requests

response = requests.post(
    'https://assetdropper.com/api/depreciate',
    json={
        'purchaseYear': 2020,
        'purchasePrice': 25000,
        'vehicleType': 'sedan',
        'currentMileage': 50000,
    }
)

data = response.json()
print(f"Current Value: ${data['data']['currentValue']}")
⚠️

Réponses d'Erreur

400

400 Requête Incorrecte

Paramètres d'entrée invalides

{
  "statusCode": 400,
  "message": "Invalid input parameters"
}
429

429 Trop de Requêtes

Limite de débit dépassée (100 requêtes par 24 heures)

{
  "statusCode": 429,
  "message": "Rate limit exceeded. Maximum 100 requests per 24 hours."
}

Vous construisez une application automobile? Consultez Kelley Blue Book pour vehicle valuation and buying guides.

HomeBrowseCalcLibrarySaved