Skip to main content

API-Dokumentation

Integrate vehicle depreciation calculations into your applications.

📖

Übersicht

AssetDropper bietet eine kostenlose REST-API für Fahrzeugwertverlustberechnungen. Perfekt für Entwickler, die Automobilwerkzeuge, Autokaufführer oder Finanzplanungsanwendungen erstellen.

🔌

RESTful API

Simple JSON-based API with predictable resource-oriented URLs

⏱️

Ratenlimits

  • 100 Anfragen pro Tag pro IP-Adresse
  • Keine Authentifizierung erforderlich
  • Ratenlimit wird um Mitternacht UTC zurückgesetzt
🔗

Endpunkte

POST/api/depreciate

Berechnen Sie den Fahrzeugwertverlust basierend auf Kaufjahr, Preis und Fahrzeugtyp.

Anfrage-Body

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

Parameter

FeldTypErforderlichBeschreibung
purchaseYearnumberJaJahr des Fahrzeugkaufs (1900 bis aktuelles Jahr)
purchasePricenumberJaKaufpreis in USD (positiv, maximal 10.000.000)
vehicleTypestringJaTyp: sedan, suv, truck, luxury, economy, sports, ev, motorcycle, rv
currentMileagenumberNeinAktueller Kilometerstand (nicht negativ, Standard 0)

Antwortbeispiel

{
  "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"
  }
}
💻

Code-Beispiele

🚀

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']}")
⚠️

Fehlerantworten

400

400 Ungültige Anfrage

Ungültige Eingabeparameter

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

429 Zu viele Anfragen

Ratenlimit überschritten (100 Anfragen pro 24 Stunden)

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

Erstellen Sie eine Automobilanwendung? Schauen Sie sich Edmunds für vehicle reviews and true market value pricing.