Loading....
Print Friendly, PDF & Email

Introduction

Les aides proposées par l'AIFE vous permettront de faire les premiers tests et appels API vers la qualification puis vers la production. Ces aides sont à partager avec la communauté de développeurs API. Vous pouvez contribuer à l'enrichissement de ces aides en nous contactant par e-mail.

Rappel des pré-requis

Voici les pré requis pour pouvoir faire des appels API en qualification :

Ces quatre étapes vous permettent de faire des appels API en qualification.

1er test API avec SOAP UI

Test pas à pas

La plateforme ChorusPro permet de gérer par webservice les factures envoyées aux clients institutionnels. Pour réaliser la connexion, il faut : - une structure identifiée (SIRET de la société maîtresse) qui supervise éventuellement d’autres structures (autres SIRET) - un utilisateur gestionnaire (principal ou secondaire) - un compte utilisateur technique attaché à la structure - activer les droits d’accès à l’API pour cette structure - enregistrer le certificat SSL de cette entité - le certificat SSL : o au format p7b : pour l’enregistrer sur Chorus Pro o au format p12 : pour l’enregistrer dans SOAPUI

  • Installer SOAPUI
  • Disposer de la clé SSL aux formats P7B et p12

Paramétrage de SOAPUI

Dans le menu Files > Preferences … > SSL Settings

Chargement d’une bibliothèque de fonctions REST

Créer un nouveau projet REST en important un fichier WADL Télécharger les fichiers WADL : AIFE-Chorus-Pro-Exemples_JSON_WADL.zip Cette opération constitue une liste de fonction

Interface SOAPUI

Interrogation d'une fonction

Pour interroger une requête, il faut : - Ouvrir la requête (double clic) - Afficher l’inspecteur ‘Auth’ de la requête - Dans la combo ‘Authorization’ - ‘Add a new Authorization’ - Elle sera 'basic' - Renseigner les informations d’authentification du compte technique (communiqué dans le fichier excel de constitution du matelas de données ou lors de la création du compte technique associé au compte du gestionnaire) - Vérifier que le port (5443) du ‘endpoint’ est bien configuré dans le ‘chemin de la requête’ - Renseigner la requête JSON. Copier-coller a. soit de la documentation portail chorus : pour l’exemple de ce document, il suffit de rechercher dans google ‘chorus pro factures consulter fournisseur’ b. soit de la bibliothèques de fichiers JSON donnés en exemples : \\$$$\Tmp\AIFE-Chorus-Pro- Exemples_JSON_WADL\JSON - Adapter le fichier JSON à la situation : j’ai utilisé l’id du premier utilisateur et l’id de la première facture indiqués dans le fichier de trace de création du matelas de données (lignes 9 et 176) - Lancer la requête avec le bouton PLAY - Dans la partie droite de l’écran apparaît la réponse, il peut être nécessaire de sélectionner un mode d’affichage JSON à la place de HTML - Dans la partie gauche, vous pouvez afficher la requête au format brut : - On pourra noter dans l’inspecteur la présence de l’onglet SSL qui indique le certificat utilisé… alors qu’il n’est pas dans le fichier brut

La documentation a été réalisée par Zagvier

Utilisation de CURL pour faire les appels API

L'utilisation du certificat au format P12 est nécessaire. Voici un exemple d'appel CURL sur une API référentiel :

curl --cert cert.crt.pem --key cert.key.pem -H "Content-Type: application/json;charset=UTF-8" -d "{}" -H "Authorization: Basic XXXXXXX" -X POST https://chorus-pro.gouv.fr:5443/service-qualif/transverses/recuperer/pays/

Voici un exemple d'appel CURL sur une API avec un fichier contenant le JSON en entrée :

curl –cert cert.crt.pem –key cert.key.pem -H "Content-Type: application/json;charset=UTF-8" --data @fichier.json -H "Authorization: Basic XXXXXXX" -X POST https://chorus-pro.gouv.fr:5443/service-qualif/factures/rechercher/recipiendaire"

Avec XXXXXXX : 'loginCompteTechnique:MotDePasse' encodé en base 64 Assurez vous que les autorités de certification racine et intermédiaire de votre certificat soient dans votre magasin de certificat (serveur) Pour extraire les fichiers certificat et clé de votre certificat, vous pouvez consulter la documentation en ligne d'openSSL.   Cette aide a été réalisée avec la participation de Lionel PRADOS.

Dernière mise à jour : mai 29, 2019  

2008  
Back To Top