Guide de migration de l’API REST d’image

Emburse Enterprise interrompra les anciennes API d’image de dépenses et de factures basées sur SOAP. Ce guide de transition aidera les clients à migrer vers la nouvelle API d’image basée sur REST. Il explique les modifications concernant l’authentification, répertorie les points de terminaison mis à jour et fournit des exemples pratiques pour récupérer des fichiers PDF et des fichiers image à l’aide de l’interface moderne de REST.

Pour connaître tous les détails sur la sécurité de l’API REST, consultez la FAQ sur la sécurité de la migration vers l’API REST d’image.

Prérequis

Avant de passer à l’API REST d’image, assurez-vous que les étapes de configuration suivantes ont été effectuées par l’équipe d’assistance d’Emburse et votre organisation.

1. Configuration requise par Emburse

• Activer l’accès à l’API REST : Emburse doit activer le point de terminaison REST pour votre organisation.
• Activer la gestion des clés API : Dans Autorisations d’accès, Emburse doit accorder l’autorisation d’utiliser l’écran Gestion des clés API.

2. Générer des clés API

Si votre organisation n’utilise pas encore d’API REST, un administrateur pourra suivre les étapes ci-dessous pour générer des clés API.

1. Dans le menu Paramètres administrateur, sélectionnez Sécurité > Gestion des clés API.

2. Cliquez sur GÉNÉRER UNE CLÉ API. La clé API générée sera copiée automatiquement dans le presse-papiers. Une fois que vous avez cliqué sur Copiée, la fenêtre se ferme et la clé ne sera plus disponible.

Voir Écran d’administration Gestion des clés API pour plus de détails.

3. API de factures uniquement : Affecter une Personne responsable du filet de sécurité de routage des factures

Les clients qui passent à l’API REST de factures doivent vérifier qu’une Personne responsable du filet de sécurité de routage des factures leur a été affectée. 

Dans le menu Paramètres administrateur, cliquez sur Configuration > Préférences du client > Routage d’approbation.

Si personne n’est affecté à côté de « Personne responsable du filet de sécurité de routage des factures », cliquez sur Modifier et utilisez la liste déroulante pour sélectionner l’utilisateur approprié. Cliquez ensuite sur Enregistrer.

Principales différences en un coup d’œil

Le tableau ci-dessous utilise l’API de factures comme exemple des différences entre l’ancienne API d’image et la nouvelle API REST.

Bonne pratique

Nous recommandons fortement de quitter toutes les API basées sur SOAP car à l’avenir, la feuille de route de la plateforme d’Emburse se concentrera sur les API basées sur REST.

Authentification dans la nouvelle API REST

En-têtes obligatoires

Remplacez les espaces réservés ci-dessous par les identifiants fournis à votre organisation par Emburse Enterprise.

x-api-key : [votre-clé-api]

customerCode : [votre-code-client]

chain-id : [votre-identifiant-de-chaîne]

Content-Type : application/json

Exemple de dépense : Récupération des reçus

Exemple de dépense dans l’ancienne API SOAP

curl --location 'https://api.ca1.chromeriver.com/receipts/doit' \

--form ’un="APIDemo"’ \

--form ’pw="xxxxx"’ \

--form ’method="getReceipts"’ \

--form 'invoiceID="050018911471"'

Exemple de dépense dans la nouvelle API REST

curl --location 'https://service.chromeriver.com/expense-image-api/getReceipts?reportID=050018911471' \

--header ’x-api-key : 1a234b56-7c89-1234-5678-d9e1fghijk23’ \

--header ’customerCode : 0XX0’ \

--header ’chain-id : APIDemo’ \

--header 'Content-Type: application/json'

Options de paramètres de requête de dépense

Exemple de facture : Récupération d’images (PDF)

Exemple de facture dans l’ancienne API SOAP

curl --location 'https://api.ca1.chromeriver.com/receipts/doit' \

--form ’un="APIDemo"’ \

--form ’pw="xxxxx"’ \

--form ’method="getInvoiceImages"’ \

--form 'invoiceID="050018911471"'

