Créer une application MatchaiBientôt disponible
Enregistrez l'application que les professionnels connectent : nom, logo, site Web, URL de redirection, identifiant et secret, mode test gratuit et facturation.
Une application Matchai est la façon dont votre produit se présente dans Matchai. Quand un professionnel connecte son compte à votre créateur de sites Web, à votre CRM ou à votre assistant, il le connecte à votre application Matchai : elle affiche votre nom et votre logo sur la page d'autorisation, elle apparaît ensuite sur sa page Connecteurs, et elle détient l'identifiant client et le secret client que votre code utilise pour exécuter le flux OAuth.
En avez-vous besoin?
| Vous bâtissez | Il vous faut |
|---|---|
| Un script ou un outil pour votre propre compte | Une clé d'API. Aucune application. |
| Un produit que d'autres professionnels utilisent, comme un créateur de sites Web, un CRM ou l'application d'un partenaire | Une application Matchai, et Se connecter avec Matchai |
| La lecture de ce que les professionnels ont déjà publié | Rien. Les interfaces publiques ne demandent ni clé ni application. |
Les clients MCP comme Claude et ChatGPT n'ont pas besoin d'une application que vous enregistrez : ils s'enregistrent eux-mêmes quand un professionnel ajoute Matchai. Consultez Clients MCP.
Enregistrer votre application
Ouvrez Paramètres → Connecteurs dans Matchai, déployez Options avancées (pour les développeurs) et choisissez Créer une application Matchai.
Remplissez les renseignements de l'application :
Champ
Type
Enregistrez l'application. Matchai vous donne un identifiant client et un secret client.
Conservez le secret sur votre serveur, dans un gestionnaire de secrets ou une variable d'environnement. Votre application est maintenant prête à lancer le flux de connexion.
Identifiant client et secret client
| Ce que c'est | Où il va | |
|---|---|---|
| Identifiant client | Identifie votre application. Il apparaît dans l'adresse de la page d'autorisation, alors il n'est pas secret. | Dans la redirection vers Matchai |
| Secret client | Prouve qu'une requête provient vraiment de votre application. | Seulement dans les appels côté serveur au point de terminaison de jeton. Jamais dans du code exécuté dans un navigateur ni dans une application mobile. |
Traitez le secret comme un mot de passe : gardez-le hors des dépôts, des journaux et des captures d'écran.
URL de redirection
Après que le professionnel a répondu sur la page d'autorisation, Matchai renvoie son navigateur vers l'une de vos URL de redirection. Pour que ce passage reste sûr :
- Enregistrez chaque adresse que votre application utilise, y compris celle que vous utilisez sur votre propre ordinateur pendant le développement.
- Matchai suit OAuth 2.1 : une adresse de redirection doit correspondre exactement à une adresse enregistrée, et doit utiliser
https. L'exception est une adresse de bouclage commehttp://localhost:3000/matchai/callback, qui convient pendant le développement. - N'acceptez jamais l'adresse de redirection à partir d'un paramètre de requête que n'importe qui pourrait changer.
Mode test
Vous pouvez bâtir et tester avant qu'un client se connecte, sans frais. Une application connectée seulement au compte de son propre développeur est en mode test :
- Elle n'est pas facturée. Connectez votre propre compte Matchai à votre propre application aussi souvent que vous le voulez.
- Elle est identifiée.
GET /v1/me/connectionrenvoietest_mode: true, et les événements que reçoit votre point de terminaison webhook portenttest_mode: true. - C'est une vraie connexion. Vous passez par la même page d'autorisation et obtenez le même genre de jetons, de portées et d'approbations que vos clients, alors vous pouvez bâtir tout le flux avant le lancement.
Quand un autre professionnel connecte votre application, cette connexion est réelle, et elle est facturée comme le décrit la section Qui paie.
Qui paie
Connecter une application à un compte est un connecteur Matchai payant, le même genre de connexion que Claude ou ChatGPT sur la page Connecteurs. L'unité de facturation est un compte Matchai connecté à une application. Une application qui sert trois professionnels détient trois connexions, quel que soit le nombre de jetons, de webhooks ou de requêtes derrière elles.
Chaque application Matchai a un réglage Qui paie :
| Réglage | Ce que voit le professionnel | Qui est facturé |
|---|---|---|
| Payé par l'utilisateur (par défaut) | La page d'autorisation indique que la connexion s'ajoute à sa facture Matchai. | Le professionnel |
| Payé par le partenaire | La page d'autorisation indique que la connexion est incluse avec votre produit. | Vous, en tant que partenaire |
L'option payée par le partenaire est réservée aux partenaires vérifiés qui ont une entente avec Matchai. Si vous voulez payer les connexions de vos clients, communiquez avec l'assistance Matchai pour en discuter. D'ici là, votre application est payée par l'utilisateur, et la page d'autorisation en informe chaque professionnel avant qu'il appuie sur Autoriser.
Matchai signale les applications dont il a vérifié l'éditeur. GET /v1/me/connection renvoie app.verified.
La lecture de renseignements publics, comme les inscriptions publiées d'un professionnel, ne demande jamais de connexion et est gratuite.
Pourquoi la page d'autorisation indique qui paie
Un professionnel ne devrait jamais être surpris par des frais. Il voit la conséquence financière de la connexion de votre application au moment où il décide, à côté de ce que l'application peut faire, et il peut la déconnecter en tout temps.
La suite
Clés d'APIBientôt disponible
Créez une clé d'API à portées limitées pour votre compte Matchai, utilisez-la comme jeton de porteur, protégez-la, renouvelez-la, révoquez-la. Pour vos outils.
Se connecter avec MatchaiBientôt disponible
Laissez un professionnel connecter son compte Matchai à votre application avec OAuth 2.1 et PKCE. Points de terminaison, autorisation, jetons, code TypeScript.