---
title: "PoolCop et KNX : connecter Pool’nX à PoolCop Cloud avec la clé d’API"
description: "Reliez un PoolCop au bus KNX : générez la clé d’API PoolCop Cloud, enregistrez-la dans Pool’nX et choisissez le PoolCop, ou utilisez le type legacy."
canonical: https://wiki.can-nx.com/guides/pool-poolcop-connect/
language: fr
product: Pool’nX
audience:
  - administrateur
  - installateur
context: "Can’nX Cloud, fenêtre Pool’nX : types PoolCop Cloud et PoolCop (legacy), Authentification et piscine"
---

# PoolCop et KNX : connecter Pool’nX à PoolCop Cloud avec la clé d’API

Contexte : Can’nX Cloud, fenêtre Pool’nX : types PoolCop Cloud et PoolCop (legacy), Authentification et piscine

Pool’nX relève l’état d’un PoolCop et lui transmet les commandes reçues du bus KNX, par l’intermédiaire de PoolCop Cloud et d’une clé d’API du compte PoolCop. Choisissez le type PoolCop Cloud, enregistrez la clé, puis désignez le PoolCop.

Destiné à l’installateur ou à l’administrateur qui relie un PoolCop à une installation KNX. Pour un contrôleur Klereo, suivez [la connexion à Klereo Connect](https://wiki.can-nx.com/guides/pool-klereo-connect/).

## Avant de commencer

- La fenêtre **Pool'nX** de la passerelle est ouverte : voir [ouvrir Pool’nX dans Can’nX Cloud](https://wiki.can-nx.com/guides/pool-access/).
- Vous avez accès au compte PoolCop de la piscine pour générer une clé d’API sur my.poolcop.com/profile.
- Changer de type de piscine efface toute la configuration enregistrée : identifiants, adresses KNX, options et régulation. Si la Pool’nX est déjà configurée pour un autre type, relevez d’abord ses adresses.

## Choisir le type PoolCop Cloud

1. Dans **Type de piscine**, choisissez **PoolCop Cloud**.
2. La fenêtre **Confirmation** affiche **Voulez-vous vraiment modifier le type de piscine** et **Toutes vos données sauvegardées seront supprimées**. Cliquez sur **Confirmer**.
3. Attendez que la fenêtre se recharge avec le type **PoolCop Cloud**.

**Annuler** remet le type précédent sans rien modifier.

Le type **PoolCop (legacy)** utilise une clé d’API Poolcopilot à la place d’une clé PoolCop Cloud. Choisissez-le seulement si vous disposez d’une telle clé ; il n’a pas de liste **Piscine selectionnée**.

## Enregistrer la clé d’API

1. Générez une clé d’API sur la page de profil de votre compte, my.poolcop.com/profile. Avec le type **PoolCop Cloud**, l’icône d’aide à côté de **Clé d'API** ouvre cette page.
2. Dans la fenêtre **Pool'nX**, en face de **Authentification**, cliquez sur le bouton à l’icône de connexion. La fenêtre **Modifier les identifiants** s’ouvre.
3. Collez la clé dans **Clé d'API**.
4. Cliquez sur **Enregistrer**. **Opération réussie !** confirme l’enregistrement et la fenêtre se ferme.

Une clé enregistrée n’est jamais réaffichée : **Une clé d'API est déjà enregistrée. Saisissez une nouvelle clé pour la remplacer.** Pour changer de clé, collez la nouvelle et enregistrez.

## Choisir le PoolCop

1. De retour dans la fenêtre **Pool'nX**, ouvrez la liste **Piscine selectionnée**. Chaque entrée indique le nom de la piscine, puis celui du PoolCop, séparés par un chevron.
2. Choisissez le PoolCop. Le choix est enregistré aussitôt, sans autre bouton.

La liste reste vide tant qu’aucune clé n’est enregistrée. Can’nX Cloud la garde en mémoire cinq minutes : un PoolCop ajouté entre-temps au compte peut tarder à apparaître. Une nouvelle clé ou un changement de type la recharge.

## Vérifier le résultat

1. Ouvrez **Statuts de la piscine** avec son bouton à double flèche.
2. Vérifiez que **Valeurs en direct** est suivi d’un rond vert, que la colonne **Valeur** se remplit et que **Dernière actualisation:** indique une date récente.
3. Relevez les unités affichées dans **Valeur** : ce sont celles du compte PoolCop, par exemple °C ou °F, bar, kPa ou psi.

Associez ensuite les adresses KNX : [statuts](https://wiki.can-nx.com/guides/pool-knx-status/), puis valeurs propres à PoolCop dans [le tableau des statuts et commandes PoolCop](https://wiki.can-nx.com/guides/pool-poolcop-knx/).

## En cas de problème

| Symptôme | Cause et action |
| --- | --- |
| **Clé d'API PoolCop invalide ou expirée — vérifiez-la dans Authentification** | PoolCop Cloud refuse la clé enregistrée. Générez une nouvelle clé sur my.poolcop.com/profile et enregistrez-la dans **Authentification**. |
| **Une erreur est survenue** à l’ouverture de la fenêtre | PoolCop Cloud n’a pas répondu. Patientez quelques secondes, puis rouvrez la fenêtre. |
| Liste **Piscine selectionnée** vide | Aucune clé n’est enregistrée, ou le compte ne contient aucun PoolCop. Vérifiez le compte sur my.poolcop.com. |
| **Valeurs en direct** suivi de **Désactivé(e)** | Aucune donnée n’a encore été reçue de la Pool’nX. Vérifiez qu’un PoolCop est choisi et que la passerelle est **En ligne** sur sa fiche, puis rouvrez la table. |

Si le problème persiste, consultez [le dépannage Pool’nX](https://wiki.can-nx.com/guides/pool-help/) ou écrivez à support@can-nx.com avec le nom de la passerelle, le type de piscine et le message affiché. Ne transmettez jamais la clé d’API.

Interface en anglais : **Type of pool**, **Do you really want to change the pool type?**, **Confirm**, **Authentification**, **Modify the login details**, **Please enter your Poolcop API token**, **Save**, **An API key is already saved. Enter a new key to replace it.**, **Selected pool**, **Invalid or expired PoolCop API key — check it under Authentication**.