| #パラメータ | 必須かどうか | 説明 |
|---|
| POST データ | は | JSON データ | です
| access_token | # は | 呼び出しインターフェイス資格情報です |
POST データ
開発者は、QR コードをスキャンして 1 つのクーポンを受け取るように設定できます。現時点では、POSTデータは: {
"action_name": "QR_CARD",
"expire_seconds": 1800,
"action_info": {
"card": {
"card_id": "pFS7Fjg8kV1IdDz01r4SQwMkuCKc",
"code": "198374613512",
"openid": "oFS7Fjl0WsZ9AMZqrI80nbIq8xrA",
"is_unique_code": false ,
"outer_str":"12b"
}
}
}
開発者が QR コードのスキャンを設定して複数のクーポンを受け取るように設定すると、POST データは次のようになります: {
"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"
}
]
}
}
}
パラメータの説明| #パラメータ名 | 必須 | タイプ | 値の例 | 説明 |
|---|
##コード| is | string(20) | ##110201201245 | カードとクーポン コード、use_custom_code フィールドが true であるカードとクーポンは入力する必要がありますが、非カスタム コードおよびインポートされたコード モードを持つカードとクーポンは入力する必要はありません。 |
| #card_id | No | string(32) | pFS7Fjg8kV1IdDz01r4SQwMkuCKc
| クーポン ID。 |
#openid | No | string(32) | oXch-jkrxp42VQu8ldweCwDt97qo | 受信者の openid を指定すると、このユーザーのみが受信できます。 bind_openid フィールドが true のカードとクーポンは入力する必要があり、指定されていない openid は入力する必要はありません。 |
| #expire_seconds | No | unsigned int | 60 | QR コードの有効時間を指定します。範囲は 60 ~ 1800 秒です。空白のままにした場合、デフォルトで 365 日間有効になります。 |
| #is_unique_code | No | bool | false | 発行するQRコードを指定します 生成されるQRコードにはランダムにコードが割り当てられます受信後に再度スキャンすることはできません。 true または false を入力します。デフォルトは false です。このフィールドに入力するときは、カードがレビューに合格する必要があり、在庫が 0 ではないことに注意してください。 |
#outer_id | No | int | 12 | 受信シーン値。受信チャネルのデータ統計に使用されます。デフォルト値は 0、フィールド タイプは整数、長さは制限されています60桁まで。このカスタム シーン値は、ユーザーがクーポンを受け取った後にトリガーされる イベント プッシュ に含まれます。
outer_str | ##No | string( 128) | 13b | outer_id フィールドのアップグレードされたバージョン、文字列タイプ、ユーザーが初めてカードを受け取ったときに、イベントはマーチャントにプッシュされます; 会員カードの QR コードについては、ユーザーがコードをスキャンして会員カードを開き、いずれかの URL をクリックするたびに、値が URL に入力されるため、開発者にとって便利です。 スキャン コードのソースを見つけます。
|
#
#
#
戻りデータ{
"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"
}
パラメータの説明| #パラメータ名 | 説明 |
|---|
| エラーコード | #エラー コード |
errmsg | エラー メッセージ |
#ticket| QRコードチケットを取得したので、このチケットを使用して | に電話し、チケットと交換してください。 QR コード インターフェース は有効期限内に QR コードと交換できます。 | #url
| QR コード画像を解析した後のアドレス。開発者は必要な QR コード画像を生成できます | | show_qrcode_url
| QR コードにはアドレスが表示されます。クリックすると QR コードのページにジャンプします | #
############################################## ##ノート# ##:
1. カスタム コードを含むクーポンの場合、生成された QR コードは一度に 1 回のみ収集できます。開発者が独自の文字列コード システムを使用したい場合は、 WeChat の QR コード
を使用したい場合は、まず カスタム コードを ; # にインポートする必要があります。 2. 複数の QR コードを受信するには、一度に最大 5 つのカード ID を入力します。入力しないとエラーが報告されます。
2 HTML5 オンラインクーポン発行 (JS-SDK インターフェース) WeChat JS - SDKはWeChatの内蔵ブラウザでの利用のみをサポートしており、他のブラウザからの呼び出しは無効です。 WeChat は、販売者がフロントエンド Web ページを呼び出して 1 つ以上のカードとクーポンをユーザーのカード パッケージに追加するための addCard インターフェイスを提供します。詳細については、カードとクーポンの一括追加インターフェイスを参照してください。 
#カードとクーポン シェルフの概要 #カードとクーポン シェルフは、開発者によるカードとクーポンのコレクション H5 の生成をサポートします。インターフェイス を呼び出してページにアクセスし、カードやクーポンを配置するアクションを実行するためのページ リンクを取得します。 現在、カードとクーポン シェルフは、非カスタム コードを持つカードとクーポンのみをサポートしています。カスタム コードを持つカードとクーポンは、最初に コード インターフェイスのインポート# を呼び出す必要があります。コードをインポートする ## は通常どおり使用できます。 
インターフェイスの説明 開発者は、カードやクーポンを配置するためのシェルフ リンクを作成するには、このインターフェイスを呼び出す必要があります。棚を作成する際、配送経路のシーン欄に記入する必要があります。 #インターフェース呼び出しリクエストの説明HTTP请求方式: POST
URL:https://api.weixin.qq.com/card/landingpage/create?access_token=$TOKEN
リクエストパラメータの説明##| #パラメータ | 必須かどうか | 説明 |
|---|
| access_token | は、 | # 呼び出し側インターフェース資格情報です | ##buffer | は # ファイル | ## のデータ ストリームです。 #
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"
}
]
}
## パラメータの説明 | #フィールド | 説明 | 必須ですか? |
|---|
| banner | ページ上のバナー画像リンクを呼び出す必要があります。推奨サイズは 640*300 です。 | は、 | | title | ページのタイトルです。 | # は | #can_share | ページを共有できるかどうか、true/falseを入力してください | is | ##scene| 配信ページ シーン値; | SCENE_NEAR_BY 近くの SCENE_MENU カスタム メニュー SCENE_QRCODE QR コード SCENE_ARTICLE パブリック アカウントの記事 SCENE_H5 h5 ページ SCENE_IVR 自動返信 SCENE_CARD_CUSTOM_CELL カード カスタム セル | は | | card_list | カードとクーポンのリストで、各項目には2 フィールド | は配置される | | card_id | ですページのcard_id | は | | thumb_url | サムネイルですURL | はい |
#
戻りデータの説明
{
"errcode":0,
"errmsg":"ok",
"url":"www.test.url",
"page_id":1
}
フィールドの説明 | #フィールド | 説明 |
|---|
| エラーコード | エラー コード。0 は正常を意味します。 | #errmsg | エラー メッセージ。 | #url| ## 棚のリンク。 | #page_id | | シェルフ ID。シェルフの一意の識別子。 |
4 グループクーポンの発行開発者の皆様へのお願い ご注意ください現在のカードとクーポンのグループ発行インターフェイスは、非カスタム コード コードを使用したカードとクーポンの発行のみをサポートしています。カスタム コードを持つ販売者がこの機能を使用したい場合は、最初にインポート コード インターフェイスを呼び出してカスタム コードを WeChat サーバーにインポートする必要があります。
#4.1 カスタム コードのインポート (カスタム コード販売者のみ)インターフェースの紹介このモジュールはカスタム コード販売者専用であり、カスタム コード以外の開発者は自動的に無視する必要があります。 開発者は、事前にカスタム コードを WeChat サーバーにインポートして、グループ配布、カスタマー サービス メッセージによるカードやクーポンの発行など、非カスタム コード販売者と同じ配信機能を取得できます。 #インポートされたコード後のカードとクーポンは、発行時の非カスタム コードのカードとクーポンと同等です ##新しく作成されたカード 開発者が、以前の作成とは異なるインポート コード モードをサポートする新しいカードを作成する予定の場合次のプロセスを使用して、事前保存されたコード モード クーポンを作成してください。作成しないと、エラーが報告されます。
#ステップ 1: 事前保存モード クーポンを作成し、在庫数量の初期値を 0 に設定し、入力します。 get_custom_code_mode フィールドで; ステップ 2: カードとクーポンがレビューに合格したら、インポート コード インターフェイスを呼び出してコードを確認します。ステップ 3: 在庫変更インターフェイスを呼び出し、カードとクーポンの在庫は、インポートされたコード番号以下である必要があります。 (混乱を避けるため、等しいに設定することをお勧めします)

