Référence : takePhoto, résultat et métadonnées

Cette page détaille le contrat de takePhoto(), commun aux bridges React Native et Capacitor : ce que vous fournissez, ce que vous recevez, et comment retrouver le dossier côté Certificall.

Paramètres

Paramètre	Type	Requis	Description
reportToken	string	non	Votre référence métier pour ce dossier : numéro de chantier, identifiant client, référence de sinistre… Elle est renvoyée en écho dans le résultat et associée au dossier comme référence de rapport : vous la retrouvez dans l'API (GET /cases?reportToken=…) et dans le webhook de dossier (reportId).
metadata	Record<string, string>	non	Métadonnées libres clé-valeur, enregistrées avec le dossier. Voir la mise en garde ci-dessous.

Options supplémentaires du bridge Capacitor : quality, width, extractExif, source (camera ou gallery).

Rattachez vos dossiers avec reportToken, pas avec metadata

Les métadonnées passées au SDK sont enregistrées avec le dossier, mais elles ne sont pas restituées aujourd'hui : ni dans l'interface admin, ni dans l'API, ni dans le payload du webhook de dossier. Pour rattacher automatiquement un dossier reçu par webhook ou par API à votre système, mettez votre identifiant dans reportToken.

Résultat : CertifiedPhotoResult

const result = await CertificallTrust.takePhoto({ reportToken: 'CHANTIER-2026-001' });

Champ	Type	Description
itemId	string	Identifiant de la photo certifiée.
caseId	string	Identifiant du dossier créé pour cette photo.
reportToken	string, optionnel	Votre référence, renvoyée en écho si vous l'aviez fournie.
imageUrl	string	URL signée de la photo certifiée.
pdfUrl	string	URL publique du certificat PDF (lien de partage).
geoloc	{ lat, lng }, optionnel	Coordonnées GPS de la capture.
createdAt	string	Date de création côté serveur, au format ISO 8601.
score	number, optionnel	Score de confiance global du dossier, ajouté par le SDK après l'analyse de la capture. Absent si l'analyse n'a pas répondu.

Le SDK transmet tels quels les champs renvoyés par le backend : un champ ajouté par Certificall à l'avenir sera disponible sans mise à jour du SDK.

Un dossier par photo

Chaque appel à takePhoto() crée un dossier sur la trame SDK de votre entreprise, y dépose la photo, clôture le dossier et génère son certificat. Le caseId renvoyé est celui de ce dossier.

Erreurs

En cas d'échec réseau, le SDK réessaie 3 fois avec un délai croissant avant de rejeter l'appel. Les refus du backend ne sont pas réessayés :

Réponse	Cause
401	Clé API absente, mal formée, inconnue, désactivée ou expirée.
429	Plus de 1 000 requêtes dans l'heure pour cette clé.
503	Contrôle de limite temporairement indisponible : réessayez plus tard.

Un résultat { caseId: "0", itemId: "0", score: null } sans erreur signale une baseUrl sans le suffixe /certificall/ (voir Environnements).

Instantané de l'appareil : getDeviceSnapshot()

Indépendamment de la photo, le SDK peut vous rendre un instantané de l'appareil pour vos propres écrans :

const snapshot = await CertificallTrust.getDeviceSnapshot({
  includeLocation: true,
  includeMotion: true,
});

Champ	Contenu
device	Constructeur, modèle, système et version, exécution sur émulateur, et selon la plateforme : nom, identifiant technique, mémoire et stockage.
location	Position courante (coords, timestamp), si includeLocation.
motion	Accélération et vitesse de rotation, si includeMotion.
devMode	{ enabled } : mode développeur activé sur l'appareil, selon la plateforme.
timestamp	Date de l'instantané.

Retrouver le dossier côté Certificall

Où	Comment
Interface admin	Le dossier apparaît dans la liste des dossiers de votre entreprise, avec sa photo et son certificat.
API	GET /cases?reportToken=<votre référence>&format=metadata ou GET /cases?caseId=<caseId>&format=metadata (voir Gestion des dossiers).
Analyse de confiance	GET /cases/:caseId/analysis si l'option d'analyse est active sur votre entreprise (voir Analyse documentaire).
Webhook	Le webhook de dossier reçoit le contenu du dossier à sa clôture, c'est-à-dire juste après la photo.