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"
}

A 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:

A 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