新規作成されていないカード ##開発者がすでにカードとクーポンを持っていて、それを事前保存コード モードに変更したい場合は、開発者が次のプロセスに従ってカードとクーポンを更新することをお勧めします。 ステップ 1: インポート コード インターフェイスを呼び出して、一定量のカスタム コードをインポートし、コードを確認します。 ステップ 2: カード情報変更インターフェイスを呼び出して、get_custom_code_mode に入力します。 field; ステップ 3: 在庫変更インターフェイスを呼び出して、クーポン在庫数量をインポートされたコードの数と同じ数値に設定します。 
4.1.1 インポート コードの必須フィールドに入力/更新します #インターフェースの説明 カスタム コードを含むカードとクーポンは、API の作成のみをサポートします。作成するときは、必ず次のフィールドを Base_info に追加してください (詳細については、カードとクーポンのインターフェイスを作成するためのインターフェイス ドキュメント CreateCard を参照してください)。以下を追加した後でのみ指定された 2 つのフィールドでコードを呼び出すことができます。コードのインポート インターフェイス import | #フィールド | 例 | 説明 |
|---|
#base_info | | | get_custom_code_mode| #GET_CUSTOM_CODE_MODE_DEPOSIT | このフィールドに入力すると、カスタム コード クーポンをインポートしてリリースできます。 | | #use_custom_code | true | クーポンをカスタム定義に設定しますコード###############
##カード作成時の JSON 例 {
"card": {
"card_type": "GROUPON",
"groupon": {
"base_info": {
··········
"use_custom_code":true,
"get_custom_code_mode":"GET_CUSTOM_CODE_MODE_DEPOSIT",
},
"advanced_info": {
··········
},
"deal_detail": "示例"
}
}
}カード更新時の JSON 例 {
"card_id":"ph_gmt7cUVrlRk8swPwx7aDyF-pg",
"groupon": {
"base_info": {
·········
"get_custom_code_mode":"GET_CUSTOM_CODE_MODE_DEPOSIT",
·········
}
}
} 注: get_custom_code_mode を作成・更新する際は、在庫数とインポートコード数の関係を確認する必要があり、インポートコード数が在庫数に満たない場合はエラーとなります。 ##4.1.2 コード インターフェイスのインポートカスタム コード カード内クーポン ### が正常に作成され、レビュー に合格した場合、クーポン発行者と合意した番号に従ってインポート コード インターフェイスを呼び出して、カスタム コードを WeChat バックエンドにインポートする必要があります。 #インターフェースの説明 開発者はこのインターフェイスを呼び出してカスタム コードを WeChat カードとクーポン バックエンドにインポートでき、WeChat エージェントがコードを保存して発行します。 #注: 1) インターフェイスへの 1 回の呼び出しで受信するコードの数の上限は 100 です。 #2) 各コードを空の文字列にすることはできません。 #3) インポートが完了すると、システムはプロバイダーによって設定されたインベントリが実際にインポートされたコードの量と一致しているかどうかを自動的に判断します。 #4) インポートが失敗した場合、プロンプトが成功するまで繰り返しインポートがサポートされます。 #インターフェイス呼び出しリクエストの説明 HTTP请求方式: POST
URL:http://api.weixin.qq.com/card/code/deposit?access_token=ACCESS_TOKEN リクエスト パラメーターの説明 | #パラメータ | 必須かどうか | 説明 |
|---|
| access_token | は、 | # 呼び出し側インターフェース資格情報です | ##buffer | は # ファイル | ## のデータ ストリームです。 #
POST データ{
"card_id": "pDF3iY0_dVjb_Pua96MMewA96qvA",
"code": [
"11111",
"22222",
"33333",
"44444",
"55555"
]
} フィールドの説明| #フィールド | 説明 | 必須ですか? |
|---|
| card_id | コードにインポートする必要があるカード ID。 | # は | コード | # をWeChat カードとクーポン バックエンドのカスタム コード、上限は 100 です。 ############はい###############
データを返す説明{
"errcode":0,
"errmsg":"ok"
} フィールドの説明| #フィールド | 説明 |
|---|
| エラーコード | エラー コード、0 が正常です; 40109: コードの数が 100 を超えています | | errmsg # #####エラーメッセージ。 | | #succ_code | 成功数 | | duplicate_code | 重複してインポートされたコードは自動的にフィルタリングされます。 | #fail_code | | 失敗の数。 |
インターフェイスの説明 開発者がこのインターフェイスを呼び出して、WeChat バックエンドに正常にインポートされたコードの数をクエリできるようにします。 #インターフェイス呼び出しリクエストの説明HTTP请求方式: POST
URL:http://api.weixin.qq.com/card/code/getdepositcount?access_token=ACCESS_TOKEN リクエスト パラメーターの説明| #パラメータ | 必須かどうか | 説明 |
|---|
| access_token | は、 | # 呼び出し側インターフェース資格情報です |
##POST データ{
"card_id" : " pDF3iY0_dVjb_Pua96MMewA96qvA "
} フィールドの説明| #フィールド | 説明 | 必須ですか? |
|---|
| card_id | インポートされたコードのカード ID。 ############はい###############
##戻りデータの説明{
"errcode":0,
"errmsg":"ok",
"count":123
} #フィールドの説明| #フィールド | 説明 |
|---|
| エラーコード | エラー コード。0 は正常を意味します。 | #errmsg | エラー メッセージ。 | #count| 正常にデポジットされたコードの数。 | |
##4.1.4 検証コード インターフェイスインポート エラーを回避するために、開発者は次のことを強くお勧めします。コード番号をクエリするには、コード インターフェイスをチェックして、コードが WeChat バックエンドにインポートされていることを確認します。
インターフェイスの説明 開発者がこのインターフェイスを呼び出して、WeChat バックエンドへのコード インポートのステータスをクエリできるようにします。
インターフェイス呼び出しリクエストの説明HTTP请求方式: POST
URL:http://api.weixin.qq.com/card/code/checkcode?access_token=ACCESS_TOKEN 请求参数说明 | #パラメータ | 必須かどうか | 説明 |
|---|
| access_token | は、 | # 呼び出し側インターフェース資格情報です |
##POST データ{
"card_id": "pDF3iY0_dVjb_Pua96MMewA96qvA",
"code": [
"11111",
"22222",
"33333",
"44444",
"55555"
]
} フィールドの説明| #フィールド | 説明 | 必須ですか? |
|---|
| card_id | インポートされたコードのカード ID。 | は | | code | はすでに WeChat カードにありますおよびクーポン バックエンド カスタム コード、上限は 100 です。 ############はい###############
戻りデータの説明{
"errcode":0,
"errmsg":"ok"
"exist_code":["11111","22222","33333"],
"not_exist_code":["44444","55555"]
} フィールドの説明| #フィールド | 説明 |
|---|
| エラーコード | エラー コード、0 が正常です; 40109: コードの数が 100 を超えています | | errmsg # #####エラーメッセージ。 | | exist_code| 正常にデポジットされたコード。 | | #not_exist_code | 保存されたコードはありません。 |
#4.2 グラフィックメッセージによるカードとクーポンのグループ発行開発者は、このインターフェイスを呼び出して、埋め込みカードおよびクーポン メッセージの標準形式コードを取得することがサポートされています。グラフィックおよびテキスト素材インターフェイスのコンテンツ フィールドにリターン コードを入力してください。埋め込まれたカードとクーポンのグラフィック メッセージ素材を入手します。 特記事項: 現在、このインターフェイスは非カスタム コードを持つカードとクーポンのみをサポートしています。カスタム コードを持つカードとクーポンは、最初にインポートしてから呼び出す必要があります。 #インターフェイス呼び出しリクエストの説明HTTP请求方式: POST
URL:https://api.weixin.qq.com/card/mpnews/gethtml?access_token=TOKEN パラメータの説明| #パラメータ | 必須かどうか | 説明 |
|---|
| POST データ | は | JSON データ | です | access_token | # は | 呼び出しインターフェイス資格情報です |
データを投稿#{
"card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI"
}| パラメータ名 | 必須 | タイプ | ##値の例 | 説明 | ##card_id| No | string(32) | pFS7Fjg8kV1IdDz01r4SQwMkuCKc | クーポン ID。 | |
#データを返す {
"errcode":0,
"errmsg":"ok",
"content":"<iframeclass=\"res_iframecard_iframejs_editor_card\"data-src=\"http: \/\/mp.weixin.qq.com\/bizmall\/appmsgcard?action=show&biz=MjM5OTAwODk4MA%3D%3D&cardid=p1Pj9jnXTLf2nF7lccYScFUYqJ0&wechat_card_js=1#wechat_redirect\">"
}| パラメータ名 | 説明 |
|---|
| ##エラーコード | #エラー コード | errmsg| ##エラー メッセージ | | content | HTML コードの一部を返します。これは、グラフィック メッセージの本文に直接埋め込むことができます。つまり、このコードを | グラフィック メッセージ マテリアル インターフェイスのコンテンツ フィールドに埋め込むことができます。
##4.3 グループに基づいたグループ クーポン メッセージの発行 # 指定されたグループ内のユーザーへのこのインターフェイスの呼び出しをサポートします。 - カードとクーポンのメッセージを送信します。詳細については、「グループベースのグループ送信インターフェイス」を参照してください。 現在、このインターフェイスは、非カスタム コードを持つカードとクーポンのみをサポートしています。カスタム コードを持つカードとクーポンは、インポート後に呼び出されます。 4.4 OpenID リストに基づくカードおよびクーポン メッセージの大量発行 ネイティブ カードおよびクーポンの大量発行をサポートします。 OpenIDに基づいています。サブスクリプション アカウントは使用できません。認証後にサービス アカウントにはインターフェイス権限が付与されます。詳細については、「OpenID リストに基づくグループ送信インターフェイス」を参照してください。 現在、このインターフェイスは非カスタム コードを含むカードとクーポンのみをサポートしています。カスタム コードを含むカードとクーポンインポート後に呼び出されます。 4.5 カスタマー サービス メッセージによるカードの発行 開発者によるこのインターフェイスの呼び出しをサポートします。カードバウチャーを発行します。サブスクリプション アカウントは使用できませんが、サービス アカウントが認証されると使用できるようになります。詳細については、カスタマー サービス インターフェイス - メッセージの送信 を参照してください。現在、このインターフェイスでは、非カスタム コードを使用したカードとクーポンの入力のみがサポートされています。カスタム コードを使用したカードとクーポンは、最初にインポートしてから呼び出す必要があります。 開発者がこのインターフェイスを呼び出してカードやクーポンを発行できるようにサポートします。 。サブスクリプション アカウントは使用できませんが、サービス アカウントが認証されると使用できるようになります。詳細については、プレビュー インターフェイスを参照してください。 # #開発者が各チャネルのカードとクーポンの配信データをカウントしやすくするために、新しいフィールド external_str (旧 external_id) が追加されました。 card_ext の json 構造に、outer_str (元の inner_id) にさまざまな値を入力します。ユーザーがカード クーポンを受け取ると、対応する値を持つ external_id が receipt イベント# に取り込まれます。 ## そして開発者サーバーにプッシュされます。 例: QR コード配信メソッドで、outer_str を 12b に設定します。 {
"action_name": "QR_CARD",
"action_info": {
"card": {
"card_id": "pFS7Fjg8kV1IdDz01r4SQwMkuCKc",
"code": "198374613512",
"openid": "oFS7Fjl0WsZ9AMZqrI80nbIq8xrA",
"expire_seconds": "1800",
"is_unique_code": false ,
"outer_str" : "12b"
}
}
}イベント XML ファイルを受信します <xml> <ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[FromUser]]></FromUserName>
<FriendUserName><![CDATA[FriendUser]]></FriendUserName>
<CreateTime>123456789</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[user_get_card]]></Event>
<CardId><![CDATA[cardid]]></CardId>
<IsGiveByFriend>1</IsGiveByFriend>
<UserCardCode><![CDATA[12312312]]></UserCardCode>
<OuterStr>12b</OuterStr>
</xml> ##インターフェイスの説明## カードとクーポンには監査要件があるため、公式アカウントのデバッグを容易にするために、いくつかのテスト アカウントをセットアップして、審査に合格しなかったカードやクーポンを受け取り、プロセス全体を体験することができます。 #開発者向けノート #1. 「openid」と「username」の両方をサポートフィールド設定のホワイトリスト、合計数の上限は 10 です。 #2. テスト ホワイトリスト インターフェイスを完全な設定に設定します。つまり、テスト リストが変更されたときに、このインターフェイスを呼び出してすべてのテスターの ID を再入力する必要があります。 3. ホワイトリスト ユーザーは、カードを受け取るときにカードの無効なステータスを無視します。開発者は注意してください。 #インターフェイス呼び出しリクエストの説明HTTP请求方式: POST
URL:https://api.weixin.qq.com/card/testwhitelist/set?access_token=TOKEN パラメータの説明| #パラメータ | 必須かどうか | 説明 |
|---|
| access_token | は、 | # 呼び出し側インターフェース資格情報です | | POST データ | ## は Json データ | #
##POST データ{
"openid": [
"o1Pj9jmZvwSyyyyyyBa4aULW2mA",
"o1Pj9jmZvxxxxxxxxxULW2mA"
],
"username": [
"afdvvf",
"abcd"
]
} パラメータの説明| #パラメータ名 | 必須 | タイプ | 値の例 | 説明 |
|---|
##openid | No | string(20)##o1Pj9jmZvwSyyyyyyBa4aULW2mA | テストする openid のリスト。 | | #ユーザー名 | No | string(32) | eddy | テスト済みの WeChat ID リスト。 |
#返品手順
{
"errcode":0,
"errmsg":"ok"
}| パラメータ名 | 説明 |
|---|
| ##エラーコード | #エラー コード。0 は正常を意味します。 | #errmsg| エラー メッセージ。 | |
人気の記事
ホットトピック
|
|
|
|
|
|
|
|
|
|
|