opacte — SDK Python de l'API Opacte

Attestez et vérifiez des documents depuis votre logiciel, sans captcha ni code. Comme sur opacte.eu, le document n'est jamais conservé : Opacte n'en garde que les empreintes, et la preuve est ancrée dans Bitcoin.

Installation

pip install opacte

Python 3.10 ou plus. Créez un compte sur opacte.eu, puis une clé API dans Réglages, et rendez-la disponible dans la variable d'environnement OPACTE_API_KEY (jamais dans votre code).

Exemple

from opacte import Client, CreditsInsuffisants

client = Client()  # clé lue dans OPACTE_API_KEY
print(client.compte().solde)

# Attester un fichier : 1 crédit. Envoyé en flux, lu à la volée, jamais conservé.
attestation = client.attestations.creer("facture-2026-118.pdf", email_visible=False)
print(attestation.id_attestation, attestation.url_recu)  # gardez url_recu : accès pérenne au reçu

# Vérifier un document reçu : ses empreintes sont calculées ici, le fichier ne part pas. Gratuit.
for candidate in client.verifier("document-recu.pdf"):
    print(candidate["id_attestation"], candidate["horodatage"])

Ce que fait le SDK

• Fichiers en flux : un fichier est envoyé par blocs, jamais chargé en entier en mémoire.
• Nouvelles tentatives : sur coupure, 429 ou 5xx, l'appel est rejoué avec la même Idempotency-Key : jamais de second débit.
• Erreurs typées : CleInvalide, CreditsInsuffisants (avec solde), TropDeDemandes, Introuvable…
• Typé : annotations complètes, vérifiables par votre éditeur ou mypy.

Liens

• Documentation et référence : opacte.eu/api
• Tutoriel : opacte.eu/api-tutorial
• Contrat HTTP publié (OpenAPI) : opacte.eu/api/openapi.json — le SDK n'en est qu'une mise en forme : vous pouvez vérifier ce qu'il envoie.

La signature électronique par l'API, avec le document chiffré chez vous, arrive dans une prochaine version.

Licence MIT.