Composer un dossier de litige avec l'API
tryVidimus ne fabrique pas de dossier de litige : nous sommes un tiers neutre, et le dossier d'un litige vous appartient. Il n'y a pas d'appel spécial. Les appels que vous utilisez déjà suffisent à réunir, pour une transaction, chaque photo, le lien entre l'« avant » et l'« après », et les données que n'importe qui peut utiliser pour les vérifier.
1. Réunir les preuves de la transaction
Listez les preuves avec l'external_reference donné à la création des sessions de capture. Gardez celles qui sont scellées (status=sealed). Chaque preuve indique qui a capturé (party), à quel moment (stage), quand elle a été scellée (sealed_at) et la liste de ses fichiers (media).
$ curl "https://api.tryvidimus.com/v1/proofs?external_reference=booking_4471" \ -H "Authorization: Bearer $TRYVIDIMUS_API_KEY"
2. Associer l'« avant » et l'« après »
Si vous avez relié les deux captures avec compare_to, lisez le lien sur chaque preuve : un « après » donne compare_to (l'id de son « avant »), un « avant » donne compared_by (l'id de son « après »). C'est ce qui montre qu'une photo prise au retour répond à une photo prise à la remise.
// GET /v1/proofs/prf_01m4akapdbe8ev5xgt0hkpcn14 (the "after")
{ "id": "prf_01m4akapdbe8ev5xgt0hkpcn14", "compare_to": "prf_01m4akapdbe8e8qq3er9r5qwyj", "compared_by": null, … }
// GET /v1/proofs/prf_01m4akapdbe8e8qq3er9r5qwyj (the "before")
{ "id": "prf_01m4akapdbe8e8qq3er9r5qwyj", "compare_to": null, "compared_by": "prf_01m4akapdbe8ev5xgt0hkpcn14", … }
// GET /v1/proofs?linked=false → the proofs still waiting for their "after"
3. Récupérer les photos
Pour chaque fichier d'une preuve scellée, demandez un lien d'accès : il donne un lien temporaire (15 minutes par défaut) vers la copie signée, directement depuis le stockage. Téléchargez les octets tout de suite et ne conservez pas le lien. L'original n'est jamais proposé. Cet appel demande votre clé d'API (droit read_proof).
// GET /v1/proofs/prf_01m4akapdbe8ev5xgt0hkpcn14/media/med_01m4akapdbe8e8qq3er9r5qwyj/access-link
{ "url": "https://…", "expires_at": "2026-10-30T10:15:00.000Z" }
// GET /v1/public/proofs/prf_01m4akapdbe8ev5xgt0hkpcn14/bundle (no API key)
{ "proof_id": "prf_01m4akapdbe8ev5xgt0hkpcn14", "media": [ { "manifest_id": "…", "signed_sha256": "…" } ], "timestamp": { … }, … }
4. Ajouter ce qui prouve l'intégrité
Le paquet public d'une preuve (sans clé d'API) donne, pour chaque fichier, son manifest_id et son signed_sha256, avec le jeton d'horodatage et la preuve de Merkle. Gardez le signed_sha256 à côté de chaque photo et ajoutez sealed_at tiré de la preuve. N'importe qui peut ensuite vérifier la photo, avec le vérificateur open source, sans vous demander ni nous demander.
5. Assembler le tout
Ce script réunit tout pour une transaction. Ce que vous en faites vous appartient : un ZIP, un PDF, une page web, l'avant et l'après côte à côte. Gardez votre mise en page ; les preuves restent les mêmes, quel que soit le format.
const API = "https://api.tryvidimus.com";
const headers = { Authorization: `Bearer ${process.env.TRYVIDIMUS_API_KEY}` };
const get = (path, init) => fetch(API + path, init).then((r) => r.json());
// 1. Every proof of the transaction (sealed ones only)
const { data } = await get("/v1/proofs?external_reference=booking_4471&status=sealed", { headers });
const file = [];
for (const proof of data) {
// 2. Integrity: the public bundle, no API key
const bundle = await get(`/v1/public/proofs/${proof.id}/bundle`);
for (const media of proof.media) {
// 3. The photo: a temporary link to the signed copy
const { url } = await get(`/v1/proofs/${proof.id}/media/${media.id}/access-link`, { headers });
const hashes = bundle.media.find((m) => m.signed_sha256 === media.signed_sha256);
file.push({
stage: proof.stage, // "pickup" or "return"
party: proof.party,
sealed_at: proof.sealed_at,
compare_to: proof.compare_to, // the "before" this "after" answers
photo: await fetch(url).then((r) => r.arrayBuffer()),
signed_sha256: media.signed_sha256,
manifest_id: hashes?.manifest_id,
verify_at: `${API}/v1/public/proofs/${proof.id}/bundle`,
});
}
}
// 4. Lay out `file` as you like: before / after side by side, in your own format.
Ce que nous ne faisons pas
Nous ne comparons pas les photos, ne jugeons pas l'état de l'objet et ne prenons pas parti. Les preuves montrent ce que chaque partie a capturé, quand, et que rien n'a changé depuis. Les peser et décider qui a raison reste l'affaire de l'organisation et des personnes qui règlent le litige.