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 · 68 lines markdown
Rendered Raw Blame History
1# Module `otogo` — Nuxt / API JSON publique /api-search/23_Généré automatiquement par `scripts/gen_connector_docs.py` — ne pas éditer à la main._45## Vue d'ensemble67- **Fichier** : `autoka/connectors/otogo.py`8- **Sources membres** : 19- **Annonces actives (BD)** : 2420110- **Backend de fetch** : requests direct (aucun anti-bot)11- **Mécanique détectée** : endpoint JSON12- **Plafonds / cache** : AUTOKA_OTOGO_MAX13- **Classes** : `OtogoQuebec` → `otogo`1415## Mécanique (en-tête du module)1617> connectors/otogo.py : PORTAIL — Otogo.ca (LC Media, 100 % Québec)18> 19> Otogo expose une API JSON publique, sans clé ni rendu JS :20> GET https://www.otogo.ca/api-search/?latlng=0,0&locale=fr&no_facets=21> &rpp=100&page=N&status=Usagé,Certifié,Démo[&price=lo-hi]22> Chaque annonce de la liste est déjà riche : titre/version FR, année,23> prix, kilométrage, VIN (≈100 %), nom du concessionnaire et surtout le24> GPS EXACT du vendeur (latitude/longitude) — parfait pour la recherche25> par rayon et la dédup VIN avec les concessionnaires connectés.26> (Paramètres découverts dans les bundles Nuxt : constantes c.b du module27> 5731047.js — latlng/locale/rpp/page/price/status/no_facets/no_results.)28> 29> Profondeur : l'API plafonne à ~1 000 résultats par requête (rpp=100 →30> meta.pages ≤ 10) pour ~24 000 annonces d'occasion. On PARTITIONNE donc31> par tranches de prix (bissection récursive + tranche ouverte « lo- ») :32> chaque annonce n'est téléchargée qu'une fois, ~250 requêtes directes33> par sync complet, zéro crédit d'API de scraping externe.34> 35> Ville : absente de la liste — déduite du GPS exact via nearest_city()36> (data/villes_gps.json) pour l'affichage et la région administrative.37> Carburant/boîte : absents de la liste ; repli commun finalize() (jetons38> du titre/de la version). Page détail : /auto/{slug_fr} (non visitée —39> économie ; le VIN et le GPS sont déjà dans la liste).40> 41> Plafond : AUTOKA_OTOGO_MAX (défaut 0 = inventaire complet).4243## Complétude des champs (annonces actives, N = 24 201)4445| Champ | % rempli |46|---|---|47| Marque | 99.9 % |48| Modèle | 100.0 % |49| Année | 100.0 % |50| Kilométrage | 99.3 % |51| Prix | 100.0 % |52| Carburant | 8.0 % |53| Boîte (transmission) | 0.0 % |54| VIN | 99.2 % |55| Photos | 96.7 % |56| Carfax | 0.0 % |57| GPS (lat/lng) | 100.0 % |5859## Sources membres (BD live)6061| Source | Nom | Ville | Région | Actives | Masquées (dup VIN) | Dernier sync | Statut |62|---|---|---|---|---|---|---|---|63| `otogo` | Otogo.ca | — | — | 24201 | 6766 | 2026-09-13 16:20 | OK (24051 trouvés) |6465## Erreurs de synchronisation récentes6667Aucune erreur dans le sync_log pour les sources de ce module.68