Guide du développeur : devenir partenaire, créer une application, la tester dans le bac à sable et la soumettre à certification

Pour les partenaires développeurs invités : acceptez votre invitation, créez une application et une version, testez-la dans votre bac à sable, soumettez-la à certification, corrigez les retours et gérez membres et compte.

Étape 1 : Acceptez votre invitation#

L’accès développeur se fait sur invitation. Quand l’équipe plateforme vous invite, vous recevez un e-mail avec un lien d’acceptation (valable 7 jours). Ouvrez le lien, connectez-vous avec l’adresse e-mail qui a reçu l’invitation et confirmez : votre compte développeur devient actif et vous arrivez dans le Developer Center. Avec une autre adresse, l’acceptation est refusée et l’invitation reste inutilisée — déconnectez-vous et reconnectez-vous avec l’adresse invitée. Si le lien a expiré, demandez-en un nouveau.

Étape 2 : Créez votre application et sa première version#

Dans le Developer Center, choisissez « Nouvelle application » et donnez-lui un code et un nom affiché. Ouvrez ensuite l’application et ajoutez une version : indiquez le numéro de version et déclarez ce qu’elle nécessite — les autorisations de données (scopes) demandées, les origines web d’intégration autorisées, l’emplacement de ses pages dans les menus des locataires et le pack de contenu prêt à l’emploi qu’elle apporte. La déclaration n’est modifiable qu’en brouillon ou après un renvoi pour modifications ; ensuite elle est verrouillée et tout changement exige une nouvelle version. Vous ne voyez que les applications de votre propre compte développeur — impossible de voir ou d’ouvrir celles d’un autre partenaire.

Étape 3 : Testez d’abord dans votre bac à sable#

Ouvrez la page Bac à sable et provisionnez votre bac à sable — chaque compte développeur dispose d’une organisation de test dédiée, entièrement séparée des locataires réels. Dans le bac à sable, vous pouvez installer votre propre application même avant sa certification, émettre des identifiants de bac à sable et appeler l’API publique avec eux pour vérifier votre intégration de bout en bout. Lancez les auto-tests depuis la page du bac à sable avant de soumettre : ils exécutent les mêmes contrôles automatiques (connexion, refus inter-organisations et signature d’événements) que la porte de certification, et les résultats restent enregistrés pour corriger tôt. Réinitialiser le bac à sable le vide entièrement ; votre historique d’auto-tests est conservé. Les identifiants de bac à sable ne fonctionnent que dans votre bac à sable — ils n’atteignent jamais les données d’un locataire réel.

Étape 4 : Soumettez à certification#

Ouvrez la version et choisissez Soumettre. Les contrôles automatiques s’exécutent d’abord — pour cela, votre application doit déjà être installée dans votre bac à sable avec un abonnement aux événements en place, exactement comme pour les auto-tests. Si les contrôles ne peuvent pas encore s’exécuter, la soumission est retenue avec un message indiquant ce qui manque ; rien n’est approuvé en silence. Après la partie automatique, l’équipe de revue traite les points restants de la liste. Vous suivez la progression sur la page de la version : chaque point affiche son résultat et, en cas de renvoi, le motif du réviseur en mots clairs (vous ne voyez jamais les détails internes de la revue).

Étape 5 : Si votre version est renvoyée#

Un renvoi de version (« modifications demandées ») n’est pas un rejet de votre application : des points précis ont besoin de travail. Lisez le motif de chaque point, corrigez votre intégration et modifiez la déclaration de la version si nécessaire (une version renvoyée redevient modifiable). Relancez les auto-tests du bac à sable, puis resoumettez depuis la même page de version. Quand tous les points passent, la version est certifiée pour 12 mois. Après la certification, vous publiez vous-même depuis la même page de version : pour ne diffuser qu’à des locataires nommés, saisissez leur liste d’organisations dans le champ de liste (allowlist) de la version et enregistrez — seules ces organisations verront la version et pourront l’installer, et vous pouvez mettre la liste à jour à tout moment ; la publication publique est ouverte par l’équipe plateforme.

Membres et votre compte#

Sur la page Membres, le propriétaire du compte peut inviter des coéquipiers par e-mail, ajouter directement des utilisateurs existants et retirer des membres ; les invités acceptent comme à l’étape 1. Les membres peuvent travailler sur les applications du compte, mais seul le propriétaire gère les membres. Sur la page Compte, vous voyez les détails de votre compte développeur ; le propriétaire peut mettre à jour le nom du compte et l’e-mail de contact — le statut et les autres champs gérés par la plateforme s’affichent en lecture seule. Si l’équipe plateforme suspend votre compte développeur, vos applications ne peuvent plus être nouvellement installées ni soumises jusqu’à réactivation — contactez l’équipe dans ce cas ; les applications déjà installées gardent leur état et sont traitées par l’équipe plateforme.

Consultez vos avis et retours#

Sur la page de votre application dans le Developer Center, vous voyez comment les organisations qui l’ont installée la notent : la moyenne réelle, le nombre d’avis et la répartition par étoiles. Ce sont les totaux réels, visibles uniquement par vous. Le catalogue public n’affiche une note que lorsqu’une application a au moins 3 avis ; jusque-là, il affiche « pas encore assez d’avis ». Si votre page indique que l’échantillon est encore trop petit, c’est pour cela que le catalogue n’affiche pas encore de note.

Les organisations peuvent aussi laisser une courte note privée avec leurs étoiles. Vous voyez la note et les étoiles, mais jamais quelle organisation l’a envoyée — les retours sont anonymes par conception. Si vous pensez qu’un avis vient d’une fausse installation plutôt que d’un vrai client, contactez l’équipe de la plateforme par le canal de support habituel en indiquant quelle application et à peu près quand l’avis est apparu ; l’équipe peut vérifier l’enregistrement d’installation et masquer un avis qui ne devrait pas compter. La plateforme ne modifie jamais les étoiles — un avis masqué peut être restauré si la vérification le blanchit.