Outils Balises
développement back-end
PHP
Documentation du développeur de la plateforme publique WeChat
Placer des coupons
annuaire
Outils Balises
Placer des coupons
Journal de mise à jour
| Numéro de version | Contenu de mise à jour | Heure de mise à jour | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| V1.1 | 1. Créer une nouvelle étagère de cartes et de coupons L'interface permet aux développeurs d'appeler l'interface pour créer des étagères de cartes et de coupons pour placer des cartes et des coupons 2 Ajout d'une nouvelle interface de code d'importation pour aider les développeurs de codes personnalisés à distribuer des cartes et des coupons via la distribution de masse, le service client et. d'autres chaînes en important des codes 2015-8 -31 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Le paramètre | est-il obligatoire | Description |
|---|---|---|
| Données POST | est | Les données JSON |
| access_token | sont | Identifiants de l'interface d'appel |
Données POST
Les développeurs peuvent définir Scan le code QR pour recevoir un seul coupon À ce moment, les données POST sont :
{
"action_name": "QR_CARD",
"expire_seconds": 1800,
"action_info": {
"card": {
"card_id": "pFS7Fjg8kV1IdDz01r4SQwMkuCKc",
"code": "198374613512",
"openid": "oFS7Fjl0WsZ9AMZqrI80nbIq8xrA",
"is_unique_code": false ,
"outer_str":"12b"
}
}
}Lorsque le développeur configure le scan du code QR pour recevoir plusieurs coupons, les données POST sont :
{
"action_name": "QR_MULTIPLE_CARD",
"action_info": {
"multiple_card": {
"card_list": [
{
"card_id": "p1Pj9jgj3BcomSgtuW8B1wl-wo88",
"code":"2392583481",
"outer_str":"12b"
},
{
"card_id": "p1Pj9jgj3BcomSgtuW8B1wl-wo98",
"code":"2392583482",
"outer_str":"12b"
}
]
}
}
}Paramètre. description
| Nom du paramètre | Obligatoire | Type | Exemple de valeur | Description |
|---|---|---|---|---|
| code | est | string(20) | 110201201245 | Les coupons et les coupons doivent être renseignés si le champ use_custom_code est vrai. Les cartes et les coupons avec un code non personnalisé et des modes de code importés n'ont pas besoin d'être renseignés. |
| card_id | no | string(32) | pFS7Fjg8kV1IdD z01r4SQwMkuCKc | Identifiant du coupon. |
| openid | no | string(32) | oXch-jkrxp42VQu8ld weCwDt97qo | Spécifiez l'openid du destinataire, et seul cet utilisateur peut le recevoir. Les cartes et coupons dont le champ bind_openid est vrai doivent être renseignés, et les openid non spécifiés n'ont pas besoin d'être renseignés. |
| expire_seconds | No | unsigned int | 60 | Spécifiez la durée de validité du code QR, la plage est de 60 ~ 180 0 seconde. S'il n'est pas renseigné, il sera valable 365 jours par défaut |
| is_unique_code | no | bool | false | Spécifiez émettre un QR code et le généré Le code QR sera attribué au hasard, il ne pourra pas être scanné à nouveau après l'avoir reçu. Remplissez vrai ou faux. La valeur par défaut est false. Notez que lorsque vous remplissez ce champ, la carte doit réussir l'examen et l'inventaire n'est pas 0. |
| outer_id | No | int | 12 | Recevoir la valeur de la scène, utilisée pour collecter les statistiques de données de canal, la valeur par défaut est 0, le type de champ est entier , longueur Limitée à 60 chiffres.Cette valeur de scène personnalisée sera incluse dans le événement push déclenché après que l'utilisateur ait reçu le coupon. |
outer_str | no | string(128) | 13b | outer_id version améliorée du champ , type de chaîne Lorsque l'utilisateur reçoit la carte pour la première fois. , il le recevra via L'événement est poussé vers le commerçant ; Pour le code QR de la carte de membre, chaque fois que l'utilisateur scanne le code pour ouvrir la carte de membre et clique sur n'importe quelle URL, la valeur sera épelée dans l'URL pour faciliter aux développeurs de localiser la source du code scanné |
Retourner les données
{
"errcode": 0,
"errmsg": "ok",
"ticket": "gQHB8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0JIV3lhX3psZmlvSDZmWGVMMTZvAAIEsNnKVQMEIAMAAA==",//获取ticket后需调用换取二维码接口获取二维码图片，详情见字段说明。
"expire_seconds": 1800,
"url": "http://weixin.qq.com/q/BHWya_zlfioH6fXeL16o ",
"show_qrcode_url": " https://mp.weixin.qq.com/cgi-bin/showqrcode? ticket=gQH98DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0czVzRlSWpsamlyM2plWTNKVktvAAIE6SfgVQMEgDPhAQ%3D%3D"
}Description du paramètre
| Nom du paramètre | Description |
|---|---|
| errcode | Error code |
| errmsg | Message d'erreur |
| ticket | Obtenir Ticket QR code, avec cet appel de ticket via l'interface d'échange de ticket QR code vous pouvez échanger le QR code dans le délai de validité. |
| url | L'adresse après l'analyse de l'image du code QR, les développeurs peuvent générer l'image de code QR requise en fonction de l'adresse |
| show_qrcode_url | Adresse d'affichage du code QR, cliquez pour accéder à la page du code QR |
Notes :
1. Coupons de code personnalisé, le QR généré le code ne peut être collecté qu'une fois à la fois. Si le développeur souhaite utiliser son propre système de code de série et souhaite utiliser le code QR de WeChat
, il doit d'abord importer le code personnalisé ；
.2. Pour recevoir plusieurs codes QR, remplissez jusqu'à 5 card_ids à la fois, sinon une erreur sera signalée.
2 Émission de coupons en ligne HTML5 (interface JS-SDK)
WeChat JS-SDK ne prend en charge que l'utilisation dans le navigateur intégré de WeChat et les appels provenant d'autres navigateurs ne sont pas valides.
WeChat fournit l'interface addCard permettant aux pages Web frontales des commerçants d'appeler, qui est utilisée pour ajouter une ou plusieurs cartes et coupons au paquet de cartes de l'utilisateur. Pour plus de détails, veuillez consulter l'Interface d'ajout par lots de cartes et de bons.
3 Placer les coupons dans l'étagère des coupons
Introduction à l'étagère des coupons
L'étagère des coupons aide les développeurs à générer une carte en appelant l'interface page de collection H5, et obtenez le lien de la page pour effectuer l'action de la carte et du coupon. Actuellement, l'étagère des cartes et des coupons ne prend en charge que les cartes et les coupons sans codes personnalisés. Les cartes et les coupons avec des codes personnalisés doivent d'abord appeler l'Interface d'importation de code pour importer le code avant de pouvoir être utilisés normalement.
3.1 Créer une interface d'étagère
Description de l'interface
Les développeurs doivent appeler cette interface pour créer des liens d'étagère pour le placement des cartes et des coupons. Lors de la création d'une étagère, vous devez renseigner le champ scène du parcours de livraison.
Description de la demande d'appel d'interface
HTTP请求方式: POST URL:https://api.weixin.qq.com/card/landingpage/create?access_token=$TOKEN
Description du paramètre de demande
Le paramètre| est-il obligatoire | buffer | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| is | Flux de données des fichiers | Données POST {
"banner":"http://mmbiz.qpic.cn/mmbiz/iaL1LJM1mF9aRKPZJkmG8xXhiaHqkKSVMMWeN3hLut7X7h icFN",
"page_title": "惠城优惠大派送",
"can_share": true,
"scene": "SCENE_NEAR_BY",
"card_list": [
{
"card_id": "pXch-jnOlGtbuWwIO2NDftZeynRE",
"thumb_url": "www.qq.com/a.jpg"
},
{
"card_id": "pXch-jnAN-ZBoRbiwgqBZ1RV60fI",
"thumb_url": "www.qq.com/b.jpg"
}
]
}Description du paramètre
Description des données de retour {
"errcode":0,
"errmsg":"ok",
"url":"www.test.url",
"page_id":1
}Description du champ
Ce module est uniquement destiné aux marchands de code personnalisé, les développeurs de code non personnalisé doivent automatiquement l'ignorer. Les développeurs peuvent importer des codes personnalisés dans le serveur WeChat à l'avance pour obtenir les mêmes capacités de livraison que les commerçants de codes non personnalisés, telles que la distribution de groupe, l'émission de cartes et de coupons via les messages du service client, etc. Les coupons après l'importation du code sont équivalents aux coupons de code non personnalisés une fois publiés. les coupons sont différents des méthodes de création précédentes. Il est recommandé aux développeurs d'utiliser le processus suivant pour créer des coupons en mode code pré-stockés, sinon une erreur sera signalée. Étape 1 : Créez un coupon de mode pré-enregistré, définissez la valeur initiale de la quantité en stock sur 0 et remplissez le champ get_custom_code_mode Étape 2 : Une fois le coupon passé l'examen, appelez ; l'interface de code d'importation et Vérifiez le code ; Étape 3 : Appelez l'interface d'inventaire de modification pour rendre l'inventaire de la carte inférieur ou égal au nombre de codes importés. (Il est recommandé de le régler sur égal pour éviter toute confusion)
Coupons non nouvellement créés Si le développeur dispose déjà d'un coupon et souhaite le faire passer en mode code pré-enregistré, il est recommandé au développeur de suivre le processus suivant pour mettre à jour le coupon. Étape 1 : Appelez l'interface de code d'importation pour importer une certaine quantité de code personnalisé et vérifiez le code ; Étape 2 : Appelez l'interface d'informations sur la carte de changement et le coupon pour remplir le champ get_custom_code_mode ; Étape 3 : Appelez l'interface de modification d'inventaire pour stocker la carte et les coupons en inventaire. La quantité est fixée à un nombre égal au nombre de codes importés.
4.1.1 Remplissez/mettez à jour les champs obligatoires du code d'importationDescription de l'interface Les cartes et les coupons avec des codes personnalisés prennent uniquement en charge la création d'API. Lors de la création, assurez-vous d'ajouter les champs suivants à base_info (voir le document d'interface CreateCard pour plus de détails). Ce n'est qu'après avoir ajouté les deux champs spécifiés suivants que vous pourrez appeler l'interface d'importation de code. coder Importer
Exemple JSON lors de la création d'une carte {
"card": {
"card_type": "GROUPON",
"groupon": {
"base_info": {
··········
"use_custom_code":true,
"get_custom_code_mode":"GET_CUSTOM_CODE_MODE_DEPOSIT",
},
"advanced_info": {
··········
},
"deal_detail": "示例"
}
}
}Exemple JSON lors de la mise à jour d'une carte {
"card_id":"ph_gmt7cUVrlRk8swPwx7aDyF-pg",
"groupon": {
"base_info": {
·········
"get_custom_code_mode":"GET_CUSTOM_CODE_MODE_DEPOSIT",
·········
}
}
}Remarque : Créer/Quand en mettant à jour get_custom_code_mode, vous devez vérifier la relation entre le numéro d'inventaire et le nombre de codes importés. Lorsque le nombre de codes importés est inférieur au numéro d'inventaire, une erreur sera signalée. 4.1.2 Interface d'importation de codeUne fois le coupon de code personnalisé créé avec succès et passé l'examen, le code personnalisé doit être importé dans le code selon le numéro convenu avec le émetteur L'interface est importée dans le backend WeChat. Description de l'interface Les développeurs peuvent appeler cette interface pour importer le code personnalisé dans le backend de la carte et du coupon WeChat, et l'agent secondaire WeChat stockera et émettra le code. Remarque : 1) La limite supérieure du nombre de codes entrants pour un seul appel vers l'interface est de 100. 2) Chaque code ne peut pas être une chaîne vide. 3) Une fois l'importation terminée, le système déterminera automatiquement si l'inventaire défini par le fournisseur est cohérent avec la quantité réelle de code importé. 4) Si l'importation échoue, l'importation répétée est prise en charge jusqu'à ce que l'invite réussisse. Description de la demande d'appel d'interface HTTP请求方式: POST URL:http://api.weixin.qq.com/card/code/deposit?access_token=ACCESS_TOKEN Description du paramètre de demande Le paramètre
|
![Premiers pas avec le développement pratique PHP : création rapide de PHP [Small Business Forum]](https://img.php.cn/upload/course/000/000/035/5d27fb58823dc974.jpg)
