Certifier et vérifier des documents par API

Authentification

Chaque requête doit porter une clé API valide dans l'en-tête X-Api-Key. Il n'y a ni OAuth ni jeton à renouveler : la clé est un secret statique, à traiter comme un mot de passe.

• Compte certificateur — une fois votre compte validé, générez votre clé depuis Mon compte → Clé API.
• Application tierce — l'équipe Lumiere peut émettre une clé dédiée depuis le tableau de bord d'administration.

X-Api-Key: votre_cle_secrete

Démarrage rapide

# 1. Certifier le diplôme au moment de sa délivrance
curl -X POST https://lumiere.bj/api/v1/documents/sign \
  -H "X-Api-Key: votre_cle_secrete" \
  -F "file=@diplome_koffi_2026.pdf" \
  -F "delivre_a=Koffi Adjovi" \
  -F "type_document=Diplôme de Licence"

# 2. Plus tard, n'importe qui vérifie avec le hash reçu — sans clé API
curl https://lumiere.bj/api/v1/documents/verify/2f7de70655779b5bedabdee7bf485be72c51f253bec56052c3be542a381259f

// 1. Certifier le diplôme au moment de sa délivrance
import { readFile } from "fs/promises";

const form = new FormData();
form.append("file", new Blob([await readFile("diplome_koffi_2026.pdf")]));
form.append("delivre_a", "Koffi Adjovi");
form.append("type_document", "Diplôme de Licence");

const signRes = await fetch("https://lumiere.bj/api/v1/documents/sign", {
  method: "POST",
  headers: { "X-Api-Key": "votre_cle_secrete" },
  body: form,
});
const { hash } = await signRes.json();

// 2. Plus tard, n'importe qui vérifie avec le hash reçu — sans clé API
const verifyRes = await fetch(`https://lumiere.bj/api/v1/documents/verify/${hash}`);
console.log(await verifyRes.json());

// 1. Certifier le diplôme au moment de sa délivrance
$ch = curl_init('https://lumiere.bj/api/v1/documents/sign');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['X-Api-Key: votre_cle_secrete'],
    CURLOPT_POSTFIELDS => [
        'file' => new CURLFile('diplome_koffi_2026.pdf'),
        'delivre_a' => 'Koffi Adjovi',
        'type_document' => 'Diplôme de Licence',
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);
$hash = $data['hash'];

// 2. Plus tard, n'importe qui vérifie avec le hash reçu — sans clé API
$verify = json_decode(file_get_contents("https://lumiere.bj/api/v1/documents/verify/{$hash}"), true);

import requests

# 1. Certifier le diplôme au moment de sa délivrance
with open("diplome_koffi_2026.pdf", "rb") as f:
    res = requests.post(
        "https://lumiere.bj/api/v1/documents/sign",
        headers={"X-Api-Key": "votre_cle_secrete"},
        files={"file": f},
        data={"delivre_a": "Koffi Adjovi", "type_document": "Diplôme de Licence"},
    )
hash_ = res.json()["hash"]

# 2. Plus tard, n'importe qui vérifie avec le hash reçu — sans clé API
verify = requests.get(f"https://lumiere.bj/api/v1/documents/verify/{hash_}").json()

Exemples complets à exécuter

Un script autonome par langage — copiez-le tel quel dans un fichier, remplacez la clé API et le chemin du document, et lancez-le. Chacun certifie un fichier puis vérifie immédiatement son empreinte.

certifier.sh — bash certifier.sh fichier.pdf "Nom du bénéficiaire"
#!/bin/bash
API_KEY="votre_cle_secrete"
FICHIER="$1"
BENEFICIAIRE="$2"

REPONSE=$(curl -s -X POST https://lumiere.bj/api/v1/documents/sign \
  -H "X-Api-Key: $API_KEY" \
  -F "file=@$FICHIER" \
  -F "delivre_a=$BENEFICIAIRE")

echo "Certifié : $REPONSE"

HASH=$(echo "$REPONSE" | grep -o '"hash":"[a-f0-9]*"' | cut -d'"' -f4)

echo "Vérification :"
curl -s https://lumiere.bj/api/v1/documents/verify/$HASH

exemple-lumiere.js — node exemple-lumiere.js fichier.pdf "Nom du bénéficiaire" (Node 18+)
const fs = require("fs");

const API_KEY = "votre_cle_secrete";
const [, , fichier, beneficiaire] = process.argv;

async function main() {
  const form = new FormData();
  form.append("file", new Blob([fs.readFileSync(fichier)]));
  form.append("delivre_a", beneficiaire);

  const signRes = await fetch("https://lumiere.bj/api/v1/documents/sign", {
    method: "POST",
    headers: { "X-Api-Key": API_KEY },
    body: form,
  });
  const signData = await signRes.json();
  console.log("Certifié :", signData);

  const verifyRes = await fetch(`https://lumiere.bj/api/v1/documents/verify/${signData.hash}`);
  console.log("Vérifié :", await verifyRes.json());
}

main().catch(console.error);

exemple-lumiere.php — php exemple-lumiere.php fichier.pdf "Nom du bénéficiaire" (extension curl requise)
<?php
$apiKey = 'votre_cle_secrete';
[$script, $fichier, $beneficiaire] = $argv;

function lumiereRequest(string $url, array $options = []): array
{
    $ch = curl_init($url);
    curl_setopt_array($ch, $options + [CURLOPT_RETURNTRANSFER => true]);
    $response = curl_exec($ch);
    curl_close($ch);
    return json_decode($response, true);
}

$sign = lumiereRequest('https://lumiere.bj/api/v1/documents/sign', [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ["X-Api-Key: $apiKey"],
    CURLOPT_POSTFIELDS => [
        'file' => new CURLFile($fichier),
        'delivre_a' => $beneficiaire,
    ],
]);
echo "Certifié : " . json_encode($sign) . PHP_EOL;

$verify = lumiereRequest("https://lumiere.bj/api/v1/documents/verify/{$sign['hash']}");
echo "Vérifié : " . json_encode($verify) . PHP_EOL;

exemple_lumiere.py — python exemple_lumiere.py fichier.pdf "Nom du bénéficiaire" (pip install requests)
import sys
import requests

API_KEY = "votre_cle_secrete"
fichier, beneficiaire = sys.argv[1], sys.argv[2]

with open(fichier, "rb") as f:
    sign = requests.post(
        "https://lumiere.bj/api/v1/documents/sign",
        headers={"X-Api-Key": API_KEY},
        files={"file": f},
        data={"delivre_a": beneficiaire},
    ).json()
print("Certifié :", sign)

verify = requests.get(f"https://lumiere.bj/api/v1/documents/verify/{sign['hash']}").json()
print("Vérifié :", verify)

Ancre un document sur la blockchain Lumiere. Envoyez le fichier tel quel — Lumiere calcule lui-même l'empreinte SHA-256. L'appel est idempotent : renvoyer un fichier déjà certifié renvoie la certification existante (200) plutôt que d'en créer une seconde.

{
  "success": true,
  "hash": "2f7de70655779b5bedabdee7bf485be72c51f253bec56052c3be542a381259f",
  "blockchain_status": "confirmed",
  "document": { "…" },
  "remplace": null,
  "conseil": "Conservez cette empreinte pour un futur remplacement."
}