Ce guide précise les étapes de création d’un compte dans PISTE pour l’utilisation par les plateformes agréées des API du PPF.

 

 

La Plateforme d’Intermédiation des Services pour la Transformation de l’Etat (PISTE) permet d’accéder aux services API (Application Programming Interface) de l’Etat et de la sphère publique.  

En prérequis, vous avez créé un compte utilisateur sur l’environnement de qualification, généré un matelas de données et créé un compte technique (Cf. guide « Créer un compte utilisateur sur le portail de qualification », « Générer un matelas de données » et « Créer un compte technique »).

Point d’attention : A date, le raccordement des PA au PPF s’effectue via le support AIFE via la transmission d’un ticket avec les pièces jointes ci-contre : fiche raccordement et matelas de données.

 

 

La création d’un compte PISTE est nécessaire pour se raccorder au Portail de services. Le portail PISTE est destiné aux développeurs de solution interfacée au Portail de services (éditeurs de solution, concentrateurs, DSI pour les applications internes).

 

 

2.1 Accéder au formulaire de création de compte PISTE

 

Etape 1 : Créer un compte sur PISTE ; veillez à compléter les champs obligatoires suivants :

• Nom
• Email (cette adresse sera votre identifiant)
• Mot de passe
• Confirmer le mot de passe
• Code de l'organisation (par défaut, laissez vide)

Etape 2 : Cochez la case « J’accepte les termes des CGU » et reproduire la suite de caractères puis validez en cliquant sur « S’inscrire ».

 

2.2. Confirmer son courriel

 

Connectez-vous à votre boîte mail et confirmez votre adresse en cliquant sur le bouton « Activer votre compte ».

 

2.3 Consulter son compte PISTE (étape de vérification)

 

Une fois connecté sur PISTE avec votre identifiant et mot de passe, rendez-vous dans le menu Applications (barre supérieure de menus). La liste des applications auxquelles vous avez accès par défaut s’affiche (voir encadré dans l’illustration infra).

 

Vous avez accès à une application « sandbox » (utilisable uniquement en qualification) et dont le nom référence l’adresse courriel de votre compte.

A ce stade, si vous vous rendez en mode connecté sur la liste des applications dans le menu API > Mes API, vous constaterez que l’API Annuaire n’apparait pas.

Il vous faut demander l’accès à cette API à l’AIFE pour, dans un premier temps la faire apparaitre dans la liste, et dans un second temps, pouvoir vous y abonner.

 

 

Après création de votre compte PISTE et de votre mot de passe, il vous faut demander le droit d’accéder à l’API Annuaire en mode connecté.

Cette demande doit s’effectuer par ticket sur le Portail de Services Chorus Pro (et non sur PISTE), ce qui suppose de vous être créé au préalable un compte sur le portail de qualification (voir les modes opératoires « Créer un compte utilisateur sur le portail de qualification » et « Créer un ticket sur le portail de qualification »).

N’utilisez pas le menu « Centre d’Aide » de PISTE pour déposer votre demande.

Mode opératoire :

Etape 1 : Connectez-vous au portail de qualification (https://qualif.chorus-pro.gouv.fr/aife_qual ) avec les identifiants et mots de passe fournis dans le matelas données que vous allez utiliser pour vos tests API.

Etape 2 : Rendez-vous sur le portail de Support (Module Support > Nous contacter > Accéder au portail de Support) 

 

 

Etape 3 : Créez un ticket pour demander l’accès à l’API Annuaire :  

            Catégorie : PPF Annuaire

Sous-catégorie : Raccordement API

Titre : [PISTE-PFF] Accès à l’API Annuaire sur PISTE – nom de votre PA – numéro d’immatriculation

Message : Merci d’attribuer l’accès à l’API Annuaire à l’utilisateur [insérer ici l’adresse email utilisée pour vous identifier dans PISTE, et qui correspond à l’adresse visible dans le nom de votre application « sandbox » créée par défaut sur PISTE] afin qu’il puisse s’abonner à cette API sur PISTE, pour le compte de la PA [insérer ici le nom et le matricule de votre PA]

 

L’AIFE vous habilitera à accéder à l’API demandée dans PISTE et vous confirmera la prise en compte de votre demande en réponse à votre ticket.

Une fois reçue la réponse positive à votre ticket, vous pouvez vous reconnecter sur PISTE (https://piste.gouv.fr/) pour vous y abonner à l’API Annuaire. Cet « abonnement » est un pré-requis à l’utilisation de l’API.

 

 

4.1 Accepter les CGU des API

 

Certaines API nécessitent d’accepter les CGU (conditions générales d’utilisation) avant de pouvoir y souscrire.

Etape 1 : Connectez-vous à votre compte PISTE et cliquez sur « Consentement CGU API »

Etape 2 : Sélectionnez les API pour lesquelles vous acceptez les CGU. Attention, si vous avez omis de demander l’accès à l’API Annuaire à l’étape précédente, cette API ne sera pas sélectionnable.

Etape 3 : Finalisez en cliquant sur « Valider mes choix CGU »

 

 

4.2 Ajouter les accès API à votre application

 

Les différentes API disponibles doivent être ajoutées à votre Sandbox.

 

4.3 Vérification de l’existence d’une application Sandbox sur l’organisation Service-PPF

 

Etape 1 : Cliquez sur « Applications » dans la barre supérieure

Etape 2 : Cliquez sur le nom de votre sandbox dans le tableau « Liste des applications »

 

Notez que vous avez désormais deux applications « sandbox ». Vous devrez utiliser celle qui référence l’organisation « Service PPF » (colonne organisation), qui seule accède à l’API Annuaire :

 

4.4 Abonnement de votre application Sandbox PPF à l’API Annuaire

 

Cliquez sur API, puis mes API dans la barre de menus supérieure :

La liste des API de PISTE s’affiche et l’API Annuaire apparait désormais dans la liste. Cliquez sur le lien « demander l’accès » :

 

Une nouvelle page s’ouvre pour vous permettre de formuler votre demande :

 

Complétez le formulaire :

Champ demandeur : [PPF-Abonnement] nom de votre PA – numéro d’immatriculation

Champ Motif : Raccordement de la PA [nom de votre PA] en qualification + adresse courriel du demandeur et numéro de téléphone en signature.

Application cible : choisir votre application « sandbox » (SBX) dans la liste déroulante.

 

Cliquez sur le bouton « Soumettre » pour envoyer votre demande.

Après validation de votre demande par l’AIFE, vous recevrez sur la boite de messagerie correspondant à votre compte PISTE un message attestant de la prise en compte de votre demande.

 

Votre application sandbox (SBX) est considérée comme abonnée à l’API demandée à compter de la réception de ce message de confirmation.

 

A noter : il sera nécessaire de réitérer ce processus pour votre passage en production, qui reposera sur une autre « application » (à créer), dédiée à la production.

 

4.5 Consulter son application sandbox

 

Pour consulter votre application sandbox, rendez-vous sur « Applications » dans le menu supérieur puis cliquez sur votre nom d’application. Une page s’ouvre sur laquelle vous retrouverez tous les éléments requis pour votre raccordement et vos appels en qualification (identifiants Oauth, API keys).