C#—ASP.NET:集成极光推送（Push API v3）

1、极光推送官网（https://www.jpush.cn/）申请一个账号。

2、服务中心，开发者服务中，创建一个新的应用，输入正确的Android的包名

3、获取到了一个AppKey 和一个 Master Secret，这两个参数比较重要，验证权限使用。

4、去官网找到下载C# SDK的包https://docs.jiguang.cn/jpush/resources/

     Github 源码:https://github.com/jpush/jpush-api-csharp-client

5、源码生成DLL

6、项目引用DLL,新建类 using Jiguang.JPush.Model;

7、代码封装HTTP 调用官方API,转载地址为pohreb博客:https://www.cnblogs.com/yangwujun/p/5973120.html

/// 极光推送的最新版：PUSH-API-V3

1. #region 基础方法
2. /// <summary>
3. /// 应用标识：极光推送的用户名
4. /// </summary>
5. private const string AppKey = "填写你应用的AppKey";
6. /// <summary>
7. /// 极光推送的密码
8. /// </summary>
9. private const string MasterSecret = "填写你的MasterSecret";
10. ///// <summary>
11. ///// 极光推送请求的url地址
12. ///// </summary>
13. private const string RequestUrl = "https://api.jpush.cn/v3/push";
14. //private const string RequestUrl = "https://bjapi.push.jiguang.cn/v3/push";
15. /// <summary>
16. /// 查询推送结果请求的Url地址
17. /// </summary>
18. private const string ReceivedUrl = "https://report.jpush.cn/v3/received";
19. /// <summary>
20. /// 发送推送请求到JPush，使用HttpWebRequest
21. /// </summary>
22. /// <param name="method">传入POST或GET</param>
23. /// <param name="url">固定地址</param>
24. /// <param name="auth">用户名AppKey和密码MasterSecret形成的Base64字符串</param>
25. /// <param name="reqParams">请求的json参数，一般由Platform(平台)、Audience(设备对象标识)、Notification(通知)、Message(自定义消息)、Options(推送可选项)组成</param>
26. /// <returns></returns>
27. private static string SendRequest(String method, String url, String auth, String reqParams)
28. {
29. string resultJson = "";
30. HttpWebRequest myReq = null;
31. HttpWebResponse response = null;
32. try
33. {
34. myReq = (HttpWebRequest)WebRequest.Create(url);
35. myReq.Method = method;
36. myReq.ContentType = "application/json";
37. if (!String.IsNullOrEmpty(auth))
38. {
39. myReq.Headers.Add("Authorization", "Basic " + auth);
40. }
41. if (method == "POST")
42. {
43. byte[] bs = UTF8Encoding.UTF8.GetBytes(reqParams);
44. myReq.ContentLength = bs.Length;
45. using (Stream reqStream = myReq.GetRequestStream())
46. {
47. reqStream.Write(bs, 0, bs.Length);
48. reqStream.Close();
49. }
50. }
51. response = (HttpWebResponse)myReq.GetResponse();
52. HttpStatusCode statusCode = response.StatusCode;
53. if (Equals(response.StatusCode, HttpStatusCode.OK))
54. {
55. using (StreamReader reader = new StreamReader(response.GetResponseStream(), System.Text.Encoding.UTF8))
56. {
57. resultJson = reader.ReadToEnd();
58. try
59. {
60. object json = Newtonsoft.Json.JsonConvert.DeserializeObject(resultJson);
61. }
62. catch
63. {
64. resultJson = string.Format("{{\"error\": {{\"message\": \"{0}\", \"code\": 10086}}}}", "响应的结果不是正确的json格式");
65. }
66. }
67. }
68. }
69. catch (WebException ex)
70. {
71. if (ex.Status == WebExceptionStatus.ProtocolError)
72. {
73. HttpStatusCode errorCode = ((HttpWebResponse)ex.Response).StatusCode;
74. string statusDescription = ((HttpWebResponse)ex.Response).StatusDescription;
75. using (StreamReader sr = new StreamReader(((HttpWebResponse)ex.Response).GetResponseStream(), System.Text.Encoding.UTF8))
76. {
77. resultJson = sr.ReadToEnd();
78. //{"errcode":404,"errmsg":"request api doesn't exist"}
79. Dictionary<string, object> dict = JsonToDictionary(resultJson);
80. string errCode = "10086";
81. string errMsg = "发送推送的请求地址不存在或无法连接";
82. if (dict.ContainsKey("errcode"))
83. {
84. errCode = dict["errcode"].ToString();
85. }
86. if (dict.ContainsKey("errmsg"))
87. {
88. errMsg = dict["errmsg"].ToString();
89. }
90. resultJson = string.Format("{{\"error\": {{\"message\": \"{0}\", \"code\": {1}}}}}", errMsg, errCode);
91. }
92. }
93. else
94. {
95. //这里一定是error作为键名（自定义错误号10086），和极光推送失败时的json格式保持一致 如 {"error": {"message": "Missing parameter", "code": 1002}}
96. resultJson = string.Format("{{\"error\": {{\"message\": \"{0}\", \"code\": 10086}}}}", ex.Message.Replace("\"", " ").Replace("'", " "));
97. }
98. }
99. catch (System.Exception ex)
100. {
101. resultJson = string.Format("{{\"error\": {{\"message\": \"{0}\", \"code\": 10086}}}}", ex.Message.Replace("\"", " ").Replace("'", " "));
102. }
103. finally
104. {
105. if (response != null)
106. {
107. response.Close();
108. }
109. if (myReq != null)
110. {
111. myReq.Abort();
112. }
113. }
114. return resultJson;
115. }
116. /// <summary>
117. /// 通过用户名AppKey和密码获取验证码
118. /// </summary>
119. /// <returns></returns>
120. private static string GetBase64Auth()
121. {
122. string str = AppKey + ":" + MasterSecret;
123. byte[] bytes = Encoding.Default.GetBytes(str);
124. return Convert.ToBase64String(bytes);
125. }
126. /// <summary>
127. /// 发送推送请求到JPush
128. /// </summary>
129. /// <param name="method">POST或GET</param>
130. /// <param name="reqParams">请求的json参数，一般由Platform(平台)、Audience(设备对象标识)、Notification(通知)、Message(自定义消息)、Options(推送可选项)组成</param>
131. /// <returns></returns>
132. public static string SendRequest(String method, String reqParams)
133. {
134. string auth = GetBase64Auth();
135. return SendRequest(method, RequestUrl, auth, reqParams);
136. }
137. /// <summary>
138. /// 发送Post请求
139. /// </summary>
140. /// <param name="reqParams">请求的json参数，一般由Platform(平台)、Audience(设备对象标识)、Notification(通知)、Message(自定义消息)、Options(推送可选项)组成</param>
141. /// <returns></returns>
142. public static string SendPostRequest(String reqParams)
143. {
144. string auth = GetBase64Auth();
145. return SendRequest("POST", RequestUrl, auth, reqParams);
146. }
147. /// <summary>
148. /// 发送Get请求
149. /// </summary>
150. /// <param name="reqParams">请求的json参数，一般由Platform(平台)、Audience(设备对象标识)、Notification(通知)、Message(自定义消息)、Options(推送可选项)组成</param>
151. /// <returns></returns>
152. public static string SendGetRequest(String reqParams)
153. {
154. string auth = GetBase64Auth();
155. return SendRequest("GET", RequestUrl, auth, reqParams);
156. }
157. /*
158. * 生成唯一的sendNo的方法： 取序列号
159. * 查看返回结果的方法
160. */
161. /// <summary>
162. /// 查询推送的结果
163. /// </summary>
164. /// <param name="msg_ids">生成的json信息唯一id</param>
165. /// <returns></returns>
166. public static string GetReceivedResult(String msg_ids)
167. {
168. string url = ReceivedUrl + "?msg_ids=" + msg_ids;
169. String auth = GetBase64Auth();
170. return SendRequest("GET", url, auth, null);
171. }
172. /*
173. * 1.正确时返回结果{"sendno":"123456","msg_id":"1799597405"}
174. * 或者 {"sendno":"0","msg_id":"351403900"}
175. * 2.入参json完全正确，但找不到要到达的设备。错误时：返回
176. * {"msg_id": 3125719446, "error": {"message": "cannot find user by this audience", "code": 1011}}
177. * 3.传入空字符串 或者 非json格式，或者没有必须的选项：{"error": {"message": "Missing parameter", "code": 1002}}
178. * 传入的键（键区分大小写）、值不符合要求 {"error": {"message": "Audience value must be JSON Array format!", "code": 1003}}
179. */
180. /// <summary>
181. /// 将返回的json转换为Hashtable对象
182. /// </summary>
183. /// <param name="jsonString"></param>
184. /// <returns></returns>
185. public static Hashtable JsonToHashtable(string jsonString)
186. {
187. /*
188. * 正确时返回结果{"sendno":"123456","msg_id":"1799597405"}
189. * {"sendno":"0","msg_id":"351403900"}
190. * 入参json完全正确，但找不到要到达的设备。错误时：返回 {"msg_id": 3125719446, "error": {"message": "cannot find user by this audience", "code": 1011}}
191. * 传入空字符串 或者 非json格式，或者没有必须的选项：{"error": {"message": "Missing parameter", "code": 1002}}
192. * 传入的键值不符合要求 {"error": {"message": "Audience value must be JSON Array format!", "code": 1003}} 键区分大小写
193. */
194. Hashtable ht = new Hashtable();
195. object json = Newtonsoft.Json.JsonConvert.DeserializeObject(jsonString);
196. //返回的结果一定是一个json对象
197. Newtonsoft.Json.Linq.JObject jsonObject = json as Newtonsoft.Json.Linq.JObject;
198. if (jsonObject == null)
199. {
200. return ht;
201. }
202. foreach (Newtonsoft.Json.Linq.JProperty jProperty in jsonObject.Properties())
203. {
204. Newtonsoft.Json.Linq.JToken jToken = jProperty.Value;
205. string value = "";
206. if (jToken != null)
207. {
208. value = jToken.ToString();
209. }
210. ht.Add(jProperty.Name, value);
211. }
212. return ht;
213. }
214. /// <summary>
215. /// 根据json返回的结果判断是否推送成功
216. /// </summary>
217. /// <param name="jsonString">响应的json</param>
218. /// <param name="errorMessage">错误信息</param>
219. /// <param name="errorCode">错误号</param>
220. /// <returns></returns>
221. public static bool IsSuccess(string jsonString, out string errorMessage, out string errorCode)
222. {
223. Hashtable ht = JsonToHashtable(jsonString);
224. errorMessage = "";
225. errorCode = "";
226. foreach (string key in ht.Keys)
227. {
228. //如果存在error键,说明推送出错
229. if (key == "error")
230. {
231. string errJson = ht[key].ToString();
232. Hashtable htError = JsonToHashtable(errJson);
233. errorMessage = htError["message"].ToString();
234. errorCode = htError["code"].ToString();
235. return false;
236. }
237. }
238. return true;
239. }
240. /// <summary>
241. /// 根据返回的响应json来判断推送是否成功，成功时记录sendno与msg_id。
242. /// 失败时记录错误信息errorMessage、错误号errCode等
243. /// </summary>
244. /// <param name="jsonString">响应的json</param>
245. /// <param name="errorMessage">错误信息</param>
246. /// <param name="errorCode">错误号</param>
247. /// <param name="sendno">用户自定义的推送编号（从序列号中获取），不设置则为0，成功后返回该编号</param>
248. /// <param name="msg_id">极光服务器处理后返回的信息编号</param>
249. /// <returns></returns>
250. public static bool IsSuccess(string jsonString, out string errorMessage, out string errorCode, out string sendno, out string msg_id)
251. {
252. bool result = IsSuccess(jsonString, out errorMessage, out errorCode);
253. Hashtable ht = JsonToHashtable(jsonString);
254. sendno = "";
255. msg_id = "";
256. if (result) //推送成功时，只有键sendno、msg_id
257. {
258. sendno = ht["sendno"].ToString();
259. msg_id = ht["msg_id"].ToString();
260. }
261. else //如果失败时存在msg_id键，则记录msg_id的值
262. {
263. if (ht.ContainsKey("msg_id"))
264. {
265. msg_id = ht["msg_id"].ToString();
266. }
267. }
268. return result;
269. }
270. /// <summary>
271. /// 将返回的json转换为字典Dictionary对象
272. /// </summary>
273. /// <param name="jsonString"></param>
274. /// <returns></returns>
275. public static Dictionary<string, object> JsonToDictionary(string jsonString)
276. {
277. Dictionary<string, object> ht = new Dictionary<string, object>();
278. object json = Newtonsoft.Json.JsonConvert.DeserializeObject(jsonString);
279. //返回的结果一定是一个json对象
280. Newtonsoft.Json.Linq.JObject jsonObject = json as Newtonsoft.Json.Linq.JObject;
281. if (jsonObject == null)
282. {
283. return ht;
284. }
285. foreach (Newtonsoft.Json.Linq.JProperty jProperty in jsonObject.Properties())
286. {
287. Newtonsoft.Json.Linq.JToken jToken = jProperty.Value;
288. string value = "";
289. if (jToken != null)
290. {
291. value = jToken.ToString();
292. }
293. ht.Add(jProperty.Name, value);
294. }
295. return ht;
296. }
297. #endregion

