Recherchez des API d'images de véhicules et deux produits entièrement différents répondent. Un type accepte les photos que vous avez: il stocke les téléchargements des concessionnaires, supprime les arrière-plans, recadre, comprime et les sert. L'autre type génère l'image à partir des données du véhicule: aucune photo n'existe jusqu'à ce que la demande arrive. Les équipes évaluent régulièrement l'un tout en ayant besoin de l'autre, donc la distinction mérite une page à elle seule.
Ce que les pipelines d'envoi résolvent réellement
Une API de téléchargement est l'infrastructure des photographies. Elle répond à des questions comme où vivent les photos des vendeurs, comment elles sont nettoyées et redimensionnées, et comment elles atteignent le CDN. Si votre produit dépend de la documentation de voitures physiques spécifiques, de leurs bosses et de leurs compteurs kilométriques, ce pipeline est inévitable, et sa qualité se voit dans la vitesse de traitement et la gestion des cas limites.
Ce que les API de livraison résolvent à la place
Une API de livraison comme la nôtre répond à une question différente: à quoi ressemble cette spécification? Elle rend la finition exacte dans la couleur exacte à partir des données du fabricant, encadrée de manière identique pour chaque véhicule, disponible avant qu'aucune voiture physique ne soit photographiée ou même construite. Elle ne peut pas montrer une rayure, et elle ne montre jamais les mauvaises roues.
| Pipeline d'envoi | API de livraison | |
|---|---|---|
| Source | Vos photographies | Données du fabricant |
| Montre l'état | Oui | Non, par conception |
| Cohérence | Des photos aussi bonnes | Identiques par construction |
| Couverture | Ce qui a été photographié | Tout le catalogue |
| Disponible | Après le tournage | Avant que la voiture n'existe |
L'architecture sur laquelle la plupart des plateformes aboutissent
La réponse mature est en couches. L'API de livraison fournit la couche de référence: images principales cohérentes, ensembles d'angles complets, finitions correctes, pour chaque véhicule dès la première seconde. Le pipeline de téléchargement porte la couche de preuve: photos d'état, documentation des dommages, la voiture individuelle. Les annonces, les dossiers de réclamations et les lots aux enchères se lisent mieux lorsque les deux couches sont visiblement distinctes, car chacune répond à la question à laquelle elle est réellement bonne.
- Couche de référence à partir des données: instantanée, uniforme, complète
- Couche de preuve à partir des photos: spécifique, honnête, conditionnelle
- Séparation visuelle claire, afin que l'une ne prétende pas être l'autre
Des questions d'intégration à poser tôt
Pour les pipelines de téléchargement: que se passe-t-il avec une photo de téléphone de cinq mégaoctets à grande échelle, et qui paie pour le stockage sur une décennie. Pour les API de livraison: le trim est-il résolu correctement, et la licence couvre-t-elle vos surfaces. Pour les deux: comment se rencontrent-ils dans votre modèle de données, ce qui signifie généralement un enregistrement de véhicule contenant à la fois une référence de catalogue et une liste de médias. Obtenez la bonne forme d'enregistrement et les deux produits ne se battent jamais.
Si vous êtes arrivé ici à la recherche de réponses sur l'intégration de téléchargement mais que votre véritable problème est l'imagerie de liste incohérente, commencez plutôt par la page marketplace. C'est la confusion la plus courante, et la moins chère à réparer.
Migration entre les deux
Les produits commencent souvent par le téléchargement uniquement et ajoutent la couche de livraison plus tard, et la jonction est sans douleur si l'enregistrement du véhicule a été conçu en tenant compte des deux. Ajoutez la référence du catalogue à côté de la liste des médias, remplissez les données en résolvant les VIN stockés, et changez les surfaces une à la fois. La grille des annonces se convertit généralement en premier, car c'est là que le chaos du téléchargement fait le plus mal visiblement.
Le nom compte aussi. Au sein de votre équipe, appelez les deux couches référence et preuve plutôt que rendus et photos, car la deuxième formulation invite au mauvais débat. Personne ne discute pour savoir si la preuve doit remplacer la référence; tout le monde discute pour savoir si les rendus doivent remplacer les photos.
