多說評論系統API調用和本地身份說明(JWT)

多說評論系統是一個非常好用的第三方評論插件，聚合了大多數的SNS平台賬號登錄和分享功能，UI也很不錯。

作為網站快速接入評論系統，多說是一個比較好的選擇，其也提供了一些實用的API去滿足定制化需求。

多說API支持將本地的用戶基本信息同步到多說服務器，實現了本地用戶系統和多說用戶驗證機制的一致。

大概的過程：在用戶注冊或者修改個人信息的時候將用戶信息同步至多說服務器，並在用戶登錄后在本地cookie寫入JWT值，多說可以進行判斷而實現用戶無需再登錄多說系統就可以進行評論。

Array參數注意點

在使用多說同步用戶信息API時，用戶的信息users參數的類型為array，這里需要特別注意其格式處理。

不過還是推薦多說團隊使用json作為參數格式或者使用新浪微博的處理方式：參數類型為string，多個參數使用逗號分隔，開發者的處理成本會小很多。

具體的參數格式為：users[0][user_key]=1&users[0][name]=parry&....

這個具體的正確格式嘗試了很多種方式后，在看到原始的ASP處理方式時才知道，謝謝多說技術人員小武的耐心解答（QQ：1175762238）。

他給的asp源碼在這里。

兩個輔助函數

順手整理出了兩個方法：POST數據到多說的API接口和設置多說本地身份說明(JWT)。

注意：在POST數據到多說的API接口方法中只處理了一個arrayPostData的情況，多個數組的形式請自行修改。

項目名稱就叫DuoShuo.SDK.Partial了，希望更多的人來完善SDK。

有可以優化的地方請多指教。

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Net;
using System.Web;

namespace DuoShuo.SDK.Partial
{
    /// <summary>
    /// 多說POST請求的幫助類，主要解釋了array參數的拼接格式和JWT的設置
    /// </summary>
    /// <author>
    /// Parry
    /// Mail: [e-mail]
    /// Blog: http://www.cnblogs.com/parry
    /// </author>
    public class DuoShuoHelper
    {
        #region POST數據

        /// <summary>
        /// POST數據到多說的API接口
        /// </summary>
        /// <summary>http://dev.duoshuo.com/docs/51435552047fe92f490225de</summary>
        /// <param name="apiUrl">接口的URL，如http://api.duoshuo.com/users/import.json</param>
        /// <param name="prePostData">不包含array參數的前置數據，類似：short_name=當前站點注冊的多說二級域名&secret=站點多說密鑰</param>
        /// <param name="arrayName">array形式的參數的名稱，如users</param>
        /// <param name="arrayPostData">array形式的參數數據</param>
        /// <returns>接口返回的字符串</returns>
        /// <example>
        /// 注意array參數，在.NET下可以使用HashTable或者Dictionary實現
        /// 如：
        /// Dictionary<string, object> arrayPostData = new Dictionary<string, object>();
        /// arrayPostData.Add("user_key", 1);
        /// arrayPostData.Add("name", "Parry");
        /// arrayPostData.Add("role", "user");
        /// arrayPostData.Add("avatar_url", "");
        /// arrayPostData.Add("url", "");
        /// arrayPostData.Add("email", "");
        /// arrayPostData.Add("created_at", DateTime.Now.ToString("yyyy-mm-dd hh:MM:ss"));
        /// </example>
        /// <remarks>注意：此方法只處理了一個arrayPostData的情況，多個數組的形式請自行修改</remarks>
        public string HttpPostData(string apiUrl, string prePostData, string arrayName, Dictionary<string, object> arrayPostData)
        {
            var webRequest = WebRequest.Create(apiUrl) as HttpWebRequest;
            if (webRequest != null)
            {
                webRequest.Method = "post";
                webRequest.ContentType = "application/x-www-form-urlencoded";

                //postData賦值
                var postData = prePostData + "&" + string.Join("&", arrayPostData.Select(keyValuePair => string.Format("{0}[0][{1}]={2}", arrayName, keyValuePair.Key, keyValuePair.Value)).ToArray());

                ////使用非LINQ實現postData賦值
                //var listJoinArrayParamemter = new List<string>();
                //foreach (KeyValuePair<string, object> keyValuePair in arrayPostData)
                //{
                //    listJoinArrayParamemter.Add(string.Format("users[0][{0}]={1}", keyValuePair.Key, keyValuePair.Value));
                //}
                //var postData = prePostData + "&" + string.Join("&", listJoinArrayParamemter.ToArray());

                using (var sw = new StreamWriter(webRequest.GetRequestStream()))
                {
                    sw.Write(postData);
                }

                using (var response = webRequest.GetResponse())
                {
                    var stream = response.GetResponseStream();
                    if (stream == null) return string.Empty;
                    using (var sr = new StreamReader(stream))
                    {
                        return sr.ReadToEnd();
                    }
                }
            }
            return string.Empty;
        }

        #endregion

        #region 多說本地身份說明(JWT)

        /// <summary>
        /// 設置多說本地身份說明(JWT)
        /// </summary>
        /// <summary>http://dev.duoshuo.com/docs/501e6ce1cff715f71800000d</summary>
        /// <param name="secretKey">站點多說密鑰</param>
        /// <param name="shortName">當前站點注冊的多說二級域名</param>
        /// <param name="userKey">用戶在當前站點中對應的唯一標示，通常是用戶ID</param>
        /// <param name="name">用戶在當前網站的用戶名</param>
        public void SetLocalJwt(string secretKey, string shortName, string userKey, string name)
        {
            var array = new Dictionary<string, object>
            {
                {"short_name", shortName},
                {"user_key", userKey},
                {"name", name}
            };
            string token = JsonWebToken.Encode(array, secretKey, JwtHashAlgorithm.HS256);
            //cookie設置了一年過期
            var cookie = new HttpCookie("duoshuo_token") { Value = token, Expires = DateTime.Now.AddDays(365) };
            HttpContext.Current.Response.Cookies.Add(cookie);
        }

        #endregion

    }
}

完整源碼下載，包含JWT公共類。