Documentación de API

📖

Descripción General

AssetDropper proporciona una API REST gratuita para cálculos de depreciación de vehículos. Perfecto para desarrolladores que crean herramientas automotrices, guías de compra de automóviles o aplicaciones de planificación financiera.

🔌

RESTful API

Simple JSON-based API with predictable resource-oriented URLs

⏱️

Límites de Velocidad

100 solicitudes por día por dirección IP
No se requiere autenticación
El límite de velocidad se reinicia a medianoche UTC

🔗

Endpoints

POST/api/depreciate

Calcule la depreciación del vehículo según el año de compra, el precio y el tipo de vehículo.

Cuerpo de Solicitud

JSON

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

Parámetros

Campo	Tipo	Requerido	Descripción
`purchaseYear`	number	Sí	Año en que se compró el vehículo (1900 al año actual)
`purchasePrice`	number	Sí	Precio de compra en USD (positivo, máximo 10,000,000)
`vehicleType`	string	Sí	Tipo: sedan, suv, truck, luxury, economy, sports, ev, motorcycle, rv
`currentMileage`	number	No	Kilometraje actual (no negativo, predeterminado 0)

Ejemplo de Respuesta

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

💻

Ejemplos de Código

🚀

Quick Start

Copy any of these examples to get started in seconds

cURL

bash

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

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);

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

⚠️

Respuestas de Error

400

400 Solicitud Incorrecta

Parámetros de entrada inválidos

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

429

429 Demasiadas Solicitudes

Límite de velocidad excedido (100 solicitudes por 24 horas)

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

¿Está construyendo una aplicación automotriz? Visite CarGurus para compare used vehicle prices and find deals.