L’intégration API complète est l’endroit où vous générez les clés API qui authentifient l’accès programmatique à votre compte Personyze — lecture et écriture des utilisateurs, catalogues, interactions, emplacements et rapports.
Dans le panneau : Paramètres › Intégrations › API complète.
Générer une clé
- Ouvrez Paramètres › Intégrations et cliquez sur Gérer sur la carte API complète.
- Générez une nouvelle clé et copiez-la. Conservez-la immédiatement — il n’existe aucun moyen de récupérer plus tard la valeur d’une clé existante.
- Donnez à chaque intégration sa propre clé, afin de pouvoir en révoquer une sans casser les autres.
La suppression d’une clé prend effet immédiatement : tout ce qui l’utilise encore commence à recevoir 401. Générez la clé de remplacement et déployez-la avant de révoquer l’ancienne.
Les mots de passe Zapier et les clés de l’API complète sont le même ensemble de clés. Une clé générée sur l’une ou l’autre carte apparaît sur les deux, et chacune authentifie n’importe quel endpoint.
Utilisation
L’authentification se fait en HTTP Basic sur HTTPS — nom d’utilisateur api, mot de passe : votre clé :
curl 'https://api:YOUR_API_KEY@app.personyze.com/rest/account'Cet endpoint renvoie {"id": …} et ne modifie rien, ce qui en fait le moyen le plus économique de vérifier qu’une clé fonctionne.
Référence complète
La documentation complète de l’API se trouve dans le wiki développeur :
- Présentation de l’API REST — forme des requêtes, verbes HTTP, codes de réponse, conventions.
- Clés API — envoyer la clé, la tester, les types de clés, et la protéger.
- Paramètres de chemin des requêtes — la syntaxe
where/order_by/limit/columnscommune à tous les objets. - Erreurs, limites et nouvelles tentatives — codes de statut, le plafond de 1 000 lignes, les règles d’indexation, et ce qu’il est sûr de réessayer.
- Construire une intégration — quel endpoint fait quoi, et les comportements qui surprennent.
Les objets
- Utilisateurs — users, users_columns, user_lists, user_list_users, user_interests, do
- Catalogue — products, articles, products_interactions, products_stats
- Analytique — summary_actions, sessions_archive, events, forms
- Configuration — objets placeholders, actions, conditions, containers_grab_variable
Pour la personnalisation côté serveur — demander à Personyze ce qu’un visiteur doit voir et l’afficher vous-même — voir personnalisation côté serveur et tests A/B.
Voir aussi
- Intégration Zapier — la voie sans code vers la même API.