API Certification de Documents

Certifiez vos documents PDF avec des QR codes sécurisés. Vérifiez l'authenticité et l'intégrité de vos documents grâce à notre système de certification basé sur des hash SHA-256.

Documentation Swagger

Fonctionnalités Principales

Upload & Certification

Téléchargez et certifiez vos documents PDF avec un QR code personnalisable en une seule requête.

Vérification d'Intégrité

Vérifiez l'authenticité et détectez toute altération des documents grâce aux hash SHA-256.

QR Code Personnalisé

Ajoutez des valeurs personnalisées dans le QR code (références, IDs transaction, etc.).

Authentification Basic

Sécurisation des endpoints avec authentification Basic HTTP pour protéger vos documents.

Vérification Publique

Endpoints publics pour vérifier et visualiser les documents sans authentification.

Gestion PDF

Traitement avancé des PDF avec insertion de QR codes et gestion des métadonnées.

Cas d'Usage

Documents Administratifs

Certifiez vos contrats, factures, attestations et autres documents officiels pour garantir leur authenticité et leur intégrité dans le temps.

Diplômes & Certificats

Protégez vos diplômes et certificats académiques contre la falsification. Vérification instantanée via QR code pour les employeurs et institutions.

Transactions Commerciales

Sécurisez vos devis, commandes et bons de livraison avec des références transactionnelles intégrées dans le QR code.

Documents Médicaux

Assurez l'authenticité des ordonnances, résultats d'analyses et rapports médicaux pour une traçabilité complète.

Processus de Certification

1

Upload du Document

Téléchargez votre document PDF via l'API. Le système vérifie automatiquement le format et la validité du fichier.

2

Génération du Hash

Un hash SHA-256 unique est généré à partir du contenu du document original pour garantir l'intégrité.

3

Création du QR Code

Un QR code personnalisable est généré avec vos données personnalisées (références, IDs, etc.) et l'URL de vérification.

4

Insertion dans le PDF

Le QR code est inséré dans le document PDF à la position spécifiée (par défaut en bas de la dernière page).

5

Document Certifié

Vous recevez le document certifié avec toutes les métadonnées nécessaires pour la vérification future.

Sécurité & Intégrité

Hash SHA-256

Chaque document est identifié par un hash cryptographique unique SHA-256, garantissant une détection immédiate de toute modification.

Authentification Basic

Les endpoints de certification sont protégés par authentification HTTP Basic pour sécuriser l'accès à vos documents.

Vérification Publique

Les documents peuvent être vérifiés publiquement sans authentification, facilitant la validation par des tiers.

Stockage Sécurisé

Les fichiers originaux et certifiés sont stockés de manière sécurisée avec une structure organisée par utilisateur.

Traçabilité Complète

Chaque document conserve un historique complet avec timestamps, métadonnées et statut de certification.

Soft Delete

Suppression logique des documents pour préserver l'intégrité des données et permettre la récupération si nécessaire.

Pourquoi Nous Choisir ?

100%

Sécurisé

Détection garantie de toute altération

<5s

Rapide

Certification en quelques secondes

SHA-256

Cryptographique

Algorithme de hachage robuste

24/7

Disponible

API accessible à tout moment

Flux de Certification

1. Upload

Document PDF

2. Hash

Génération SHA-256

3. QR Code

Génération & Insertion

4. Certifié

Document prêt

Avant vs Après Certification

Sans Certification

  • Pas de vérification d'authenticité
  • Risque de falsification
  • Pas de traçabilité
  • Vérification manuelle longue

Avec Certification

  • Vérification instantanée via QR code
  • Détection automatique d'altération
  • Traçabilité complète avec timestamps
  • Validation en quelques secondes

Avantages

Rapidité

Certification automatique en quelques secondes. Processus entièrement automatisé sans intervention manuelle.

Fiabilité

Détection immédiate de toute altération grâce aux algorithmes cryptographiques SHA-256.

Personnalisation

QR codes personnalisables avec vos propres valeurs (références, IDs transaction, etc.) pour une intégration facile.

Accessibilité

Vérification publique sans authentification. Scannez le QR code avec n'importe quel smartphone pour valider instantanément.

Scalabilité

Architecture robuste basée sur NestJS et TypeORM, capable de gérer des volumes importants de documents.

Documentation

Documentation Swagger complète et interactive pour une intégration rapide et facile dans vos applications.

Démarrage Rapide

1. Authentification

Configurez vos identifiants d'authentification Basic HTTP pour accéder aux endpoints sécurisés.

2. Préparer votre Document

