tijian_tieying/web/dccdc/Common/Deepleo.Weixin.SDK/Card/ManageCardAPI.cs

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Net.Http;
using Codeplex.Data;

namespace Deepleo.Weixin.SDK.Card
{
    /// <summary>
    /// 卡券管理接口
    /// </summary>
    public class ManageCardAPI
    {
        /// <summary>
        /// 删除卡券
        /// 删除卡券接口允许商户删除任意一类卡券。删除卡券后，该卡券对应已生成的领取用二维码、添加到卡包JSAPI均会失效。
        /// 注意：如用户在商家删除卡券前已领取一张或多张该卡券依旧有效。即删除卡券不能删除已被用户领取，保存在微信客户端中的卡券。
        /// </summary>
        /// <param name="access_token"></param>
        /// <param name="card_id">卡券ID</param>
        /// <returns>{
        ///"errcode":0,
        ///"errmsg":"ok"
        ///}</returns>
        public static string DeleteCard(string access_token, string card_id)
        {
            var url = string.Format("https://api.weixin.qq.com/card/delete?access_token={0}", access_token);
            var client = new HttpClient();
            var sb = new StringBuilder();
            sb.Append("{")
                .Append('"' + "card_id" + '"' + ":").Append(card_id)
                .Append("}");
            var result = client.PostAsync(url, new StringContent(sb.ToString())).Result;
            if (result.IsSuccessStatusCode) return string.Empty;
            return DynamicJson.Parse(result.Content.ReadAsStringAsync().Result);
        }

        /// <summary>
        /// 查询code
        /// 
        /// 调用查询code接口可获取code的有效性（非自定义code），该code对应的用户openid、卡券有效期等信息。
        /// 自定义code（use_custom_code为true）的卡券调用接口时，post数据中需包含card_id，非自定义code不需上报。
        /// </summary>
        /// <param name="access_token"></param>
        /// <param name="code">要查询的序列号</param>
        /// <param name="card_id">要消耗序列号所述的card_id，生成券时use_custom_code填写true时必填。非自定义code不必填写。</param>
        /// <returns>{
        ///"errcode":0,
        ///"errmsg":"ok",
        ///"openid":"oFS7Fjl0WsZ9AMZqrI80nbIq8xrA",
        ///"card":{
        ///"card_id":"pFS7Fjg8kV1IdDz01r4SQwMkuCKc",
        ///"begin_time":1404205036,
        ///"end_time":1404205036,
        ///}
        ///}
        ///
        ///注：固定时长有效期会根据用户实际领取时间转换，如用户2013年10月1日领取，固定时长有效期为90天，即有效时间为2013年10月1日-12月29日有效。
        /// </returns>
        public static string GetCardCode(string access_token, string code, string card_id = "")
        {
            var url = string.Format("https://api.weixin.qq.com/card/get?access_token={0}", access_token);
            var client = new HttpClient();
            var sb = new StringBuilder();
            sb.Append("{")
              .Append('"' + "code" + '"' + ":").Append(code);
            if (!string.IsNullOrEmpty(card_id))
            {
                sb.Append('"' + "card_id" + '"' + ":").Append(card_id);
            }
            sb.Append("}");
            var result = client.PostAsync(url, new StringContent(sb.ToString())).Result;
            if (result.IsSuccessStatusCode) return string.Empty;
            return DynamicJson.Parse(result.Content.ReadAsStringAsync().Result);
        }

        /// <summary>
        /// 批量查询卡列表
        /// </summary>
        /// <param name="access_token"></param>
        /// <param name="offset">查询卡列表的起始偏移量，从0开始，即offset:5是指从从列表里的第六个开始读取。</param>
        /// <param name="count">需要查询的卡片的数量（数量最大50）</param>
        /// <returns>{
        /// "errcode":0,
        /// "errmsg":"ok",
        /// "card_id_list":["ph_gmt7cUVrlRk8swPwx7aDyF-pg"],
        /// "total_num":1
        /// }</returns>
        public static string BatchGetCard(string access_token, int offset, int count)
        {
            var url = string.Format("https://api.weixin.qq.com/card/batchget?access_token={0}", access_token);
            var client = new HttpClient();
            var sb = new StringBuilder();
            sb.Append("{")
              .Append('"' + "offset" + '"' + ":").Append(offset)
              .Append('"' + "count" + '"' + ":").Append(count)
              .Append("}");
            var result = client.PostAsync(url, new StringContent(sb.ToString())).Result;
            if (result.IsSuccessStatusCode) return string.Empty;
            return DynamicJson.Parse(result.Content.ReadAsStringAsync().Result);
        }

