Aller au contenu
Pour les développeurs

L'API de preuve photo.

Ouvrez depuis votre application une page de capture à votre marque, et recevez une preuve scellée : un horodatage qualifié eIDAS, une signature C2PA et un lien de vérification public. Du JSON sur HTTPS, rien de plus.

  • Horodatage qualifié eIDAS
  • Conforme C2PA (photos)
  • Vérificateur open source
  • Mode test gratuit, sans carte
Votre logo, votre couleur et vos textes, dans la langue de vos utilisateurs. La page de capture est une page web que votre application ouvre.
Le problème

L'horodatage est la partie facile. Tout le reste ne l'est pas.

Construire la preuve photo soi-même, c'est faire tourner toute une chaîne avant que la première photo tienne.

  • Horodatages qualifiés et signaturesUn contrat avec un prestataire de confiance qualifié, des clés de signature, des chaînes de certificats et des manifestes C2PA : à acheter, exploiter et renouveler.
  • Une capture digne de confianceUn parcours photo qui refuse l'import depuis la galerie, envoie les fichiers directement au stockage et parle la langue de vos utilisateurs.
  • Une preuve qu'un tiers peut vérifierDes originaux conservés intacts, une page de vérification publique, et un moyen de vérifier une preuve sans faire confiance à vos serveurs.
L'API

Une API, service par service.

Chaque carte mène à sa page de la documentation.

  • Sessions de capture

    Créez un lien de capture à usage unique pour une transaction et ouvrez-le depuis votre application : une page en marque blanche pour des photos prises en direct.

    • POST /v1/capture-sessions
  • Preuves

    Suivez chaque preuve de la capture au scellement, lisez son statut et ses fichiers, retrouvez-la par votre propre référence.

    • GET /v1/proofs
    • GET /v1/proofs/{id}
  • Vérification

    Une page de vérification publique que chacun peut ouvrir, sans compte, et un vérificateur open source (MIT) pour vérifier une preuve sans nous.

    • GET /v1/public/proofs/{id}
  • Webhooks signés

    Soyez prévenu sur votre serveur dès qu'une preuve est scellée. Chaque envoi est signé et journalisé, et vous pouvez envoyer un événement de test.

    • POST /v1/webhook-endpoints
  • Modèles et apparence

    Choisissez les prises de vue et les textes dans chaque langue, et l'apparence de la page de capture : votre logo et votre couleur.

    • POST /v1/capture-templates
    • POST /v1/capture-themes
  • Retour dans votre application

    Ramenez la personne dans votre application après la dernière photo, vers une adresse déclarée à l'avance.

    • return_url
Boîte à outils

Utilisez-la depuis les outils que vous avez déjà.

Les paquets sont publiés sur npm sous licence MIT.

Démarrer

Du compte à la production en quatre étapes.

  1. 01

    Créez un compte

    Gratuit, sans carte. 5 € offerts, utilisables en production.

  2. 02

    Créez une clé de test

    Dans votre espace, rubrique Clés d'API. Elle commence par sk_test_ : gardez-la dans une variable d'environnement, jamais dans le code.

  3. 03

    Scellez une première preuve de test

    Créez une session de capture, ouvrez le lien sur un téléphone, prenez les photos et recevez le webhook proof.sealed. Horodatages simulés, rien n'est facturé.

  4. 04

    Passez en production

    Passez à une clé live : chaque preuve scellée reçoit un horodatage qualifié eIDAS et est débitée de votre solde.

En code

Un appel ouvre une capture.

curl, Node.js ou Python : le même JSON, et la réponse que vous recevez.

$ curl -X POST https://api.tryvidimus.com/v1/capture-sessions \
  -H "Authorization: Bearer $TRYVIDIMUS_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"external_reference":"booking_4471","party":"provider","stage":"pickup"}'
← 201 { "capture_url": "https://api.tryvidimus.com/v1/capture-sessions/…",
        "expires_at": "2026-09-28T18:30:00Z" }
→ webhook proof.sealed  prf_018f2e4a · booking_4471
Fiabilité

Fait pour être vérifié.

  • Page de statut publiqueL'API, la page de capture, la page de vérification et la documentation, surveillées depuis l'extérieur.Ouvrir la page de statut ↗
  • Mode test gratuitToute l'API avec des horodatages simulés. Rien n'est facturé avant le passage en production.
  • Fichiers de test supprimés après 48 heuresLes preuves de production et leurs fichiers sont conservés 24 mois, plus longtemps en cas de litige ouvert.
  • Une API versionnéeChaque route est sous /v1, et son contrat est le schéma OpenAPI publié.

FAQ développeurs

Faut-il un SDK ?
Non. L'API est du JSON sur HTTPS et son schéma est public : appelez-la directement ou générez un client. Un client TypeScript typé est sur npm.
Quelle différence entre test et production ?
Une clé de test (sk_test_) donne toute l'API avec des horodatages simulés : gratuite, sans valeur juridique, fichiers supprimés après 48 heures. Une clé live (sk_live_) scelle les preuves avec un horodatage qualifié eIDAS, débité de votre solde.
Est-ce que ça marche dans une application mobile ?
Oui. La page de capture est une page web : votre application l'ouvre dans une vue web et lui donne accès à l'appareil photo. Aucun SDK natif à installer.
Les photos passent-elles par mes serveurs ?
Non. Elles vont directement du téléphone au stockage. Votre serveur crée seulement la session de capture et lit la preuve.
Comment vérifier une preuve sans vous faire confiance ?
La page de vérification est publique et ne demande aucun compte. Le vérificateur est open source (MIT) et publié sur npm : il recalcule les empreintes et contrôle l'horodatage tout seul.
Qu'est-ce qui est scellé ?
Les photos prises en direct sur la page de capture. Chacune reçoit une empreinte, un horodatage (qualifié eIDAS) et une signature (C2PA).

Commencez en mode test, gratuitement.

Créez un compte, une clé de test, et scellez votre première preuve aujourd'hui.

Créer un compte