Assurez-vous que votre document est au format PDF et prêt à être certifié.

3. Intégration

Utilisez la documentation Swagger interactive pour tester les endpoints et générer le code d'intégration pour votre langage préféré.

4. Vérification

Scannez le QR code sur votre document certifié pour vérifier son authenticité et son intégrité en temps réel.

Exemples d'Intégration

JavaScript / TypeScript

const formData = new FormData();
formData.append('file', pdfFile);
formData.append('qrCodeCustomValue', 'REF-12345');

const response = await fetch('/api/certify/v1/certify/upload', {
  method: 'POST',
  headers: {
    'Authorization': 'Basic ' + btoa('username:password')
  },
  body: formData
});

const result = await response.json();

Python

import requests

files = {'file': open('document.pdf', 'rb')}
data = {'qrCodeCustomValue': 'REF-12345'}
headers = {
    'Authorization': 'Basic ' + 
    base64.b64encode('username:password'.encode()).decode()
}

response = requests.post(
    '/api/certify/v1/certify/upload',
    files=files,
    data=data,
    headers=headers
)

result = response.json()

PHP

$ch = curl_init();
$file = new CURLFile('document.pdf', 'application/pdf');
$data = [
    'file' => $file,
    'qrCodeCustomValue' => 'REF-12345'
];

curl_setopt_array($ch, [
    CURLOPT_URL => '/api/certify/v1/certify/upload',
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $data,
    CURLOPT_HTTPHEADER => [
        'Authorization: Basic ' . 
        base64_encode('username:password')
    ],
    CURLOPT_RETURNTRANSFER => true
]);

$result = json_decode(curl_exec($ch));

cURL

curl -X POST \
  -H "Authorization: Basic base64(username:password)" \
  -F "file=@document.pdf" \
  -F "qrCodeCustomValue=REF-12345" \
  /api/certify/v1/certify/upload

Questions Fréquentes

Quels formats de fichiers sont supportés ?

Actuellement, seuls les fichiers PDF sont supportés. Le système vérifie automatiquement le format et rejette les fichiers non conformes.

Comment fonctionne la vérification d'intégrité ?

Chaque document reçoit un hash SHA-256 unique calculé à partir de son contenu. Toute modification, même minime, change ce hash, permettant une détection immédiate d'altération.

Puis-je personnaliser la position du QR code ?

Oui, vous pouvez spécifier les coordonnées X et Y pour positionner le QR code précisément dans votre document. Par défaut, il est placé en bas de la dernière page.

La vérification nécessite-t-elle une authentification ?

Non, la vérification des documents est publique et ne nécessite aucune authentification. Cela permet à n'importe qui de vérifier l'authenticité d'un document en scannant son QR code.

Que contient le QR code ?

Le QR code contient vos données personnalisées (comme une référence transaction) ainsi que l'URL de vérification permettant d'accéder aux informations de certification du document.

Que se passe-t-il si je supprime un document ?

Les documents sont supprimés de manière logique (soft delete), ce qui signifie qu'ils restent dans la base de données mais ne sont plus accessibles. Cela préserve l'intégrité des données et permet la récupération si nécessaire.

Compatibilité & Spécifications

Format Supporté

PDF uniquement
Toutes versions PDF

Base de Données

PostgreSQL
SQLite (développement)

Vérification

Compatible avec tous les
lecteurs QR code mobiles

API REST

Compatible avec tous les
langages de programmation

Sécurité

HTTPS recommandé
Authentification Basic HTTP

Limites

Aucune limite de taille
de document imposée

Architecture & Technologies

Stack Technologique

  • Framework : NestJS avec TypeScript
  • Base de données : PostgreSQL/SQLite avec TypeORM
  • Traitement PDF : pdf-lib pour manipulation
  • QR Code : qrcode pour génération
  • Hash : SHA-256 pour vérification d'intégrité
  • Documentation : Swagger/OpenAPI
Sécurité
SHA-256
Performance
Rapide
API
REST
Statut
Production
Disponibilité
24/7

Support & Documentation

Documentation Swagger

Documentation interactive complète avec tests d'endpoints en direct

Accéder

Exemples de Code

Snippets de code prêts à l'emploi pour différents langages de programmation

Voir les exemples

FAQ

Réponses aux questions les plus fréquentes sur l'utilisation de l'API

Consulter la FAQ

Assistant Certify

Bonjour ! 👋 Comment puis-je vous aider ?
💡 Comment fonctionne la certification ?
📄 Quels formats sont supportés ?
✅ Comment vérifier un document ?