(a) — Développeurs
Afficher un constat vérifié sur votre site.
Place de marché, site de revendeur, forum : vérifiez un constat Dorynn à partir de sa référence et de son empreinte, et affichez le badge « Vérifié par Dorynn ». Lecture seule, sans clé ni inscription.
(b) — Vérifier un constat
Une requête GET, depuis votre serveur ou directement depuis le navigateur (CORS ouvert à tous les sites). La réponse contient le résumé public du constat : jamais le numéro de série, ni l’identité ou l’adresse e-mail du client, ni le détail des points.
GET https://dorynn-s-fresh-look-b1aee12c.onrender.com/v1/verify/CST-2026-09-K0M1?e=a3f91c
- référence
- Référence du constat, CST-AAAA-MM-XXXX (sur le constat et le badge).
- e
- Empreinte à 6 caractères du constat (obligatoire : la référence seule ne suffit pas).
Réponse (exemple fictif)
{
"reference": "CST-2026-09-K0M1",
"fingerprint": "a3f91c",
"sealedAt": "2026-09-30T10:12:00.000Z",
"item": {
"brandModel": "Rolex Datejust 1601",
"category": { "slug": "watches", "labelFr": "Montres & horlogerie", "labelEn": "Watches" },
"format": "EXPERT"
},
"expert": { "name": "Claire Vidal", "slug": "claire-vidal" },
"protocol": { "code": "WAT", "version": "1.0" },
"points": { "total": 12, "ok": 10, "alert": 2, "notChecked": 0 },
"integrity": { "content": true, "photos": { "total": 6, "valid": 6, "checked": true } },
"upheldDisputes": 0,
"secondOpinion": { "compared": 12, "agreements": 11, "reviewedAt": "2026-09-30T09:40:00.000Z" },
"version": { "number": 1, "latest": 1, "supersededAt": null },
"versions": [
{ "version": 1, "fingerprint": "a3f91c", "at": "2026-09-30T10:12:00.000Z", "reason": null, "requestedBy": null, "changes": [], "intact": true }
],
"passport": { "dorynnId": "DY-0EX0M1", "inspection": 1, "inspections": 1, "serialConfirmed": true }
}Ce qu’il faut lire
- integrity.content
- true : le contenu est identique à celui scellé par l’expert. N’affichez « vérifié » que dans ce cas.
- points
- Bilan des points contrôlés : conformes, avec réserve, non vérifiés (un point non vérifié n’est jamais présumé conforme).
- version
- Si latest est supérieur à number, le constat a été corrigé depuis : renvoyez vers la version en vigueur.
- upheldDisputes
- Nombre de contestations jugées fondées, consignées à côté du constat (le constat, lui, ne change jamais).
- passport
- Identifiant Dorynn de l’objet et rang de ce constat dans son historique.
Codes de réponse
- 200
- Constat trouvé : résumé public.
- 400
- INVALID_FINGERPRINT : empreinte absente ou mal formée (6 caractères hexadécimaux).
- 404
- REPORT_NOT_FOUND : référence inconnue ou empreinte incorrecte (même réponse, pour empêcher de parcourir les références).
- 429
- Trop de requêtes : 20 par minute et par adresse. Mettez les réponses en cache.
const response = await fetch(
"https://dorynn-s-fresh-look-b1aee12c.onrender.com/v1/verify/" + encodeURIComponent(reference) + "?e=" + fingerprint,
);
if (response.ok) {
const report = await response.json();
if (report.integrity.content) {
// Afficher « Vérifié par Dorynn » et un lien vers https://dorynn.com/v/…
}
}(c) — Badge et lien court
Une image PNG générée à la demande (carré 1080 × 1080 pour une photo d’annonce, bandeau 1200 × 300 pour une page ou un forum), avec un QR code vers la vérification publique. Le lien court ouvre la page de vérification de Dorynn.
GET https://dorynn-s-fresh-look-b1aee12c.onrender.com/v1/verify/CST-2026-09-K0M1/badge.png?e=a3f91c&lang=fr
- e
- Empreinte (obligatoire).
- lang
- fr (défaut) ou en.
- variant
- square (défaut) ou banner.
Lien court
https://dorynn.com/v/CST-2026-09-K0M1-a3f91c
Intégration HTML
<a href="https://dorynn.com/v/CST-2026-09-K0M1-a3f91c">
<img src="https://dorynn-s-fresh-look-b1aee12c.onrender.com/v1/verify/CST-2026-09-K0M1/badge.png?e=a3f91c&lang=fr&variant=banner"
alt="Vérifié par Dorynn — CST-2026-09-K0M1" width="600" height="150">
</a>(d) — Règles d’usage
- 01Affichez « Vérifié par Dorynn » seulement si integrity.content vaut true, et gardez un lien vers la page de vérification de Dorynn.
- 02Mettez les réponses en cache une heure au plus : une contestation jugée fondée ou une correction peut changer le résumé.
- 03Un constat décrit un état observé à une date : ne le présentez ni comme une garantie, ni comme une authentification de l’objet.
- 04N’utilisez la référence et l’empreinte que pour vérifier le constat auquel elles appartiennent.
- 05Le format de la réponse (v1) évolue sans rupture : de nouveaux champs peuvent apparaître, aucun n’est retiré sans préavis.
(e) — Aller plus loin
Commander des constats pour vos vendeurs ?
Commande pour le compte d’un vendeur, notification au scellement, facturation groupée : ces intégrations se construisent avec chaque plateforme. Pour des commandes en volume dès aujourd’hui, l’offre pro regroupe les commandes et facture une fois par mois.