Intégrations

Certains services nécessitent un compte à part : un forfait météo ou cartographique, un prestataire de paiement ou un fournisseur d’IA auquel tu es déjà abonné. Ces services te fournissent une clé, une longue chaîne secrète qui indique que les requêtes viennent de toi. Yorki conserve ces clés pour ton application dans Paramètres, Intégrations.

Pour l’IA, tu n’as pas besoin de clé : Yorki s’en charge pour toi. Consulte L’IA dans ton application.

À quoi sert une clé

Une clé permet au code serveur de ton application d’appeler un service avec ton compte. Le service te facture selon l’utilisation de ton application, dans le cadre de ton propre forfait auprès de ce service. Yorki ne te facture jamais ces frais et ne voit jamais la facture.

Une clé est stockée sous forme chiffrée. Une fois enregistrée, elle ne s’affiche plus, ni pour toi ni pour l’IA de Yorki, et seul le code serveur de ton application peut la lire. Elle ne parvient jamais aux navigateurs de tes visiteurs.

Demande d’abord la fonctionnalité

Tu n’as pas besoin de savoir quelle clé est nécessaire à une fonctionnalité. Demande-la, par exemple : « Ajoute une page qui affiche la météo du jour à Stockholm avec OpenWeather ». Yorki crée toute la fonctionnalité et t’indique, dans sa réponse et sur la page elle-même, quelle clé ajouter, par exemple :

Ajoute OPENWEATHER_API_KEY dans Paramètres → Intégrations pour afficher les prévisions.

Ne colle jamais de clé dans la discussion. Yorki n’en a pas besoin ici et te demandera plutôt de l’ajouter dans Paramètres.

Ajouter une clé

1. Récupère la clé auprès du service, généralement dans son tableau de bord, sous Clés API.
2. Dans Yorki, ouvre Paramètres, puis Intégrations.
3. Saisis sous Nom le nom indiqué par Yorki, par exemple OPENWEATHER_API_KEY. Les noms utilisent des lettres majuscules, des chiffres et des traits de soulignement.
4. Colle la clé sous Valeur, puis clique sur Ajouter une clé.

Si ton aperçu est ouvert, la fonctionnalité se met à fonctionner au prochain chargement de la page. Tu n’as pas besoin de reconstruire l’application.

Remplacer ou supprimer une clé

Remplacer enregistre une nouvelle valeur sous le même nom, par exemple lorsque tu renouveles une clé auprès du service. Supprimer efface la clé. Les fonctionnalités qui l’utilisent affichent de nouveau leur message « ajoute la clé » jusqu’à ce que tu l’ajoutes à nouveau.

Pour empêcher une clé de fonctionner partout, révoque-la également dans le tableau de bord du service.

Applications publiées

Lorsque tu publies ton application, son code serveur est lui aussi mis en ligne et peut lire tes clés. Si tu ajoutes, remplaces ou supprimes une clé par la suite, la modification est prise en compte dans l’application publiée en moins d’une minute, sans avoir à la publier de nouveau.

La clé IA

Chaque application possède également une clé nommée YORKI_AI_KEY dans cette liste, indiquée comme Géré par Yorki. Yorki la crée pour que ton application puisse utiliser l’IA. Tu ne peux pas la remplacer ni la supprimer ici. Pour la remplacer, ouvre Paramètres, puis IA, et clique sur Régénérer.