        /// <summary>
        /// 查询卡券详情
        /// </summary>
        /// <param name="access_token"></param>
        /// <param name="card_id">卡券ID</param>
        /// <returns>
        /// 返回结果示意
        ///｛"errcode":0,
        ///"errmsg":"ok",
        ///"card":{
        ///"card_type": "GROUPON",
        ///"groupon":{
        ///"base_info":{
        ///"status":1,
        ///"id":"p1Pj9jr90_SQRaVqYI239Ka1erkI",
        ///"logo_url":
        ///"http://www.supadmin.cn/uploads/allimg/120216/1_120216214725_1.jpg",
        ///"appid":"wx588def6b0089dd48",
        ///"code_type":"CODE_TYPE_TEXT",
        ///"brand_name":"海底捞",
        ///"title":"132元双人火锅套餐",
        ///"sub_title":"",
        ///"date_info":{
        ///"type":1,
        ///"begin_timestamp":1397577600,
        ///"end_timestamp":1399910400
        ///},
        ///"color":"#3373bb",
        ///"notice":"使用时向服务员出示此券",
        ///"service_phone":"020-88888888",
        ///"description":"不可与其他优惠同享\n如需团购券发票，请在消费时向商户提出\n店内均可使用，仅限堂食\n餐前不可打包，餐后未吃完，可打包\n本团购券不限人数，建议2人使用，超过建议人数须另收酱料费5元/位\n本单谢绝自带酒水饮料",
        ///     "use_limit":1,
        ///"get_limit":3,
        ///"can_share":true,
        ///"location_id_list": [123,12321,345345]
        ///"url_name_type":"URL_NAME_TYPE_RESERVATION",
        ///"custom_url":"http://www.qq.com",
        ///"source":"大众点评"
        ///"sku":{
        ///"quantity":0
        ///}
        ///},
        ///"deal_detail":"以下锅底2选1（有菌王锅、麻辣锅、大骨锅、番茄锅、清补凉锅、酸菜鱼锅可选）：\n大锅1份12元\n小锅2份16元\n以下菜品2选1\n特级肥牛1份30元\n洞庭鮰鱼卷1份20元\n其他\n鲜菇猪肉滑1份18元\n金针菇1份16元\n黑木耳1份9元\n娃娃菜1份8元\n冬瓜1份6元\n火锅面2个6元\n欢乐畅饮2位12元\n自助酱料2位10元",
        ///}
        ///}
        ///}
        ///}
        ///<returns>
        public static string GetCard(string access_token, string card_id)
        {
            var url = string.Format("https://api.weixin.qq.com/card/get?access_token={0}", access_token);
            var client = new HttpClient();
            var sb = new StringBuilder();
            sb.Append("{")
              .Append('"' + "card_id" + '"' + ":").Append(card_id)
              .Append("}");
            var result = client.PostAsync(url, new StringContent(sb.ToString())).Result;
            if (result.IsSuccessStatusCode) return string.Empty;
            return DynamicJson.Parse(result.Content.ReadAsStringAsync().Result);
        }
        /// <summary>
        /// 更改code
        /// 为确保转赠后的安全性，微信允许自定义code的商户对已下发的code进行更改。
        ///注：为避免用户疑惑，建议仅在发生转赠行为后（发生转赠后，微信会通过事件推送的方式告知商户被转赠的卡券code）对用户的code进行更改。
        /// </summary>
        /// <param name="access_token"></param>
        /// <param name="card_id">卡券ID</param>
        /// <param name="code">卡券的code编码</param>
        /// <param name="new_code">新的卡券code编码</param>
        /// <returns>
        /// {
        ///"errcode":0,
        ///"errmsg":"ok"
        ///}</returns>
        public static string UpdateCardCode(string access_token, string code, string card_id, string new_code)
        {
            var url = string.Format("https://api.weixin.qq.com/card/code/update?access_token={0}", access_token);
            var client = new HttpClient();
            var sb = new StringBuilder();
            sb.Append("{")
              .Append('"' + "code" + '"' + ":").Append(code)
              .Append('"' + "card_id" + '"' + ":").Append(card_id)
              .Append('"' + "new_code" + '"' + ":").Append(new_code)
              .Append("}");
            var result = client.PostAsync(url, new StringContent(sb.ToString())).Result;
            if (result.IsSuccessStatusCode) return string.Empty;
            return DynamicJson.Parse(result.Content.ReadAsStringAsync().Result);
        }
        /// <summary>
        /// 设置卡券失效接口
        /// 为满足改票、退款等异常情况，可调用卡券失效接口将用户的卡券设置为失效状态。
        /// 注：设置卡券失效的操作不可逆，即无法将设置为失效的卡券调回有效状态，商家须慎重调用该接口。
        /// </summary>
        /// <param name="access_token"></param>
        /// <param name="code">需要设置为失效的code</param>
        /// <param name="card_id">自定义code的卡券必填。非自定义code的卡券不填。</param>
        /// <returns>
        /// {
        ///"errcode":0,
        ///"errmsg":"ok"
        ///}
        ///</returns>
        public static string UnavailableCardCode(string access_token, string code, string card_id = "")
        {
            var url = string.Format("https://api.weixin.qq.com/card/code/unavailable?access_token={0}", access_token);
            var client = new HttpClient();
            var sb = new StringBuilder();
            sb.Append("{")
              .Append('"' + "code" + '"' + ":").Append(code);
            if (!string.IsNullOrEmpty(card_id))
            {
                sb.Append('"' + "card_id" + '"' + ":").Append(card_id);
            }
            sb.Append("}");
            var result = client.PostAsync(url, new StringContent(sb.ToString())).Result;
            if (result.IsSuccessStatusCode) return string.Empty;
            return DynamicJson.Parse(result.Content.ReadAsStringAsync().Result);
        }

