Loading....

Introduction

AIFE assistance permits to realise a number of tests and calls API to qualification then, production. This assistance must be share with developer community. You can contribute at enrichment of assistance by e-mail.

Prerequisites

These are prerequisites to make call API in qualification space :

Thanks to 4 steps, it's possible to make call API in qualification space.

1st test API with SOAP UI

Step by step testing

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

  • Install SOAPUI
  • Obtain SSL key (P7B and P12 formats)

SOAPUI configuration

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 : $$$TmpAIFE-Chorus-Pro- Exemples_JSON_WADLJSON - 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

Documentation was realised by  Zagvier

Utilisation de CURL pour faire les appels API

P12 formate for certificate utilization is necessary.This is an example of CURL call in "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/

This is an example of call CURL on API with a fill which contained JSON :

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"

With XXXXXXX : 'loginCompteTechnique:MotDePasse' which incoded in base 64, make sure that certification root and intermediary autorities was in your certification's store (server). To extract the files and key of your certificate, you can consult the online documentation by openSSL.  This help was realized with Lionel  PRADOS.

Print Friendly, PDF & Email

Last Update: March 5, 2020  

1682  
Back To Top