Données partielles

Une réponse peut être partielle de deux façons, qu'il ne faut pas confondre :

Le statut partial

partial veut dire qu'une identité existe, mais qu'elle ne satisfait pas la politique de résolution : il lui manque un champ requis, ou sa confiance est sous le seuil. L'enrichissement n'est pas facturé (billable: false, units: 0), et en Sandbox il ne consomme pas la dotation.

"merchant": { "name": "Enseigne", "location": null, "confidence": 0.88 },
"enrichment": { "status": "partial", "reason": "missing_required_fields", "…": "…" }

Cet extrait illustre la forme : ici category manque, ce qui suffit à rendre le résultat partial.

Ce que garantit un partial :

• merchant n'est pas null et porte un name ;
• enrichment.reason dit pourquoi le résultat n'est pas resolved.

Les champs facultatifs d'un résultat complet

Sous la politique en vigueur, un résultat resolved porte toujours name et category. Les autres champs dépendent de ce que le catalogue sait :

Un resolved sans logo ni localisation reste un résultat complet et facturé : la politique ne les exige pas.

Que faire d'une donnée partielle

• Ne promouvez pas un partial en resolved. Son nom peut être juste, mais Noryo ne s'engage pas dessus, et il n'est pas facturé pour cette raison.
• Affichez ce qui est là, sans inventer le reste. Pas de logo générique présenté comme celui de l'enseigne, pas de ville déduite de votre country.
• Retentez plus tard si c'est utile. Un rafraîchissement avec la même entrée économique peut aboutir à refresh_recalculated ; il n'est facturé que dans ce cas. Voir Rafraîchir.
• Mesurez la part de partial dans votre trafic, par raison : c'est le signal de couverture le plus direct. La page Usage de Platform les compte par jour.

const m = body.merchant;
if (body.enrichment.status === "partial") {
  show({ name: m.name, category: m.category ?? null, logo: null, tentative: true });
}