Saltar al contenido

Guías

Sincroniza todo el inventario

Dos feeds mantienen al día un catálogo local: /cars para el inventario activo y /archived-lots para los anuncios que ya no están.

  1. 1

    Crea el catálogo inicial

    Recorre las páginas de /cars, con simple_paginate=1 cuando no necesites totales. Guarda el ID del vehículo, la fuente, los identificadores del lote y las marcas de tiempo de actualización.

  2. 2

    Recoge las actualizaciones

    Consulta /cars?minutes=60 para una ventana de una hora, o elige una ventana acorde a tu intervalo de consulta (1–4320 minutos). Lee todas las páginas con los mismos filtros.

  3. 3

    Procesa los anuncios archivados

    Consulta /archived-lots?minutes=60 con una ventana equivalente y marca ese lote de la fuente como inactivo. Un lote archivado no significa que todos los anuncios del vehículo estén inactivos.

  4. 4

    Aplica los cambios de forma idempotente

    Haz upsert por identificadores. Usa ventanas solapadas y marcas de tiempo guardadas para tolerar reintentos y duplicados.

  5. 5

    Concilia periódicamente

    Una ventana móvil no es un cursor duradero. Tras una interrupción de más de 72 horas, reconstruye el inventario activo en lugar de confiar en el feed incremental.

Archiva a nivel de lote con lot_id. Un vehículo puede tener otros lotes activos. Las respuestas antiguas del archivo contienen bid/sale_date escalares; las nuevas usan {value, updated_at}. No asumas que un bid antiguo es un precio de venta final confirmado.

Un ejemplo de Python listo para ejecutar en el servidor: recorre las páginas de ambos feeds, inserta o actualiza vehículos y lotes en SQLite y archiva solo el lote afectado. Usa una clave del entorno del servidor, timeouts, reintentos limitados y un checkpoint del último éxito. Instala requests. Define AUCTIONS_API_KEY en el servidor y ejecuta una vez python sync_auction_cars.py --initial; programa las siguientes ejecuciones sin --initial. Tamaños de página por defecto: cars=50, archivo=100. Con Unlimited puedes definir AUCTIONS_CARS_PER_PAGE=1000 y AUCTIONS_ARCHIVE_PER_PAGE=1000. Ejecuta un solo worker a la vez (bloqueo del programador); adapta el almacenamiento SQLite y concilia los huecos de más de 72 horas. Este ejemplo no convierte el feed cambiante en una instantánea fija.

© 2025. AuctionsAPI operates independently and is not affiliated with Copart, IAAI or Encar.