Nouvelle version : Python SDK V2

Nous avons récemment publié une nouvelle version du SDK Python. Nous travaillons d'arrache-pied pour améliorer l'expérience de nos développeurs et nous avons pris en compte vos commentaires. En voici un bref aperçu :

Qu'est-ce que le SDK Python v2 ?

Si vous connaissez déjà notre SDK Python, vous savez que notre première version (v1) prend en charge les API prêtes à l'emploi pour les factures, les passeports et les reçus, y compris les plaques d'immatriculation européennes. Nous y avons apporté diverses mises à jour et améliorations au fil du temps. Les API de documents personnalisés créées à l'aide du générateur d'API sont désormais prises en charge par le SDK Python V2.

Pourquoi passer à la v2 ?

Tout simplement, parce que l'expérience des développeurs est bien meilleure et qu'elle prend en charge un plus large éventail de documents !

Le processus d'installation est le même que celui de la v1 :

pip install mindee

Pour illustrer brièvement l'utilisation du SDK, voici un exemple des différences d'implémentation entre la v1 et la v2 :

Pour extraire des documents à partir des API standard (facture), vous devez écrire ce qui suit dans v1:

from mindee import Client

mindee_client = Client(invoice_token="your_invoices_api_key_here")

invoice_data = mindee_client.parse_invoice("/path/to/file")

Alors que dans v2

from mindee import Client

mindee_client = Client().config_invoice("my-invoice-api-key")

api_response = mindee_client.
    doc_from_path("/path/to/the/invoice.pdf").parse("invoice")

print(api_response.invoice)

Pour l'API de création de documents personnalisés créée à l'aide du générateur d'API, dans v2 vous pouvez utiliser le code suivant :

# Init a new client and configure your custom document
from mindee import Client
mindee_client = Client().config_custom_doc(
      document_type="pokemon-card",
      singular_name="card",
      plural_name="cards",
      account_name="pikachu",
      api_key="pokemon-card-api-key"
)

# Load a file from disk and parse it
api_response = mindee_client.
    doc_from_path("/path/to/the/card.jpg").parse("pokemon-card")

# Print a brief summary of the parsed data
print(api_response.card)

Pour faciliter la transition de la v1 à la v2, consultez notre documentation pour plus de détails.

Des avantages supplémentaires avec la V2 !

Nous avons publié v2.0.0, v2.0.1 et v2.0.2. Bien que ces versions prennent en charge l'API de documents personnalisés créés à l'aide de l'API Builder, elles comportent également quelques modifications :

v2.0.0

• a maintenant confiance renommé en probabilité dans les champs de retour pour correspondre au retour de l'API
• a maintenant client initialisation retravaillée pour être plus extensible
• le chargement et l'analyse des documents ont maintenant été retravaillés pour séparer les arguments

v2.0.1

• ont amélioré la conversion de la facture en chaîne
• ont amélioré le comptage des pages PDF vides
• dispose d'une version mise à jour de PikePDF
• dispose d'une version mise à jour de Pillow pour plus de sécurité.

v2.0.2

• ont amélioré l'envoi de documents financiers via la CLI
• permet désormais le retour OCR dans la CLI
• s'assure que toutes les informations du document sont imprimées

Nous sommes impatients de voir ce que vous allez créer avec notre nouveau SDK Python amélioré !

Conclusion

Vous voulez essayer la nouvelle version du SDK ? Rendez-vous sur notre Kit de développement logiciel Python section de notre documentation.