Questions Fréquemment Posées (FAQs)

Exigence métier : plusieurs modes d’abonnement doivent être pris en charge afin de répondre aux différents besoins des utilisateurs 1. Trois modes d’abonnement sont pris en charge : - Abonnement global : s’abonne aux événements de toutes les ressources associées. Après l’abonnement du compte principal, tous les sous-comptes sont automatiquement abonnés par défaut - Abonnement par utilisateur : des object_ids spécifiques doivent être fournis, c’est-à-dire les identifiants des utilisateurs - Abonnement par questionnaire : des object_ids spécifiques doivent être fournis, c’est-à-dire les identifiants des questionnaires 2. Règles de configuration : - À l’exception de l’abonnement global, tous les autres modes d’abonnement doivent inclure les object_ids correspondants - Lors d’un abonnement par utilisateur, l’événement de création de questionnaire n’a pas besoin de object_ids - Lors d’un abonnement par questionnaire, l’événement de création de questionnaire ne peut pas être inclus

Question métier : il faut clarifier les types d'événements pris en charge et leur portée spécifique 1. Prend en charge 7 types d'événements : - Créer un questionnaire - Modifier un questionnaire (uniquement les modifications des questions, à l'exclusion des changements de paramètres du questionnaire) - Supprimer un questionnaire - Réponse complétée - Réponse mise à jour - Réponse supprimée - Réponse invalide (retourne la raison de l'invalidité)

Problème métier : la longueur du champ d'autorisation doit être contrôlée afin d'assurer la sécurité Règle métier : - La longueur du champ d'autorisation est limitée à 0-512 caractères

Problème métier : assurer la fiabilité des rappels de webhook Règles métier : 1. Nouvelle tentative jusqu'à 5 fois 2. Intervalles de nouvelle tentative : - 1re tentative : 10 secondes - 2e tentative : 1 minute - 3e tentative : 5 minutes - 4e tentative : 30 minutes (envoyer un e-mail de rappel au sujet de l'échec de l'envoi) - 5e tentative : 1 jour (envoyer un e-mail de rappel au sujet de la désactivation de l'envoi)

Problème métier : vous devez gérer les échecs consécutifs et en informer l’utilisateur Règles métier : 1. Le système désactive automatiquement tous les webhooks ayant la même URL 2. Envoie une notification par e-mail à l’utilisateur (l’e-mail sera envoyé au compte principal) 3. Enregistre les journaux d’échec dans une file d’attente distincte, avec l’ID du webhook comme clé (conservés pendant 7 jours) 4. Permet à l’utilisateur de reconstituer les données dans un délai de 7 jours

Problème métier : les événements doivent être traités pendant la période où le webhook est désactivé 1. Les enregistrements d’événements dans les 7 jours suivant la désactivation sont stockés dans une file d’attente séparée 2. Si le nombre de désactivations dépasse 1, contactez le support technique 3. Après la réactivation, les données mises en file d’attente seront envoyées de manière proactive

Question métier : les journaux d'appels webhook doivent être enregistrés pour le dépannage Règles métier : - Le callback doit inclure des enregistrements de logs Alibaba Cloud au format JSON

Problème métier : les configurations de webhook en double doivent être empêchées Règles métier : 1. La combinaison de champs suivante doit être unique : - subscription_model (mode d’abonnement) - event_type (type d’événement) - object_ids (identifiants d’objet) - url_subscription (URL d’abonnement) 2. Exception : l’utilisation de la même url_subscription pour différents événements n’est pas restreinte

Question métier : un format d’heure unifié est requis, ainsi qu’un lien d’accès à la ressource. Règles métier : 1. Event Time renvoie un horodatage au niveau de la milliseconde. 2. Les paramètres de push incluent une URL d’accès à la ressource.

Question métier : il est nécessaire de clarifier les types de statut des webhooks et leur impact Règles métier : le statut du webhook est divisé en quatre types : 1. Données historiques (status=0) 2. Disponible (status=1) 3. Indisponible (status=2, aucune notification) 4. Désactivé par le système (status=3, plusieurs échecs de rappel)