Retour de problème
Si vous rencontrez un problème lors de l’utilisation de MoleAPI, ou si vous avez besoin d’une nouvelle fonctionnalité, n’hésitez pas à nous faire un retour. Ici, l’accent est mis sur une méthode de feedback du point de vue de l’utilisateur, plutôt que de vous demander d’ouvrir une issue sur GitHub.
🧾 Informations à préparer avant de faire un retour
Plus les informations sont complètes, plus le diagnostic est rapide
Préparez au minimum une capture d’écran ou le message d’erreur complet ; si vous pouvez également fournir le nom du modèle, la Base URL, le client utilisé et les étapes de reproduction, l’analyse sera beaucoup plus efficace.
Nous vous recommandons de rassembler les éléments suivants :
- Une capture d’écran de l’erreur, ou le texte complet de l’erreur pouvant être copié
- Le nom du modèle utilisé, le nom de l’application et la Base URL
- L’heure approximative à laquelle le problème s’est produit, ainsi que l’action que vous effectuiez
- S’il s’agit d’un problème de facturation, de hit du cache ou de solde, joignez de préférence une capture d’écran du détail de consommation
📮 Méthodes de retour recommandées
Vous pouvez procéder dans l’ordre suivant :
- Consultez d’abord la FAQ et les codes d’erreur courants
- Si le problème n’est toujours pas résolu, rendez-vous dans le groupe QQ indiqué sur la page Interaction avec la communauté pour faire un retour
- Lors du retour, envoyez directement toutes les informations clés en une seule fois, et évitez de vous limiter à « ça ne marche pas » ou « il y a une erreur »
🐞 Quels types de problèmes sont adaptés à un retour ?
- Anomalies d’utilisation, par exemple les erreurs courantes 400 / 401 / 403 / 404 / 429 / 500
- Solde, quota, lecture du cache ou résultats de facturation difficiles à comprendre
- Disponibilité d’un modèle donné, ou raisons pour lesquelles son comportement diffère de vos attentes
- Documentation peu claire, explications de page susceptibles d’induire en erreur, captures d’écran obsolètes
- Nouvelles fonctionnalités ou nouvelles capacités d’utilisation que vous souhaitez voir ajoutées
💡 Comment formuler une suggestion de fonctionnalité de manière plus efficace ?
Si vous avez besoin d’une fonctionnalité, vous pouvez également soumettre directement une suggestion. Plutôt qu’une simple phrase comme « je voudrais ajouter telle fonctionnalité », une formulation comme celle-ci a plus de chances d’être retenue :
- La fonctionnalité que vous souhaitez
- La manière dont vous comptez l’utiliser
- Le point de blocage actuel
- En quoi cette fonctionnalité vous permettrait de réduire des coûts ou de résoudre un problème
Le problème le plus fréquent lors des retours
Envoyer uniquement « ça ne marche pas » ou « il y a une erreur » ne permet généralement pas d’identifier la cause. Préparez au moins deux ou trois éléments parmi une capture d’écran, le texte de l’erreur, le nom du modèle et les étapes effectuées avant de demander de l’aide ; cela ira beaucoup plus vite.
Ce guide vous a-t-il aidé ?
Dernière mise à jour le