Montrer le dommage d’une pièce de carrosserie avant sa dépose

Un recycleur veut vendre une portière avant de la déposer : on ne dépose que ce qui est vendu. Mais les photos prises sur le véhicule montrent la portière de biais, avec pièces voisines et arrière-plan. L’acheteur veut la voir en vue standard — avec le dommage qu’elle a réellement.

Le transfert ne reporte que les constats visibles de la pièce montée sur des vues standard fournies du même composant. Ce qui ne peut être attribué de façon fiable reste hors de l’image et figure dans notTransferred ; faces arrière cachées et surfaces non photographiées ne sont pas complétées. Le résultat est une vue retouchée, non une photo de l’exemplaire — et doit rester identifiable comme telle.

Ce que ce cas suppose

• Une à cinq photos de la pièce montée. Un masque peut être fourni en option par photo via partMaskUrl.
• Des vues standard du même composant. Jusqu’à six vues cibles ; chacune indique sa view. Sans vue standard propre, pas de cible.
• La référence OE de la pièce. Elle porte les données marketplace ; le transfert lui-même n’en a pas besoin.
• Une mention dans l’annonce. Les vues cibles sont des représentations retouchées ; par asset, provenance.requiredLabel indique la mention, et provenance.disclosureEmbedded vaut true.

Le déroulement

Le tableau indique pour chaque étape l’appel compétent et ce qui existe ensuite. La justification de l’étape figure en dessous.

Pourquoi chaque étape est nécessaire

1. Décrire le dommage. POST /vision/damage/describe prend jusqu’à cinq imageUrls du même dommage et renvoie un report ; textQuality choisit entre notes, prose et expert. Le texte décrit le visible et sert de base à la description.
2. Transférer le dommage. POST /vision/part/damage-transfer prend sources avec la pièce montée et targets avec les vues standard, chacune avec view et en option un masque. En retour : assets par vue cible retouchée avec provenance, findings avec type, location, confidence et transferredToViews, ainsi que notTransferred. Si la sortie ne peut être vérifiée de façon sûre, l’appel répond 422 avec damage_not_transferable ou image_edit_unverified.
3. Classer l’état. POST /vision/part/quality renvoie grade, reworkEffort et refinishEffort avec critères et observations — ou gradable false si les images ne suffisent pas. Le niveau va dans l’annonce, l’effort dans le calcul de l’acheteur.
4. Produire les données marketplace. GET /parts/oe/{oeNumber}/seo renvoie content.ebayTitle, categoryId, itemSpecifics et keywords pour la marketplace choisie. Le titre décrit la pièce ; le dommage relève de la description et de l’état, non d’un titre embelli.

curl -X POST \
  -H 'X-Api-Key: <API_KEY>' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: tuer-links-schaden-0917' \
  -d '{"sources":[{"imageUrl":"https://example.com/tuer-montiert.jpg","view":"left"}],"targets":[{"imageUrl":"https://example.com/tuer-standard-links.jpg","view":"left"}],"partType":"Fahrertür links","quality":"standard","output":{"size":"1536x1024","format":"jpeg"}}' \
  'https://api.tapinomahub.com/vision/part/damage-transfer'

Ce que l’on obtient

Il reste une annonce pour une pièce encore montée, avec des vues standard retouchées sur lesquelles des constats visibles ont été transférés, un niveau d’état et une description. On dépose une fois vendu.

Où cela figure dans la documentation

Les listes de champs contractuelles, les codes d’erreur et les réponses d’exemple se trouvent dans le contrat OpenAPI de cette surface, à l’adresse docs.tapinomahub.com (tapinoma-hub). Tous les cas d’usage classés par surface et par rôle : aperçu des cas d’usage.