検索
  • サインイン
  • サインアップ
パスワードのリセットが成功しました

興味のあるプロジェクトをフォローし、それらに関する最新ニュースをチェックしてください

WeChat カードとクーポンのインターフェイス

コレクション 105
リーディング 40451
更新時間 2016-09-11

1 お知らせ

カードとクーポンのインターフェイスのドキュメントをお読みになるには、必ずご確認ください。 WeChat パブリックを読むには、プラットフォーム開発者向けの一般的な指示文書には、「WeChat 開発者仕様」 と「WeChat 公式アカウント インターフェイス権限の説明 」という 2 つの章があります。 、WeChat パブリック プラットフォーム インターフェイスの基本的な呼び出し方法、開発者の仕様、呼び出しプロセス中の例外の処理について学習します。


##2

サンドボックス テスト アカウントを申請する利用可能なカードとクーポンのテスト アカウントがない場合は、カードとクーポンのテスト用の WeChat インターフェイス テスト アカウント アプリケーション ツールを通じて一時的なテスト番号を申請できます。

インターフェイス テスト アカウントにログインして、

WeChat 経由でスキャンを適用して、新しい appid を取得できます (友人のクーポンを含む、カードとクーポンを作成する権限がすでにあります) そしてappsecret は、カードとクーポンのインターフェイスを呼び出すために使用されます。


注: このアプリで作成されたクーポンは承認されず、小規模なテストに限定されます。開発者は他の目的でクーポンを使用することはできません。


3 カード クーポンHelloWorld

開発読者は次のことができます。デバッグ ツールを使用して、カードとクーポンの作成、カードとクーポンの配置、およびカードとクーポンのキャンセルのプロセスをすばやく完了します。カードとクーポンのインターフェイスを詳しく理解したい場合は、ドキュメントの対応する部分を詳細に読む必要があります。 。


ステップ 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

buffer: 選択画像

クリックして問題を確認すると、画像のURLを取得できます。クーポンを作成する次のステップでは、

が必要です。


##ステップ 3 カード クーポンの作成

ページ アドレス: http://mp.weixin.qq.com/debug/

インターフェイス タイプ: カード インターフェイス

インターフェースリスト: カードクーポンインターフェースの作成

access_token: 最初のステップで取得した access_token

JSON の例 :

{ 
"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元 "}
}
}

注: date_info では Unix タイムスタンプが使用されています。後でクーポンをテストできるように、begin_timestamp を現在時刻よりも小さい値に変更し、end_timestamp を今日以降に変更してください。成功

インターフェイス アドレス:カードとクーポン インターフェイスの作成


ステップ 4 QR コード配信の作成


##ページ アドレス: http :/ /mp.weixin.qq.com/debug/

インターフェイス タイプ: カード インターフェイス

インターフェイス リスト: QR コード チケット インターフェイスの作成

access_token: 最初のステップで取得した access_token

##JSON の例:

{
"action_name": "QR_CARD", 
"action_info": {
"card": {
"card_id": "po_2DjgJ2zrboM6SzK3qNuje5iWQ", 
   }
 }
}

インターフェイス アドレス:

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/

インターフェイス タイプ: クーポン インターフェイス

インターフェイス リスト: テスト ホワイトリスト インターフェイスを設定します

#access_token: 最初のステップで取得した access_token

##JSON の例:


{ "username":["usr1","usr2"] }
Note : usr1 と sur2 はクーポンを受け取るために使用される WeChat ID です

インターフェイス アドレス:

ホワイトリスト インターフェイスを設定します


#ステップ 7 カードを確認してキャンセルする


#ページ アドレス: http://mp.weixin.qq.com/debug/

インターフェイス タイプ: カード インターフェイス

インターフェースリスト: カードキャンセルインターフェース

access_token: 最初のステップで取得したaccess_token


JSON の例:

{ "code":"759733467744" }

注: レビューに合格し、有効期間内のカード クーポンのインターフェイス アドレスのみがサポートされます: Cancel インターフェイス


#4 カードとクーポンのインターフェイスの概要


##WeChat カードとクーポンのインターフェイスは、主にカードとクーポンの作成、収集、配置、検証に関する一連のインターフェイスを設定します。開発者は、達成したい効果に応じて適切なインターフェイスを選択できます

業界独自のカード・クーポンアプリを実現する開発を行う。



#5 カード用語の概要


カードとクーポンの開発プロセス中に理解する必要がある主要な概念は次のとおりです:


openidWeChat Web ページを呼び出すために使用する必要がある JS-SDK インターフェイス。 WeChat ネイティブ関数の署名チケットを呼び出します。詳細については、JS-SDK セクションを参照してください。##outer_id。販売者がカードやクーポンを発行するために、card_ext にカスタム シーン値を入力できるようにします。##イベントプッシュクーポンレビューに合格し、カードとクーポンを受け取り、カードとクーポンを削除し、カードとクーポンを消去します


##6 開発者向けノート


6.1 WeChat バージョンの判断

カードおよびクーポン機能モジュールは、WeChat バージョン 6.0.2 以降でのみサポートされます。以前のバージョンのユーザーが JS-SDK を呼び出すことは無効です。したがって、WeChat チームは、カード パッケージに追加された JS-SDK インターフェイスを呼び出す前に、ユーザー エージェントを使用してユーザーの現在のバージョン番号を確認することを販売者に推奨しています。 iPhone のバージョンを例に挙げると、ユーザー エージェントを通じて次のバージョン サンプル情報を取得できます:

