Générer un code QR avec des paramètres

Afin de répondre aux besoins de scénarios tels que l'analyse de la promotion des canaux utilisateurs et la liaison des comptes utilisateurs, la plateforme publique fournit une interface pour générer des codes QR avec des paramètres. Grâce à cette interface, plusieurs codes QR avec différentes valeurs de scène peuvent être obtenus. Une fois que l'utilisateur les a scannés, le compte public peut recevoir un événement push.

Il existe actuellement 2 types de codes QR :

1. Le code QR temporaire a un délai d'expiration. Il peut être configuré pour expirer 30 jours (soit 2592 000 secondes) après la génération du code QR, mais il est capable de générer de plus grandes quantités. Les codes QR temporaires sont principalement utilisés dans des scénarios commerciaux tels que la liaison de compte qui ne nécessitent pas de stockage permanent des codes QR. 2. Les codes QR permanents n'ont pas de délai d'expiration, mais leur nombre est petit (actuellement jusqu'à 100 000). Les codes QR permanents sont principalement utilisés dans des scénarios tels que la liaison de compte et les statistiques de source d'utilisateurs.

Lorsque l'utilisateur scanne le code QR avec la valeur de scène, les deux événements suivants peuvent être poussés :

Si l'utilisateur n'a pas suivi le compte officiel, l'utilisateur peut suivre le compte officiel. Après avoir suivi, WeChat poussera ce qui suit. événement avec une valeur scénique pour le développement qui.

Si l'utilisateur a suivi le compte officiel, il entrera automatiquement dans la session après la numérisation, et WeChat transmettra également l'événement de numérisation avec la valeur de la scène au développeur.

Le processus d'obtention d'un code QR avec paramètres comprend deux étapes. Tout d'abord, créez un ticket de code QR, puis utilisez le ticket vers l'URL spécifiée pour échanger le code QR.

Créer un ticket de code QR

Chaque fois que vous créez un ticket de code QR, vous devez fournir un paramètre (scene_id) défini par le développeur. Le processus de création d'un ticket de code QR pour un code QR temporaire et un code QR permanent est. introduit respectivement.

Instructions de demande de code QR temporaire

Instructions de demande de code QR permanent

Description du paramètre

Paramètre	Description
expire_seconds	La durée de validité de ce code QR, en secondes. La valeur maximale ne peut pas dépasser 2592000 (soit 30 jours). Si ce champ n'est pas renseigné, la période de validité par défaut est de 30 secondes.
action_name	Type de code QR, QR_SCENE est temporaire, QR_LIMIT_SCENE est permanent, QR_LIMIT_STR_SCENE est une valeur de paramètre de chaîne permanente
action_info	Détails du code QR
scene_id	ID de valeur de scène, c'est un 32 -bit entier non nul pour le code QR temporaire, et la valeur maximale pour le code QR permanent est de 100 000 (actuellement, le paramètre ne prend en charge que 1 à 100 000)
scene_str	ID de valeur de scène (ID sous forme de chaîne), chaîne tapez, la limite de longueur est de 1 à 64, seul le code QR permanent prend en charge ce champ

Instructions de retour

Paramètre	Description
ticket	Le ticket QR code obtenu, avec ce ticket vous pouvez échanger contre le QR code dans le délai de validité.
expire_seconds	La durée de validité de ce code QR, en secondes. La valeur maximale ne dépasse pas 2 592 000 (soit 30 jours).
url	L'adresse après l'image du code QR est analysée. Les développeurs peuvent générer l'image de code QR requise en fonction de cette adresse

.

Échangez le code QR via un ticket

Après avoir obtenu le ticket du code QR, les développeurs peuvent échanger le ticket contre l'image du code QR. Veuillez noter que cette interface peut être appelée sans vous connecter.

Instructions de demande

Si le ticket est correct, le code retour http est 200, qui est une image et peut être affiché ou téléchargé directement.

En cas d'erreur (telle qu'un ticket illégal), Le code d'erreur HTTP 404 est renvoyé.