Comment intégrer le “Portail Client” ? (1/2) – Assistance & Documentation

Procédure

1/ Récupérez les informations de votre client

Pour pouvoir afficher le portail dans le contexte de votre client. Il vous suffit de faire l’appel API: Create a customer
Requête :

POST /v1/Customer
{
  "ReferenceCustomer": "123456",
  "Name": "John Doe",
  "Email": "john@doe.com",
  "Language": "en"
}

À noter: pourquoi faire un appel POST alors que le client est déjà déclaré dans le référentiel ProAbono ?
Car ProAbono insère un nouveau client ou met à jour un client existant si la ReferenceCustomer existe déjà.

Si l’utilisateur a changé son login ou son e-mail depuis, ça le met à jour dans ProAbono.
Si l’utilisateur a été supprimé ou n’a pas été déclaré dans ProAbono, il sera ajouté à la volée.

2/ Récupérez le lien reçu depuis le retour de la requête

Si tout s’est bien passé, la réponse à cette requête vous retourne les informations de votre client avec en plus un attribut “Links”.
Réponse :

{
    "Id": 64079,
    "ReferenceCustomer": "123456",
    "ReferenceSegment": "sandbox-eur",  
    "Name": "John Doe",
    "Email": "john@doe.com",
    "Language": "en",
    "Links": [
        {   "rel": "hosted-collection-offers",
            "href": "https://sandbox-eur.proabono.com/offers/{Unique-Encrypted-URL}"
        },
        {   "rel": "hosted-home",
            "href": "https://sandbox-eur.proabono.com/offers/{Unique-Encrypted-URL}"
        }       
    ]
}

Copiez l’URL contenu dans le champ “href” du lien “hosted-home”. Celui-ci vous permettra d’afficher l’accueil du “Portail Client”. (ex: https://sandbox-eur.proabono.com/offers/{Unique-Encrypted-URL})

Ces liens contiennent des URL cryptées et sécurisées, vous permettant d’insérer la page souhaitée dans votre propre site/application :

À noter : le lien “hosted-collection-offers” affiche la grille des offres. Pour en savoir plus, consultez : Comment intégrer ProAbono dans votre process d’inscription ?

3/ Inserez l’IFrame

Insérer le code suivant : <iframe src=”{URL}” style=”width:100%; height:700px;” frameborder=”0″></iframe> dans une page de votre application.

En remplaçant {URL} par le lien copié précédemment (ex: https://sandbox-eur.proabono.com/offers/{Unique-Encrypted-URL}).

Si tout se passe bien, l’IFrame affichera les informations associées au client correspondant.

Pour aller plus loin

Comment intégrer le “Portail Client” ? (2/2)

Zone Développeur