"Mozilla/5.0(iphone;CPU iphone OS 5_1_1 like Mac OS X)     
AppleWebKit/534.46(KHTML,like Geocko)Mobile/9B206 MicroMessenger/6.0.2 "

。ここで、6.0.2 はユーザーがインストールした WeChat のバージョン番号です。販売者は、バージョン番号が 6.0.2 以上であるかどうかを判断できます。


6.2 カードとクーポンの配置制限

パブリック アカウント セッション環境では、ドメイン名での呼び出しのみパブリックアカウントのカードとクーポンがサポートされています。パブリック アカウント セッション内で他の販売者からクーポンをプッシュすることは、プラットフォームの許可がない限りサポートされていません。それ以外の場合、ユーザーはクーポンを受け取るときに次のメッセージが表示されます: 「クーポン販売者の許可なしに投稿することはできません」。公開アカウントの会話 (モーメントや会話環境など) 以外には、そのような制限はありません。

注意事項

パブリック アカウントのダイアログ ボックスで発生する動作、およびパブリック アカウントのダイアログ ボックスからジャンプするアクションダイアログ ボックス Web リンクはすべて公式アカウントのセッション環境内にあります。


6.3 エンコーディング ルール

すべての API インターフェイス POST データは UTF-8 エンコーディングのみをサポートします。それ以外の場合はエラーが発生します。戻ってきた 。


#6.4 外部リンクへジャンプパラメータの説明

カードとクーポン自体に基づいた加盟店の拡張要件を満たすために、カードとクーポンの内側のページに外部リンクに飛ぶためのURLです。

カードとクーポンが飛び出す外部リンクには、開発者がページ上でユーザーの身元を確認するために使用するカードとクーポン情報のパラメータを含めることができます。

含まれるフィールドは、encrypt_code、card_id、openid、outer_str (メンバーシップ カードのみ) です。


注: encrypt_code は暗号化コードです。Decoding インターフェイスを呼び出して、実コードコード。指定された URL が http://www.qq.com の場合、ユーザーがクリックすると、リダイレクトされる URL は次のようになります: http://www.qq.com?encrypt_code=ENCRYPT_CODE&card_id=CARDID&openid=xxxx&outer_str=xxxxx


6.5 お問い合わせください

カードとクーポンに問題が発生した場合開発中は、電子メール weixin_card@foxmail.com でお問い合わせいただけます。開発者 QQ コミュニケーション グループ 205482166 512568283 に参加することもできます。確認のため、販売者名とビジネスを必ず明記してください。


#7 カードとクーポンのデータ パッケージのダウンロード

開発者はダウンロードできますカードとクーポンのインターフェイス データ パッケージ

##-作成および署名ツール SDK;

-カードおよびバウチャー インターフェイスの呼び出しフローチャート;

- 新しいインターフェース機能の説明;

- Android 用 SDK;

- iOS 用 SDK;

ホットAIツール
Undress AI Tool
Undress AI Tool

脱衣画像を無料で

AI Clothes Remover
AI Clothes Remover

写真から衣服を削除するオンライン AI ツール。

Undresser.AI Undress
Undresser.AI Undress

リアルなヌード写真を作成する AI 搭載アプリ

Stock Market GPT
Stock Market GPT

AIを活用した投資調査により賢明な意思決定を実現

人気のツール
メモ帳++7.3.1
メモ帳++7.3.1

使いやすく無料のコードエディター

SublimeText3 中国語版
SublimeText3 中国語版

中国語版、とても使いやすい

ゼンドスタジオ 13.0.1
ゼンドスタジオ 13.0.1

強力な PHP 統合開発環境

ドリームウィーバー CS6
ドリームウィーバー CS6

ビジュアル Web 開発ツール

SublimeText3 Mac版
SublimeText3 Mac版

神レベルのコード編集ソフト(SublimeText3)

#パラメータ名 ###########################説明する###################### ##card_id

カード ID。クーポンIDはクーポンの種類に対応し、対応する在庫数のコードが含まれます。 ########################コード##################クーポンコード。カードとクーポンの一意の識別子。この文字列コードは、カードとクーポンをキャンセルするときに使用されます。販売者のカスタマイズをサポートします。

公式アカウントのユーザー名 一意身元。

##access_token

インターフェースを呼び出すための認証情報、有効期間7200 秒かかります。リクエストが更新されるたびに、get access_token インターフェイス を通じて

が取得されます。開発者はそれを適切に保存し、キャッシュ メカニズムを確立する必要があります。

jsapi_ticket

api_ticket

WeChat カードとクーポン インターフェイスを呼び出すときに署名された一時チケットは、7200 秒間有効です。

7200 秒以内に繰り返されるリクエストでは変更されません。 . API_ticket インターフェイスを取得しますGet。

card_ext

拡張可能なカードに関する追加情報。席カードとクーポンには、カードとクーポンに関する基本的な情報が含まれています。

クーポン収集チャネルのシナリオ値

ユーザーがカードを受け取ると、対応するシーン値がイベントを通じて販売者に通知されます。

,

イベントをプッシュして開発者に通知します。受信アドレスは、パブリック プラットフォーム デベロッパー センターに入力されたサーバー URL です。

#カスタム エントリ

API 経由でクーポンを作成する 販売者をサポートするカードとクーポンの詳細ページの外部リンクにジャンプするようにユニットをカスタマイズします。