REST API
API de valoraciones
Integra el tasador ARST directamente en tu flujo. Autenticación por API key, respuesta en JSON, sin SDK propietario.
Autenticación
Los endpoints de valoración requieren un API key en el header Authorization.
Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Formato
Bearer token (sk_live_…)
Crédito
1 por vehículo tasado (/valuation, /comparable, /batch) · /pdf y los endpoints públicos no consumen créditos
Rate limit (burst)
300 req/min por API key
Alternativa
Cookie arst_token (sesión web)
Cuota diaria por plan
Además del burst de 300 req/min, cada API key tiene un tope de llamadas por día que se reinicia a las 00:00 UTC. Al superarlo, la API responde 429 con el header Retry-After.
Genera tu API key en Mi cuenta → API Keys. El valor en claro se muestra solo al crear la key.
Endpoints
Códigos de error
| HTTP | Causa |
|---|---|
401 | API key ausente, inválida o revocada |
402 | Sin créditos: recarga en /pricing |
403 | Tu plan no incluye este endpoint (p. ej. /comparable o /batch en plan Free) |
422 | Parámetros inválidos (país, combustible…) |
429 | Cuota diaria o rate limit superados — respeta el header Retry-After |
503 | Modelo no disponible para ese país |
Ejemplo rápido
curl -X POST 'https://rv.arstdata.com/api/v1/valuation' \
-H 'Authorization: Bearer sk_live_YOUR_KEY' \
-H 'Content-Type: application/json' \
-d '{
"country": "ES",
"brand": "BMW",
"model": "320D",
"year": 2020,
"km": 65000,
"fuel": "diesel",
"current_price": 25000
}'Límites de uso
Ver referencia de endpoints
Rutas, parámetros y ejemplos de respuesta en esta página
Genera tu API key
Mi cuenta → API Keys → Nueva clave