WeChatカードの機能開発についてお話しします(3)

5106 ワード

雑談&回顧
    お正月から帰ってくることが多いので、しばらく時間が切れました.今日は早速続きます.以前はカード券の作成から配布までの基本的な流れを紹介しましたが、今日はカード券とコードの関連操作を紹介します.本論文では主にNodeJS言語の下でwechat-cardモジュールの動作方法を紹介し、他の言語開発者が参考にするために重要なところを特別に説明します.
 
カードIDリスト
    このインターフェイスは公衆番号のカード券IDを全部調べられます.注意してください.ここで取得したのはカード券のIDです.カードの情報ではなく、使い方と店舗のリストを調べるのも同じです. オフセット 和 count 二つのパラメータはリストを取得します.インターフェースは以下の通りです.
https://api.weixin.qq.com/card/batchget?access_token=TOKEN
    wechat-cardで 操作の方法は以下の通りです.
wxCard.card.getCardIdList(0, 10, function(err, ids) {
    // do something ...
});
    ここの二つのパラメータはあまり説明しません.お問い合わせの店舗リストのインターフェースの紹介を参照してください.
 
カードで調べます
    このインターフェースは通過用です. カードID カード券の詳細情報を調べるインターフェイスは、上記のカード券IDリストを取得するインターフェースと組み合わせて、すべてのカード券の情報を取得することができます.インターフェースは以下の通りです
https://api.weixin.qq.com/card/get?access_token=TOKEN    
    通過する wechat-card カード券の取得方法は以下の通りです.
//     id   demo,       
var cardId = "p1Pj9jr90_SQRaVqYI239Ka1erkI";

wxCard.card.getCardDetail(cardId, function(err, card) {
    // do something ...
});
    インターフェイスから戻ってきたデータはドキュメントを参照することができます.カード券を追加した時のカード券の情報です.
 
カードの修正
    このインターフェースはカード情報を修正するために使われています.もちろんすべての情報ではなく、一部のどうでもいい情報です.多くのキー情報は修正できません.インターフェースは以下の通りです
https://api.weixin.qq.com/card/update?access_token=TOKEN
    はい、 wechat-card カード券の修正方法は以下の通りです.
//    cardid   demo,      
var card = {
    card_id: "p1Pj9jr90_SQRaVqYI239Ka1erkI",
    base_info: {
      // .. some of base info
    },
    special_info: {
      // ...
    }
};

wxCard.card.modifyCard(card, function(err) {
    // do something ...
});
    注意すべき問題は:
    1.修正時にはパラメータの対象を渡す必要があります.修正するカード券を含むカードカードid,base_info、とspecial_info、もちろんここです.infoとspecial_infoで変更できるフィールドは非常に少ないです.具体的にどのフィールドが変更できますか?また、カード券の修正後、すでに発行されたカード券も変更されます.また、いくつかのフィールドを修正した後、すでに審査されたカード券は再審査待ち状態になります.審査に失敗したカード券は再審査されません.具体的にどのフィールドが再審査できますか?公式文書を参照してください.
    2.WeChatインターフェースにはすべての照会インターフェースがキャッシュされていますので、一定の確率でカード券の修正が成功したらすぐに照会します.キャッシュが更新されていない可能性があります.照会したデータが変化していないので、WeChatで最適化します.
    3.カード券の有効期限を変更する時、注意する必要があるのは、修正の時間範囲は元の時間範囲より小さくてはいけません.例えば、現在のカード券の有効期限は2015-03-12です.修正の日付は2015-3-12以降でなければなりません.
 
カード券を削除します
    このインターフェイスはカードIDで作成したカード券を削除できます.インターフェースは以下の通りです.
https://api.weixin.qq.com/card/delete?access_token=TOKEN
    使用 wechat-card カード券の削除方法は以下の通りです.
//    cardid   demo,      
var cardId = "p1Pj9jr90_SQRaVqYI239Ka1erkI";

wxCard.card.deleteCard(cardId, function(err) {
    // do something ..
});
    カード券を削除しても、すでに受け取ったコードは有効です.コードを消して消します.
 
コードの照会
    Codeインターフェースを検索すると、codeで対応するカード券のカードID、codeユーザーのopenid、およびカードの有効期限を調べることができます.ここで変なのはコードがない状態です.ここではWeChatが後でサポートされることを期待しています.
    インターフェース:
https://api.weixin.qq.com/card/code/get?access_token=TOKEN
    はい、 wechat-card でコードを検索する方法は以下の通りです.
//    code   demo,      
var code = "882077290937";

wxCard.code.getCodeDetail(code, function(err, details) {
    // details:  Object       openid,  id       
});
  
コードの修正
    このインターフェースは受け取ったCodeの値を修正するために使われます.
    このインターフェースは、カード券がカスタムSNの場合、カード券の転送が許可された場合、カード券を友達に贈呈した後、コードの安全性を保証するために、このコードの値を修正する必要があります.転送後にイベントのプッシュを受けることをおすすめします.
    インターフェース:
https://api.weixin.qq.com/card/code/update?access_token=TOKEN
    はい、 wechat-card にコードを修正する方法は、元のコード、対応するカード券ID、および新しいコードを渡すことです.
//      id code   demo,      
var code = "882077290937";
var cardId = "p1Pj9jr90_SQRaVqYI239Ka1erkI";
var newcode = "883920048827";

wxCard.code.modifyCode(code, cardId, newcode, function(err) {
    // do something ...
});
  
Codeの設定が無効になります
    このインターフェイスはすでに受け取ったカード券をCodeで無効にすることができます.インターフェース:
https://api.weixin.qq.com/card/code/unavailable?access_token=TOKEN
    はい、 wechat-card でコードの無効を設定する方法は、
//    code   demo,      
var code = "882077290937";

wxCard.code.setCodeExpire(code, function(err) {
    // do something ...
});
  
カードの在庫を修正します
    このインターフェースはカード券の在庫を補充したり、在庫を減らしたりします.カードの在庫はカード券を作る時に使います. base_info.sky.quantity フィールド.このフィールドはカード券の修正ができません.別のインターフェースで修正が必要です.インターフェースは以下の通りです.
https://api.weixin.qq.com/card/modifystock?access_token=TOKEN
    はい、 wechat-card の中でカードの在庫を修正する方法は、呼び出し方法の2番目のパラメータは10個を追加して、たとえば20個を減らして、-20です.
//    cardid   demo,      
var cardId = "p1Pj9jr90_SQRaVqYI239Ka1erkI";

//   10  
wxCard.card.modifyCardStock(cardId, -10, function(err) {
   // do something ...
});

//   10  
wxCard.card.modifyCardStock(cardId, 10, function(err) {
    // do something ...
});
 
締め括りをつける
    今日は先にここに紹介します.この内容は少し多いですが、操作は簡単です.注意すべきところもあります.最近多くの友達がメールで質問していますが、これからは私達自身が開発してきた問題についてまとめてみます.皆さんは他の問題と提案があれば、駅構内の手紙を出して一緒に討論することができます.ありがとうございます
 
転載は出所、元のページを明記してください.http://www.cnblogs.com/kenticny/p/4324963.html
転載先:https://www.cnblogs.com/kenticny/p/4324963.html