        /// <summary>
        /// 查询卡券详情
        /// </summary>
        /// <param name="access_token"></param>
        /// <param name="new_card">
        /// {
        ///"card_id": "xxxxxxxxxxxxx",
        ///"member_card":{
        ///"base_info":{
        ///"logo_url":
        ///"http:\/\/www.supadmin.cn\/uploads\/allimg\/120216\/1_120216214725_1.jpg",
        ///"color":"Color010",
        ///"notice":"使用时向服务员出示此券",
        ///"service_phone":"020-88888888",
        ///"description":"不可与其他优惠同享\n如需团购券发票，请在消费时向商户提出\n店内均可使用，仅限堂食\n餐前不可打包，餐后未吃完，可打包\n本团购券不限人数，建议2人使用，超过建议人数须另收酱料费5元/位\n本单谢绝自带酒水饮料"
        ///"location_id_list": [123,12321,345345]
        ///},
        ///"bonus_cleared":"aaaaaaaaaaaaaa",
        ///"bonus_rules":"aaaaaaaaaaaaaa",
        ///"prerogative":""
        ///}
        ///}
        /// </param>
        /// <returns>
        /// {
        ///"errcode":0,
        ///"errmsg":"ok"
        ///}
        ///</returns>
        public static string UpdateCard(string access_token, dynamic new_card)
        {
            var url = string.Format("https://api.weixin.qq.com/card/update?access_token={0}", access_token);
            var client = new HttpClient();
            var result = client.PostAsync(url, new StringContent(DynamicJson.Serialize(new_card))).Result;
            if (result.IsSuccessStatusCode) return string.Empty;
            return DynamicJson.Parse(result.Content.ReadAsStringAsync().Result);
        }

        /// <summary>
        /// 库存修改接口
        /// 增减某张卡券的库存。
        /// </summary>
        /// <param name="access_token"></param>
        /// <param name="card_id">卡券ID</param>
        /// <param name="increase_stock_value">增加多少库存，可以不填或填0</param>
        /// <param name="reduce_stock_value">减少多少库存，可以不填或填0</param>
        /// <returns>
        /// {
        ///"errcode":0,
        ///"errmsg":"ok"
        ///}
        ///</returns>
        public static string ModifyCardStock(string access_token, string card_id, int increase_stock_value, int reduce_stock_value)
        {
            var url = string.Format("https://api.weixin.qq.com/card//modifystock?access_token={0}", access_token);
            var client = new HttpClient();
            var sb = new StringBuilder();
            sb.Append("{")
              .Append('"' + "card_id" + '"' + ":").Append(card_id)
             .Append('"' + "increase_stock_value" + '"' + ":").Append(increase_stock_value)
             .Append('"' + "reduce_stock_value" + '"' + ":").Append(reduce_stock_value)
             .Append("}");
            var result = client.PostAsync(url, new StringContent(sb.ToString())).Result;
            if (result.IsSuccessStatusCode) return string.Empty;
            return DynamicJson.Parse(result.Content.ReadAsStringAsync().Result);
        }

    }
}