Passer au contenu principal
GET
/
endpoint
Initialiser une session
curl --request GET \
  --url https://api.example.com/endpoint
Avant d’utiliser toute autre méthode de l’API dans la Product Recommendation API, appelez l’API init. Le processus d’initialisation accepte l’identifiant de l’utilisateur actuel et demande les paramètres du projet ainsi que les préférences de l’utilisateur.

​
Requête HTTP

GET https://api.products.kameleoon.com/init

​
Quand initialiser

Selon votre plateforme, les exigences d’exécution de init diffèrent :
  • cURL : initialisez à chaque rendu de la page.
  • Web : initialisez à chaque ouverture de la page (y compris les applications monopage).
  • iOS ou Android : initialisez à chaque lancement de l’application.
Lors du premier lancement sur un nouvel appareil, un identifiant d’appareil est absent. Appelez la méthode init sans device ID pour en générer un. Pour la logique de recommandation côté backend avec Kameleoon Web Experimentation, appelez cette API et stockez les IDs dans le cookie KameleoonProducts_session_code pour sid et KameleoonProducts_device_id pour did.

​
Paramètres de requête

ParamètreTypeRequisDescription
shop_idStringTrueVotre Store Key. Vous pouvez la trouver dans Recommendations > Settings > Store settings dans l’application Kameleoon. Vous pouvez également contacter votre Customer Success Manager pour obtenir la clé
didStringFalseUn device ID. Si un device ID existe déjà, spécifiez-le ici. Si vous ne spécifiez pas de did, l’API en générera un nouveau dans la base de données Kameleoon. Utilisez cet ID généré comme device ID pour toutes les requêtes futures
sidStringTrue*Un session ID est un identifiant temporaire attribué à l’utilisateur pour la session en cours. Il doit s’agir d’une chaîne unique et sera régénéré à chaque nouvelle session. Pour la requête init initiale, n’incluez pas de sid. Le sid sera généré par Kameleoon et renvoyé dans la réponse de l’API. Si un sid est spécifié dans la requête et qu’il n’existe pas dans le système, une erreur se produira.
Bien que le paramètre sid soit requis, ne l’ajoutez pas lors de la première initialisation, car le système le génère et le renvoie dans la réponse (en tant que seance).Une fois généré, utilisez le sid généré par le système pour les requêtes au sein de la session en cours.