Annonce de la nouvelle version de la bibliothèque cliente Mindee Ruby

La bibliothèque client Mindee Ruby continue d'évoluer, et notre dernière version, la version 4, est là pour simplifier votre expérience d'intégration tout en améliorant la stabilité et les fonctionnalités !

La bibliothèque client Ruby agit comme un désérialiseur complet, convertissant les réponses de l'API en formats faciles à gérer pour vos applications Ruby, ainsi qu'un ensemble d'outils pour faciliter l'analyse des documents.

Grâce à cet outil, vous gérerez des données bien structurées prêtes à être utilisées immédiatement. Vous pourrez ainsi vous concentrer sur la création de votre application plutôt que sur la gestion des types.

Quelles sont les nouveautés de la version 4 ?

Fonctionnalités de compatibilité et de développement améliorées

• Support pour Ruby 3.4 : Nous avons étendu notre compatibilité pour inclure Ruby 3.4, afin que vos projets puissent bénéficier des dernières améliorations linguistiques.
• Dactylographie complète avec RBS : Notre intégration de la prise en charge complète de la saisie via RBS améliore la fiabilité du code et permet de détecter rapidement les problèmes potentiels.
• Corrections de bugs : Plusieurs bogues, tels que la gestion imprécise des erreurs de serveur ou des mécanismes de sauvegarde peu intuitifs, ont été corrigés afin d'améliorer la stabilité globale. Vous pouvez donc être sûr que le SDK fonctionne de manière cohérente dans vos environnements de production.

Intégration simplifiée des API

• Syntaxe unifiée pour toutes les API : Les méthodes parse () et enqueue_and_parse () précédentes ont été consolidées en une seule méthode parse () plus intuitive. Cette modification rationalise la façon dont vous interagissez avec nos API, réduisant ainsi la courbe d'apprentissage et simplifiant l'intégration.
• Classe d'API personnalisée universelle : Nous proposons désormais une classe universelle indépendante du produit qui remplace les anciennes classes CustomV1 et GeneratedV1, simplifiant ainsi plus que jamais les interactions personnalisées avec les API.

Expérience améliorée pour les développeurs

• Journalisation améliorée : Une journalisation détaillée a été ajoutée à l'ensemble de la bibliothèque, ainsi que la possibilité d'utiliser votre propre outil de journalisation personnalisé. Cela fournit une meilleure visibilité des opérations, ce qui facilite le traçage et le débogage des problèmes.
• Gestion des erreurs améliorée : Nous avons remanié la gestion des erreurs et introduit des erreurs personnalisées pour simplifier le dépannage.
• Extraction de données avancée : Pour les API prises en charge, vous pouvez désormais extraire full_text_ocr au niveau de la page, élargissant ainsi la gamme de données que vous pouvez exploiter à partir de vos documents.
• Compression d'image : Si vous avez affaire à des fichiers lourds, nous avons ajouté un outil qui vous permet de compresser la taille de vos images sans avoir à implémenter le code vous-même ou à ajouter des dépendances externes.

Exemple de démarrage rapide

Si vous n'en êtes qu'à vos débuts avec la bibliothèque cliente Ruby, consultez notre introduction et pour commencer guides.

Pour vous donner une idée immédiate de la nouvelle version, voici un extrait rapide qui extrait l'adresse de facturation de la deuxième page d'une facture à l'aide de notre API des documents financiers :

require 'mindee'

# Initialize a new client
mindee_client = Mindee::Client.new(api_key: 'my-api-key') # Replace with your own API key!

# Load a file from disk
input_source = mindee_client.source_from_path('/path/to/my/invoice.pdf') # Replace with your document path

# Parse the file
result = mindee_client.parse(
  input_source,
  Mindee::Product::FinancialDocument::FinancialDocumentV1
)

# Print the billing address from page 2
puts result.document.inference.pages[1].prediction.billing_address

Guide de migration de la v3 vers la v4

Pour ceux qui effectuent une mise à niveau depuis la version 3, le principal changement est la dépréciation du enqueue_and_parse () méthode. Dans la version 4, analyser () La méthode gère désormais à la fois les appels d'API synchrones et les sondages en une seule fois.

Par exemple, si vous avez déjà écrit :

result = mindee_client.enqueue_and_parse(
  input_source,
  Mindee::Product::InternationalId::InternationalIdV2
)

Maintenant, il vous suffit de le mettre à jour pour :

result = mindee_client.parse(
  input_source,
  Mindee::Product::InternationalId::InternationalIdV2
)

Si vous souhaitez mettre en œuvre des stratégies de sondage personnalisées ou utiliser des webhooks, file d'attente (1) et parse_queued () les méthodes sont toujours disponibles.

Grâce à ces améliorations, la version 4.0 du SDK Mindee Ruby devrait offrir une expérience d'intégration encore plus fluide et plus robuste.

Nous vous invitons à télécharger la nouvelle version et à découvrir les fonctionnalités améliorées par vous-même !