Exemple de facture dans la nouvelle API REST

curl --location 'https://service.chromeriver.com/v1/invoice-api/invoices/images/pdf?imageFirst=true&invoiceId=050018911471&getPDFReport=true&getImage=true' \

--header ’x-api-key : 1a234b56-7c89-1234-5678-d9e1fghijk23’ \

--header ’customerCode : 0XX0’ \

--header ’chain-id : APIDemo’ \

--header 'Content-Type: application/json'

Options de paramètres de requête d’image de facture

Mappage des anciennes méthodes vers les points de terminaison REST

Test et validation

Pour tester l’API REST :

• Utilisez des outils tels que Postman, curl ou Insomnia.
• Fournissez tous les en-têtes requis, en particulier x-api-key et customerCode.
• Vérifiez l’accès aux dépenses ou aux factures à l’aide des valeurs reportId ou invoiceId connues.

Si elle est authentifiée correctement, l’API renverra ce qui suit :

• Flux PDF du rapport de dépenses ou de factures
• Images associées (si disponibles)

FAQ sur la sécurité de la migration vers l’API REST d’image

Pourquoi Emburse retire-t-il l’API d’image de dépenses basée sur SOAP ?

L’API SOAP repose sur une infrastructure obsolète, notamment :

• Des serveurs exécutant un système d’exploitation dont la fin de vie est dépassée
• Une base de code liée à l’interface utilisateur Flash désormais obsolète
• Un protocole qui n’est plus aligné sur la stratégie REST-first d’Emburse

Ces limitations entraînent une augmentation des risques en matière de sécurité et de conformité, ce qui nous incite à passer à une solution REST plus moderne et plus sécurisée.

L’API REST est-elle aussi sécurisée que l’API SOAP ?

Oui, les API REST sont aussi sécurisées que les API SOAP.

Comment les données sont-elles protégées pendant leur transit vers REST ?

Toutes les API REST utilisent le protocole HTTPS avec TLS 1.2+ pour une communication sécurisée et chiffrent les données en transit afin d’éviter leur interception ou leur altération.

Comment fonctionne l’authentification dans l’API REST ?

L’API REST utilise des clés API pour l’authentification.

Où les données des clients sont-elles stockées et comment sont-elles protégées ?

Toutes les données des clients sont stockées dans des bases de données chiffrées (AES-256). Nous assurons des sauvegardes géo-redondantes, une reprise après sinistre automatisée et une surveillance en temps réel. L’accès aux données est restreint, consigné et audité régulièrement.

L’API REST est-elle conforme aux réglementations du secteur ?

Oui. Notre conformité respecte les principaux cadres de conformité, notamment :

• Le RGPD (Règlement général sur la protection des données)
• Le SOC 2 Type II
• Le PCI-DSS (pour les données de paiement, le cas échéant)

En outre, des audits de sécurité et des tests de pénétration sont régulièrement menés par des tiers.

Comment assurez-vous une protection contre les vulnérabilités courantes ?

• Pratiques sécurisées en matière d’API
• Chiffrement TLS
• Authentification et autorisation
• Journalisation et surveillance
• Injection SQL
• Scripts intersites (XSS)

Comment Emburse protège-t-il mes données pendant la migration ?

Les données continuent d’être protégées selon les mêmes contrôles de niveau professionnel déjà en place :

• Tout le trafic vers l’API REST est sécurisé.
• Aucune modification des protocoles existants en matière de conservation ou de confidentialité des données.
• La migration n’expose ni ne transfère automatiquement les données des clients ; les intégrations doivent être mises à jour et validées manuellement.

Qui puis-je contacter en cas de questions ou de rapports de sécurité ?

Veuillez contacter votre responsable de réussite client d’Emburse Enterprise.

Vous pouvez également consulter la documentation relative à la sécurité et à la conformité dans Emburse Trust Center. 

Documentation de référence

Pour connaître tous les détails sur les points de terminaison, les paramètres d’entrée et la structure de réponse, reportez-vous aux pages officielles de Swagger :

• Documentation de l’API REST de factures
• Documentation de l’API REST d’image de dépense