➜︎ Retour - Menu API & Make

Clé et adresse de l'API

Cette page décrit la vue "Clé et adresse de l'API" de la fenêtre "API & Make", accessible via le menu
Réglages → API & Make.

C'est ici que vous retrouvez la clé qui identifie votre application Melkal auprès de l'API, et que vous activez ou coupez l'API et les webhooks.

Réglage Melkal	Explications
Clé API	La clé que les services extérieurs (Make, vos applications...) doivent envoyer pour être reconnus par l'API. Elle se lit, mais ne se tape pas : seul le bouton ci-dessous la change.
Régénérer la clé API	Crée une nouvelle clé, après confirmation. À n'utiliser qu'à titre exceptionnel, par exemple si la clé a été compromise ou si vous ne l'avez pas changée depuis longtemps. Il n'y a pas de retour en arrière possible : il faut ensuite communiquer la nouvelle clé à tous les services qui utilisent l'ancienne, et contacter l'assistance Melkal, qui fait une validation manuelle sur le serveur par sécurité.
API activée	Oui : l'API répond aux services qui présentent la bonne clé. Non : elle ne répond plus à personne.
Webhooks activés	L'interrupteur général des webhooks automatiques : sur Non, Melkal n'envoie plus aucun de ses webhooks et mailhooks automatiques, même si leurs adresses sont renseignées. Le détail se règle dans la liste des webhooks.
Adresse API	L'adresse à laquelle les services extérieurs envoient leurs requêtes. Elle est propre à votre application Melkal et ne se modifie pas : copiez-la telle quelle dans le service qui en a besoin.

Pour utiliser l'API, un service envoie donc ses requêtes à l'adresse ci-dessus, en y joignant la clé API.