8、其中我们主要使用registration_id的方式推送，也就是通过APP上的用户Token推送。

新增两个实体类一个存储APP用户Token，以及设备平台(安卓,苹果)，一个存储推送记录，其实极光官网也有推送记录。

因为需要推送多个用户情况，新添List存储registration_id

新建返回对象存储返回信息

扩展方法使用，根据文档实现JSON格式并调用基本方法实现推送https://docs.jiguang.cn/jpush/server/push/rest_api_v3_push/

/// <summary>

1. /// </summary>
2. /// <param name="RegistrationIDList">推送TokenID集合</param>
3. /// <param name="title">标题</param>
4. /// <param name="senduser">作者</param>
5. /// <param name="toid">推送对象ID</param>
6. /// <param name="contype">推送对象</param>
7. /// <param name="dataid"></param>
8. /// <param name="strMsg">推送内容</param>
9. /// <param name="is_production"></param>
10. /// <param name="strLog">返回日志</param>
11. /// <returns></returns>
12. public static bool SendPushV2(List<string> RegistrationIDList, string title, string senduser, string toid,int contype,string dataid, string strMsg, bool is_production, out string strLog)
13. {
14. try
15. {
16. var parmARR = new Dictionary<string, object>();
17. parmARR.Add("dataid", dataid);
18. var mm = new M_PushRegistration();
19. mm.registration_id = RegistrationIDList;
20. //生成JSON格式参数
21. PushPayload pushPayload = new PushPayload()
22. {
23. Platform = new List<string> { "android", "ios" },//推送平台
24. Audience = mm,//推送对象
25. Notification = new Notification
26. {
27. Alert = strMsg,
28. Android = new Android
29. {
30. Alert = strMsg,
31. Title = "你的标题",
32. Extras = parmARR
33. },
34. IOS = new IOS
35. {
36. Alert = strMsg,
37. Badge = "+1",
38. Extras = parmARR
39. }
40. },
41. Options = new Options
42. {
43. IsApnsProduction = true // 设置 iOS 推送生产环境。不设置默认为开发环境。
44. }
45. };
46. var strParms = pushPayload.Exp_ModelToJson();
47. strParms.WriteFile("log/push");
48. var result = JPushHelperV3.SendPostRequest(strParms);
49. var retM = result.Exp_JsonToModel<M_PushReturn>(1);
50. strLog = "";
51. strLog += "result=" + result + "&&retModel=" + retM.Exp_ModelToJson();
52. strLog.WriteFile("log/push");
53. if (retM.error == null)
54. {
55. //保存推送信息
56. string[] teacherArr = toid.Split(',');
57. for (int i = 0; i < teacherArr.Length; i++)
58. {
59. D_T_PushMsg_Exp pushmsgDal = new D_T_PushMsg_Exp();
60. M_T_PushMsg pushmsgModel = new M_T_PushMsg();
61. pushmsgModel.Title = title;
62. pushmsgModel.MsgAuthor = senduser;
63. pushmsgModel.MsgContent = strMsg;
64. pushmsgModel.Flag = true;
65. pushmsgModel.IsRead = false;
66. pushmsgModel.IsSend = true;
67. pushmsgModel.Contype = contype;
68. pushmsgModel.Remark1 = teacherArr[i].Exp_IntTryParse(); //发送给谁
69. pushmsgModel.AddTime = DateTime.Now;
70. pushmsgModel.SendTime = DateTime.Now;
71. pushmsgModel.Remark2 = "";
72. pushmsgModel.Remark3 = false;
73. pushmsgDal.Admin_Add(pushmsgModel);
74. }
75. strLog = "向设备推送消息成功\r\n请求参数=" + strParms + "\r\n";
76. return

    鲜花

    握手

    雷人

    路过

    鸡蛋
    该文章已有0人参与评论

    请发表评论

    评论

    全部评论