Aller au contenu principal

SDK mobile Certificall

Le SDK mobile vous permet de capturer des photos certifiées directement depuis votre propre application, sans passer par l'application Certificall. Chaque prise de vue produit un dossier certifié et son certificat PDF, avec les mêmes garanties de preuve que l'application Certificall : données de confiance de l'appareil, horodatage et score de confiance.

Un seul SDK natif (iOS + Android) est exposé à plusieurs frameworks via des bridges. Cette documentation couvre les deux bridges JavaScript :

Ce que le SDK prend en charge​

Votre application n'a pas à gérer :

  • la collecte des données de confiance (localisation, capteurs de mouvement, informations sur l'appareil, réseau) ;
  • l'authentification vers Certificall ;
  • les tentatives en cas d'échec réseau (3 tentatives avec délai croissant) ;
  • la création du dossier, le dépôt de la photo, la clôture et la génération du certificat PDF ;
  • le déclenchement de votre webhook de dossier, s'il est configuré sur votre entreprise.

Plateformes​

AndroidiOS
SDK natifKotlinSwift
Bridge React Native✅✅
Bridge Capacitor 7✅✅
Expo Go n'est pas supporté

Le SDK est un module natif. Avec Expo, utilisez un development build (expo prebuild), jamais Expo Go.

Comment obtenir le SDK​

Le SDK n'est pas publié sur npm, Maven Central ni CocoaPods. Il vous est livré par votre interlocuteur Certificall sous forme d'une archive zip contenant :

  • le ou les packages npm (.tgz) des bridges demandés : certificall-mobile-sdk-react-native-<version>.tgz et/ou certificall-mobile-sdk-capacitor-<version>.tgz ;
  • si besoin, les binaires natifs seuls (CertificallTrust.xcframework, certificall-trust-sdk.aar) ;
  • le guide d'intégration, le CHANGELOG.md et un fichier SHA256SUMS.
Vérifiez l'intégrité de la livraison

Comparez l'empreinte du package reçu avec celle communiquée par Certificall sur un canal distinct :

shasum -a 256 certificall-mobile-sdk-react-native-<version>.tgz

Les packages .tgz embarquent les binaires natifs : vous n'avez pas à ajouter de .aar ni de .xcframework à la main.

Clé API SDK​

Le SDK s'authentifie avec une clé API SDK, fournie par Certificall et rattachée à votre entreprise. Les dossiers créés par le SDK apparaissent dans votre espace, comme ceux de l'application.

Formatcer_sdk_<identifiant entreprise>_<aléatoire>
Affichageune seule fois, à la création : conservez-la dès réception
Validité1 an par défaut ; la clé peut être désactivée ou renouvelée par Certificall
Limite1 000 requêtes par heure et par clé ; au-delà, le backend répond 429
La clé est embarquée dans votre application

Elle ne peut pas être réellement secrète côté mobile. Prévoyez dès le départ un moyen de la remplacer sans republier votre application (configuration distante), et demandez une nouvelle clé à votre interlocuteur Certificall en cas de doute sur sa diffusion.

Environnements​

Le SDK est configuré avec une baseUrl. Le suffixe /certificall/ est obligatoire dans tous les environnements.

EnvironnementbaseUrl
Productionhttps://admin.certificall.app/certificall/
Pré-productionhttps://dev.certificall.app/certificall/
Symptôme d'une baseUrl sans le suffixe

takePhoto() renvoie { caseId: "0", itemId: "0", score: null } : le SDK a reçu une page HTML d'authentification au lieu d'une réponse JSON.

Parcours d'une photo certifiée​

  1. Au démarrage de votre application, vous configurez le SDK avec la clé API et la baseUrl.
  2. Vous demandez les permissions caméra, localisation et capteurs de mouvement.
  3. Vous appelez takePhoto(), en lui passant votre référence métier (reportToken) et, si utile, des métadonnées.
  4. Le SDK ouvre la caméra, collecte les données de confiance et envoie la photo à Certificall.
  5. Certificall crée un dossier sur la trame SDK de votre entreprise, y dépose la photo, clôture le dossier et génère le certificat PDF.
  6. takePhoto() vous rend les identifiants du dossier et de la photo, l'URL de l'image, l'URL du certificat, la géolocalisation et le score de confiance.
  7. Si un webhook de dossier est configuré sur votre entreprise, il reçoit le contenu du dossier.
Une trame par entreprise

Chaque entreprise dispose d'une trame SDK par défaut, provisionnée avec sa clé API. Une photo certifiée par le SDK est un dossier à une étape ; pour des parcours multi-étapes (formulaires, signatures, plusieurs photos), utilisez l'API et les Certilinks.