Connecteurs personnalisés

Un connecteur personnalisé est un service que vous décrivez vous-même : n’importe quelle API sur internet qui accepte une clé. Une fois créé, vos applications l’utilisent comme n’importe quel connecteur de la liste, par l’intermédiaire de Setherion, avec la clé gardée sur nos serveurs.

Appuyez sur + en haut à droite de la page Connectors, puis sur Custom connector, et remplissez :

• Details. Un Display name, une Short description pour la liste, une Description plus longue, une Category et une adresse de documentation facultative.
• Authentication. La façon dont la clé voyage : un Bearer token, une API key in a header (vous donnez le nom de l’en-tête), une API key in the address (vous donnez le nom du paramètre) ou un Username and password. Vous pouvez aussi indiquer ce qu’on demande aux gens, par exemple « Password ». What requests to this API will look like le montre au fil de vos choix. Ensuite, l’API base URL, par où commence chaque requête, et une Test request : un appel simple qui échoue sans clé valide, comme un appel qui renvoie le compte courant.
• Who may use it. Only your app's team (par défaut), Visitors can read ou Anybody, puis les types de requêtes que les applications peuvent envoyer : GET lit, les autres modifient. Avec Visitors can read, quiconque ouvre l’application peut lire et seule l’équipe modifie. Avec Anybody, tout le monde peut faire chaque appel que vous avez autorisé, et les appels sont limités plus strictement pour chaque visiteur, donc ne le choisissez que pour une API conçue pour cela.
• Agent knowledge. Facultatif, et utile à écrire : les chemins, une requête et une réponse pour chacun, et tout ce qui prête facilement à l’erreur. Setherion le lit quand il construit vos applications. Sans cela, Setherion doit deviner les chemins, et une supposition peut être fausse : dites par exemple quel chemin renvoie votre propre compte. Ne collez jamais de clé ici.

Aucune clé ne va dans le formulaire. Create ouvre la page du connecteur, où vous ajoutez la clé, appuyez sur Test connection et connectez, comme pour n’importe quel autre service. Edit et Delete se trouvent aussi sur cette page. Le supprimer supprime aussi sa clé, et les applications qui l’utilisent cessent aussitôt de pouvoir l’atteindre.

Demandez. Une fois qu’il est connecté et coché pour une application, demandez-le par son nom : « Affichez mes projets ouverts d’Acme sur le tableau de bord. » « Ajoutez un bouton qui crée une tâche dans Acme. »

• L’API base URL doit commencer par https:// et se trouver sur l’internet public. Une adresse à l’intérieur d’un réseau privé, une adresse IP ou une adresse avec un port autre que 443 est refusée, à l’enregistrement et de nouveau à chaque appel.
• Les connecteurs personnalisés sont à vous : ils ne sont pas prêtés aux membres d’un espace de travail d’équipe, et un espace de travail qui liste les connecteurs que ses applications peuvent utiliser les laisse de côté.
• Vous pouvez en avoir jusqu’à 25.
• Pour une seule clé dont une application a besoin, Clés et secrets peut suffire.