SPB Git forge

spb/auto-ka

Public
61commits 1branches 0releases
14.4 MBsize
maindefault branch
13 days agolast push
Python 61.6% TypeScript 20.9% CSS 11.4% JavaScript 5.1% HTML 1.1%
2.6 KB

# Module otogo — Nuxt / API JSON publique /api-search/

Généré automatiquement par scripts/gen_connector_docs.py — ne pas éditer à la main.

# Vue d'ensemble

  • Fichier : autoka/connectors/otogo.py
  • Sources membres : 1
  • Annonces actives (BD) : 24201
  • Backend de fetch : requests direct (aucun anti-bot)
  • Mécanique détectée : endpoint JSON
  • Plafonds / cache : AUTOKA_OTOGO_MAX
  • Classes : OtogoQuebec → otogo

# Mécanique (en-tête du module)

connectors/otogo.py : PORTAIL — Otogo.ca (LC Media, 100 % Québec)

Otogo expose une API JSON publique, sans clé ni rendu JS : GET https://www.otogo.ca/api-search/?latlng=0,0&locale=fr&no_facets= &rpp=100&page=N&status=Usagé,Certifié,Démo[&price=lo-hi] Chaque annonce de la liste est déjà riche : titre/version FR, année, prix, kilométrage, VIN (≈100 %), nom du concessionnaire et surtout le GPS EXACT du vendeur (latitude/longitude) — parfait pour la recherche par rayon et la dédup VIN avec les concessionnaires connectés. (Paramètres découverts dans les bundles Nuxt : constantes c.b du module 5731047.js — latlng/locale/rpp/page/price/status/no_facets/no_results.)

Profondeur : l'API plafonne à ~1 000 résultats par requête (rpp=100 → meta.pages ≤ 10) pour ~24 000 annonces d'occasion. On PARTITIONNE donc par tranches de prix (bissection récursive + tranche ouverte « lo- ») : chaque annonce n'est téléchargée qu'une fois, ~250 requêtes directes par sync complet, zéro crédit d'API de scraping externe.

Ville : absente de la liste — déduite du GPS exact via nearest_city() (data/villes_gps.json) pour l'affichage et la région administrative. Carburant/boîte : absents de la liste ; repli commun finalize() (jetons du titre/de la version). Page détail : /auto/{slug_fr} (non visitée — économie ; le VIN et le GPS sont déjà dans la liste).

Plafond : AUTOKA_OTOGO_MAX (défaut 0 = inventaire complet).

# Complétude des champs (annonces actives, N = 24 201)

Champ % rempli
Marque 99.9 %
Modèle 100.0 %
Année 100.0 %
Kilométrage 99.3 %
Prix 100.0 %
Carburant 8.0 %
Boîte (transmission) 0.0 %
VIN 99.2 %
Photos 96.7 %
Carfax 0.0 %
GPS (lat/lng) 100.0 %

# Sources membres (BD live)

Source Nom Ville Région Actives Masquées (dup VIN) Dernier sync Statut
otogo Otogo.ca — — 24201 6766 2026-09-13 16:20 OK (24051 trouvés)

# Erreurs de synchronisation récentes

Aucune erreur dans le sync_log pour les sources de ce module.