WeChat カードとクーポンのインターフェイス
1 お知らせ
カードとクーポンのインターフェイスのドキュメントをお読みになるには、必ずご確認ください。 WeChat パブリックを読むには、プラットフォーム開発者向けの一般的な指示文書には、「WeChat 開発者仕様」 と「WeChat 公式アカウント インターフェイス権限の説明 」という 2 つの章があります。 、WeChat パブリック プラットフォーム インターフェイスの基本的な呼び出し方法、開発者の仕様、呼び出しプロセス中の例外の処理について学習します。
サンドボックス テスト アカウントを申請する利用可能なカードとクーポンのテスト アカウントがない場合は、カードとクーポンのテスト用の WeChat インターフェイス テスト アカウント アプリケーション ツールを通じて一時的なテスト番号を申請できます。
インターフェイス テスト アカウントにログインして、 WeChat 経由でスキャンを適用して、新しい appid を取得できます (友人のクーポンを含む、カードとクーポンを作成する権限がすでにあります) そしてappsecret は、カードとクーポンのインターフェイスを呼び出すために使用されます。 注: このアプリで作成されたクーポンは承認されず、小規模なテストに限定されます。開発者は他の目的でクーポンを使用することはできません。 開発読者は次のことができます。デバッグ ツールを使用して、カードとクーポンの作成、カードとクーポンの配置、およびカードとクーポンのキャンセルのプロセスをすばやく完了します。カードとクーポンのインターフェイスを詳しく理解したい場合は、ドキュメントの対応する部分を詳細に読む必要があります。 。 ステップ 1 access_token を取得します ページ アドレス: http://mp.weixin.qq.com/debug/ インターフェイス タイプ: 基本サポート インターフェイス リスト: access_token インターフェイスの取得 注: 開発者の appid とシークレットをパラメーターとして入力します クリック問題を確認し、access_token に戻ります。access_token は 2 時間有効です。2 時間後に再度取得する必要があります。 ステップ 2 クーポンのロゴをアップロードします ページ アドレス: http://mp.weixin.qq.com/debug/ インターフェイス タイプ: 基本サポート インターフェースリスト: 画像素材をアップロードするインターフェース ##access_token: 前のステップで取得した access_token クリックして問題を確認すると、画像のURLを取得できます。クーポンを作成する次のステップでは、 が必要です。 ページ アドレス: http://mp.weixin.qq.com/debug/ インターフェイス タイプ: カード インターフェイス インターフェースリスト: カードクーポンインターフェースの作成 access_token: 最初のステップで取得した access_token JSON の例 ： 注: date_info では Unix タイムスタンプが使用されています。後でクーポンをテストできるように、begin_timestamp を現在時刻よりも小さい値に変更し、end_timestamp を今日以降に変更してください。成功 インターフェイス アドレス:カードとクーポン インターフェイスの作成 ステップ 4 QR コード配信の作成 ##ページ アドレス: http :/ /mp.weixin.qq.com/debug/ インターフェイス タイプ: カード インターフェイス インターフェイス リスト: QR コード チケット インターフェイスの作成 access_token: 最初のステップで取得した access_token QR コード インターフェイスの作成 #ステップ 5 QR コードを表示します # #前のステップから戻ったときに show_qrcode_url フィールドのリンクをクリックすると、カードとクーポンのコレクション用の QR コードが表示されます。 例: https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=gQEr8ToAAAAAAAAAASxodHRwOi8vd2V********NjRjVuAAIE3kqwVQMEgDPhAQ == WeChat を開いてスキャンし、クーポンを受け取ります。クーポンが審査に合格していないことが示された場合は、次のステップでテスト ホワイトリストを設定する必要があります。受信できる場合は、手順 6 を無視してください。 次の QR コードをスキャンして WeChat クーポンを体験できます: ステップ 6 テスト ホワイトリストを設定する ##ページ アドレス: http: //mp.weixin.qq.com/debug/ インターフェイス タイプ: クーポン インターフェイス インターフェイス リスト: テスト ホワイトリスト インターフェイスを設定します ##JSON の例: 3 カード クーポンHelloWorld
#{
"card": {
"card_type": "GROUPON",
"groupon": {
"base_info": {
"logo_url":
"http://mmbiz.qpic.cn/mmbiz/iaL1LJM1mF9aRKPZJkmG8xXhiaHqkKSVMMWeN3hLut7X7hicFNjakmx ibMLGWpXrEXB33367o7zHN0CwngnQY7zb7g/0",
"brand_name":"微信餐厅",
"code_type":"CODE_TYPE_TEXT",
"title": "132元双人火锅套餐",
"sub_title": "周末狂欢必备",
"color": "Color010",
"notice": "使用时向服务员出示此券",
"service_phone": "020-88888888",
"description": "不可与其他优惠同享\n如需团购券发票，请在消费时向商户提出\n店内均可使用，仅限堂食",
"date_info": {
"type": "DATE_TYPE_FIX_TERM",
"fixed_term": 15 ,
"fixed_begin_term": 0
},
"sku": {
"quantity": 500000
},
"get_limit": 3,
"use_custom_code": false,
"bind_openid": false,
"can_share": true,
"can_give_friend": true,
"location_id_list" : [123, 12321, 345345],
"custom_url_name": "立即使用",
"custom_url": "http://www.qq.com",
"custom_url_sub_title": "6个汉字tips",
"promotion_url_name": "更多优惠",
"promotion_url": "http://www.qq.com"
},
"deal_detail": "以下锅底2选1（有菌王锅、麻辣锅、大骨锅、番茄锅、清补凉锅、酸 菜鱼锅可选）：\n大锅1份 12元\n小锅2份 16元 "}
}
}{
"action_name": "QR_CARD",
"action_info": {
"card": {
"card_id": "po_2DjgJ2zrboM6SzK3qNuje5iWQ",
}
}
}
{ "username":["usr1","usr2"] }Note : usr1 と sur2 はクーポンを受け取るために使用される WeChat ID です
インターフェイス アドレス:
ホワイトリスト インターフェイスを設定します#ステップ 7 カードを確認してキャンセルする
#ページ アドレス: http://mp.weixin.qq.com/debug/
インターフェイス タイプ: カード インターフェイス
インターフェースリスト: カードキャンセルインターフェース
access_token: 最初のステップで取得したaccess_token
JSON の例:
{ "code"："759733467744" }注: レビューに合格し、有効期間内のカード クーポンのインターフェイス アドレスのみがサポートされます: Cancel インターフェイス
#4 カードとクーポンのインターフェイスの概要
業界独自のカード・クーポンアプリを実現する開発を行う。
#5 カード用語の概要
カードとクーポンの開発プロセス中に理解する必要がある主要な概念は次のとおりです:
#パラメータ名 ＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃説明する＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃ ##card_id | カード ID。クーポンIDはクーポンの種類に対応し、対応する在庫数のコードが含まれます。 ＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃コード＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃クーポンコード。カードとクーポンの一意の識別子。この文字列コードは、カードとクーポンをキャンセルするときに使用されます。販売者のカスタマイズをサポートします。 | |
公式アカウントのユーザー名 一意身元。 | ##access_token | |
インターフェースを呼び出すための認証情報、有効期間7200 秒かかります。リクエストが更新されるたびに、get access_token インターフェイス を通じて | が取得されます。開発者はそれを適切に保存し、キャッシュ メカニズムを確立する必要があります。 jsapi_ticket | |
| api_ticket | WeChat カードとクーポン インターフェイスを呼び出すときに署名された一時チケットは、7200 秒間有効です。 7200 秒以内に繰り返されるリクエストでは変更されません。 . API_ticket インターフェイスを取得しますGet。 | |
card_ext | 拡張可能なカードに関する追加情報。席カードとクーポンには、カードとクーポンに関する基本的な情報が含まれています。 | |
クーポン収集チャネルのシナリオ値 | 。販売者がカードやクーポンを発行するために、card_ext にカスタム シーン値を入力できるようにします。ユーザーがカードを受け取ると、対応するシーン値がイベントを通じて販売者に通知されます。 | |
在 | クーポンレビューに合格し、カードとクーポンを受け取り、カードとクーポンを削除し、カードとクーポンを消去します, イベントをプッシュして開発者に通知します。受信アドレスは、パブリック プラットフォーム デベロッパー センターに入力されたサーバー URL です。 | |
#カスタム エントリ | API 経由でクーポンを作成する 販売者をサポートするカードとクーポンの詳細ページの外部リンクにジャンプするようにユニットをカスタマイズします。 |
