Antara muka kad dan kupon WeChat


1 》Dua bab untuk belajar tentang kaedah panggilan asas antara muka platform awam WeChat, spesifikasi pembangun dan pengendalian masalah luar biasa semasa proses panggilan.

2 ujian. Anda boleh log masuk ke aplikasi akaun ujian antara mukadan imbas melalui WeChat untuk mendapatkan aplikasi baharu(anda sudah mempunyai kebenaran untuk membuat kad dan kupon, termasuk kupon rakan)dan appecret digunakan untuk memanggil kad dan antara muka kupon.


Nota: Kupon yang dibuat oleh apl ini tidak akan disemak dan diluluskan Ia terhad kepada ujian berskala kecil dan tidak boleh digunakan oleh pembangun untuk tujuan lain.


3 Kad dan Baucar HelloWorld

Pembangun boleh menggunakan alat nyahpepijat untuk menyelesaikan proses mencipta, meletakkan dan membatalkan kad yang lebih mendalam kad dan antara muka kupon, , anda perlu membaca bahagian dokumen yang sepadan dengan terperinci.


Langkah 1 Dapatkan access_token


Alamat halaman: http://mp.weixin.qq.com/debug/

Jenis antara muka: Sokongan asas

Senarai antara muka: Dapatkan antara muka pengisian_token akses

appid dan rahsia pengguna

Klik untuk menyemak masalah dan anda boleh kembali ke access_token Akses_token sah selama dua jam dan mesti diperolehi semula selepas dua jam


danLangkah 2 Muat naik kad. logo kupon


🎜🎜

Alamat halaman: http://mp.weixin.qq.com/debug/

Jenis antara muka: Sokongan asas

Senarai antara muka: Muat naik antara muka bahan gambar

yang boleh diakses

langkah sebelumnya access_token

buffer: gambar yang anda pilih

Klik untuk menyemak soalan dan anda boleh mendapatkan url gambar Dalam langkah seterusnya, anda perlu membuat kupon dalam parameter

.

Langkah 3 Buat kupon

🎜🎜🎜🎜

Alamat halaman: http://mp.weixin.qq.com/debug/

Jenis antara muka: Antara muka kad

Senarai antara muka: Cipta antara muka kad

ken

Akses Pertama

Akses Pertama:

Contoh JSON yang diperolehi dalam langkah pertama:

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

Nota: date_info menggunakan cap waktu Unix Berhati-hati untuk menukar begin_timestamp menjadi lebih kecil daripada masa semasa dan end_timestamp kepada masa selepas hari ini supaya kad boleh. dibatalkan kemudian. Ujian kupon boleh berjaya

Alamat antara muka:

Buat antara muka kad dan kupon

🎜🎜Langkah 4 Buat penghantaran kod QR muka muka senarai: Cipta antara muka tiket kod QR

access_token: access_token diperolehi dalam langkah pertama


JSON contoh:

{
"action_name": "QR_CARD", 
"action_info": {
"card": {
"card_id": "po_2DjgJ2zrboM6SzK3qNuje5iWQ", 
   }
 }
}
Alamat antara muka: Buat antara muka kod QR

Langkah 5 Paparkan kod QR


Klik pautan dalam medan show_qrcode_url apabila kembali dari langkah sebelumnya untuk memaparkan kod QR kupon.

Contoh: https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=gQEr8ToAAAAAAAAAASxodHRwOi8vd2V********NjRjVuAAIE3kqwVQ=🜎 imbas, Kemudian terima kupon. Jika ia menunjukkan bahawa kupon tidak lulus semakan, anda perlu menyediakan senarai putih ujian dalam langkah seterusnya. Jika anda boleh menerimanya, abaikan langkah keenam.

Anda boleh mengimbas kod QR berikut untuk mengalami kupon WeChat:

Langkah 6 Sediakan senarai putih ujian


Alamat halaman: http://mp.weixin.qq.com/debug/

antara muka kad

Senarai antara muka: Sediakan antara muka senarai putih ujian

access_token: Token_akses yang diperolehi dalam langkah pertama


Contoh JSON:

{ "username":["usr1","usr2"] }

Nota: di mana kad Weceiving sur2 adalah

Alamat antara muka:

Tetapkan antara muka senarai putih


Langkah 7 Pengesahan Baucar Kad


Alamat halaman: Alamat halaman:

Jenis antara muka: Kad Kupon Interface

Interface Senarai: Kupon Kad Pengesahan Interface

Access_Token: Access_token diperolehi dalam Langkah Pertama Contoh:


{ "code":"759733467744" }
enote: Hanya menyokong kelulusan dan dalam Kad Tempoh Kesahihan alamat antara muka kupon:

Antara muka pengesahan


4 Gambaran keseluruhan antara muka kad dan kupon


Kad WeChat dan antara muka kupon terutamanya menyediakan satu siri antara muka, pengumpulan dan pengesahan di sekeliling kod. Pembangun boleh mengikuti Pilih antara muka yang sesuai untuk kesan yang anda ingin capai

untuk membangun untuk mencapai aplikasi kad dan kupon unik dalam industri.


5 Pengenalan kepada istilah kad dan kupon


Yang berikut adalah konsep utama yang anda perlukan semasa pembangunan kad:


Event push

Nama parameter

kad_id

kad ID. ID kupon sepadan dengan jenis kupon dan mengandungi kod kuantiti inventori yang sepadan.

kod

Kod Kupon. Pengecam unik kad dan kupon Kod rentetan ini digunakan semasa membatalkan kad dan kupon. Ia menyokong penyesuaian pedagang.

openid

Identiti unik pengguna di bawah akaun rasmi ini. . Pemaju perlu menyimpan dengan betul dan buat mekanisme cache.

jsapi_ticket

Tiket tandatangan yang perlu digunakan untuk memanggil antara muka JS-SDK yang memanggil fungsi asli WeChat pada halaman web WeChat, lihat bahagian JS-SDK

api_ticket

Tiket sementara yang ditandatangani semasa menghubungi kad WeChat dan antara muka kupon adalah sah untuk 7200s. Ia kekal tidak berubah untuk permintaan berulang dalam tempoh

7200s Dapatkan antara muka api_ticket.

card_ext

Maklumat tambahan kad yang boleh dikembangkan, yang digunakan untuk meletakkan kad dan kupon serta disertakan dengan maklumat asas kad.

outer_id

Nilai adegan saluran kupon kupon

. Ia menyokong pedagang untuk mengisi nilai adegan tersuai ke dalam card_ext untuk mengeluarkan kad dan kupon Apabila pengguna menerima kad, nilai adegan yang sepadan akan dimaklumkan kepada pedagang melalui acara.

Apabila

kad lulus semakan, kad diterima, kad dipadamkan, atau kad dihapuskan

Acara akan ditolak untuk memberitahu pembangun, dan alamat penerima ialah URL pelayan yang diisi di pusat pembangun platform awam.

Pintu masuk tersuai

Mencipta kad dan kupon melalui API menyokong halaman butiran kad dan kupon tersuai pedagang untuk melompat ke unit pautan luaran.


6 Nota Pembangun


6.1 WeChat versi penilaian topi Modul fungsi kad dan kupon hanya disokong selepas versi 6.0.2 . Rendah Adalah tidak sah untuk pengguna versi memanggil JS-SDK. Oleh itu, pasukan WeChat mengesyorkan agar pedagang menggunakan ejen pengguna untuk menentukan nombor versi semasa pengguna sebelum memanggil antara muka JS-SDK ditambahkan pada pakej kad. Mengambil versi iPhone sebagai contoh, anda boleh mendapatkan maklumat sampel versi berikut melalui ejen pengguna:
"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 "

di mana 6.0.2 ialah nombor versi WeChat yang dipasang oleh pengguna. Pedagang boleh menentukan sama ada nombor versi lebih tinggi daripada atau sama dengan 6.0.2.

6.2 Sekatan penempatan kad dan kupon

Hanya kad dan kupon di bawah nama domain akaun rasmi disokong dalam persekitaran sesi akaun rasmi. Menolak kupon daripada pedagang lain dalam sesi akaun awam tidak disokong tanpa kebenaran platform Jika tidak, pengguna akan digesa apabila menerima kupon: "Tidak boleh disiarkan tanpa kebenaran daripada pedagang kupon". Tiada sekatan sedemikian di luar perbualan akaun awam (seperti Detik dan persekitaran perbualan).

Nota

Tindakan yang berlaku dalam kotak dialog akaun awam dan pautan web yang melompat dari kotak dialog akaun awam berada dalam persekitaran sesi akaun awam.


6.3 Peraturan pengekodan

Semua data yang DIPOSKAN oleh antara muka API hanya menyokong pengekodan UTF-8, jika tidak, ralat akan dikembalikan.


6.4 Lompat Parameter Pautan Luar Keterangan

malam Perintah untuk memenuhi keperluan pengembangan peniaga berdasarkan kad dan kupon itu sendiri, lompatan url dibenarkan untuk ditambahkan pada halaman dalam kad dan pautan luar.

Pautan luaran yang kad dan kupon lompat keluar boleh membawa parameter kad dan maklumat kupon, yang digunakan oleh pembangun untuk mengesahkan identiti pengguna pada halaman.

Medan yang disertakan ialah encrypt_code, card_id, openid, outer_str (kad keahlian sahaja).


Nota: encrypt_code ialah kod yang disulitkan, anda perlu memanggil menyahkod antara muka untuk mendapatkan kod sebenar. Jika url yang dinyatakan ialah http://www.qq.com, apabila pengguna mengklik, url yang diubah hala ialah: http://www.qq.com?encrypt_code=ENCRYPT_CODE&card_id=CARDID&openid=xxxx&outer_str=xxxxx


6.5 Hubungi kami

Jika anda menghadapi masalah dengan pembangunan kad dan kupon, anda boleh menghubungi kami melalui e-mel weixin_card@foxmail.com. Anda juga boleh menyertai kumpulan komunikasi QQ pembangun 205482166 512568283. Sila pastikan anda menunjukkan nama pedagang dan perniagaan untuk pengesahan.


7 Muat turun pakej maklumat kad dan kupon

Pemaju boleh memuat turun pakej maklumat antara muka kad dan kupon:


;

Alat Penciptaan SD Kad dan kupon proses panggilan antara muka Gambar;