Une clé API est un identifiant sur votre compte ImageToTable.ai. Elle permet à un outil externe d'agir en tant que votre compte : l'add-on Google Sheets peut s'y connecter au lieu de se connecter, et l'API v1 l'utilise à chaque appel. Cette page couvre où se trouve la clé, comment la remplacer et quoi mettre à jour une fois que vous l'avez fait.
Où trouver votre clé API
La clé se trouve sur votre page Profil, dans une section intitulée Clé API. Pour y accéder, ouvrez le menu du compte en haut à droite de l'application — celui avec votre avatar et votre nom d'utilisateur — et choisissez Profil.
Cette section affiche tout ce dont la clé a besoin :
- La clé elle-même, masquée par des points par défaut. Utilisez le bouton œil pour la révéler, et le bouton Copier pour la copier.
- Un bouton indiquant Régénérer la clé API lorsqu'une clé existe déjà, ou Générer la clé API lorsqu'il n'y en a pas encore (la section affiche Pas encore de clé API dans ce cas).
- Une courte note indiquant que la clé est destinée aux outils externes, avec un rappel de la garder secrète, ainsi qu'un lien vers la documentation de l'API.
Traitez la clé comme un mot de passe. Elle appartient au compte plutôt qu'à un outil spécifique, donc la même valeur fonctionne partout où une clé est acceptée — et toute personne qui l'a peut agir en tant que votre compte. C'est la raison pour laquelle la section vous demande de la garder secrète.
Régénération de votre clé API
Un compte ne possède qu'une seule clé API. Régénérer remplace cette valeur plutôt que d'ajouter une seconde clé, de sorte qu'il n'y a jamais plus d'une clé active. L'étape de confirmation dépend de la méthode de connexion de votre compte, car un compte créé avec la connexion Google n'a pas de mot de passe que vous pourriez saisir ici.
Si votre compte se connecte avec un mot de passe
Choisir Régénérer la clé API ouvre une invite de mot de passe. Lorsqu'une clé existe déjà, l'invite indique que la clé actuelle sera invalidée avant de demander votre mot de passe ; lorsqu'il n'y a pas encore de clé, elle demande votre mot de passe pour en créer une. Saisissez le mot de passe de votre compte et confirmez pour terminer.
Si le mot de passe ne correspond pas, rien ne change et la page signale que le mot de passe était incorrect.
Si votre compte est lié à la connexion Google
Pour un compte qui se connecte avec Google, la confirmation est une étape de connexion Google au lieu d'un mot de passe. Choisir Régénérer la clé API ouvre une boîte de dialogue intitulée Confirmez votre identité, qui vous demande de confirmer via Google. Si le compte possède déjà une clé, la boîte de dialogue précise que la clé actuelle sera invalidée en premier.
C'est la voie à suivre lorsque l'invite de mot de passe ci-dessus n'est pas une option pour vous, ce qui est le cas des comptes créés via la connexion Google.
Après la régénération : mettez à jour les emplacements qui utilisent la clé
La génération d'une nouvelle clé prend effet immédiatement. L'ancienne valeur cesse de fonctionner à ce moment-là — il n'y a pas de période de grâce ni de moyen de garder les deux clés actives. Tout ce qui envoie encore l'ancienne clé est refusé jusqu'à ce qu'on lui fournisse la nouvelle.
| Où la clé est utilisée | Que faire après la régénération |
|---|---|
| Add-on Google Sheets | Ouvrez la section Compte dans la barre latérale et collez la nouvelle clé dans la zone Coller la clé API. Si l'add-on est connecté avec Se connecter avec Google à la place, il n'utilise pas du tout la clé et ne nécessite aucun changement. |
| API v1 | Remplacez l'ancienne clé par la nouvelle partout où votre application la stocke. Les appels effectués avec l'ancienne clé ne s'authentifient plus, alors mettez à jour la clé avant votre prochaine exécution. |
La régénération ne modifie que la clé. Vos fichiers, modèles, crédits et votre forfait ne sont pas touchés, et la nouvelle clé offre le même accès que l'ancienne.
Questions fréquentes
J'ai perdu ma clé. Puis-je la retrouver ?
Oui, tant que vous pouvez vous connecter. La page Profil affiche toujours la clé actuelle ; elle est masquée par des points jusqu'à ce que vous la révéliez avec le bouton œil, et vous pouvez la copier à partir de là. Si vous préférez la remplacer plutôt que de la réutiliser, utilisez Régénérer la clé API à la place.
Puis-je avoir plus d'une clé à la fois ?
Non. Le compte ne contient qu'une seule clé API. La régénération la remplace, donc l'ancienne valeur cesse de fonctionner dès que la nouvelle est générée.
L'add-on Google Sheets a-t-il toujours besoin d'une clé ?
Non. L'add-on peut se connecter soit en se connectant avec Google, soit en collant une clé API. Si vous le connectez avec la connexion Google, la barre latérale n'utilise pas la clé, et la régénération d'une clé n'affecte pas cette connexion. Seuls les endroits qui utilisent la clé elle-même doivent être mis à jour. Voir Add-on Google Sheets.
L'API v1 utilise-t-elle cette clé ?
Oui. Chaque appel à l'API v1 s'authentifie avec la clé, c'est pourquoi l'ancienne doit être remplacée après la régénération. Accès API explique à qui s'adresse l'API et ce qu'elle exige ; la référence complète se trouve sur le site de documentation développeur.