ASP.NET 實作 MetaWeblog API：支援 Windows Live Writer 等離線寫作工具

MetaWeblog API 是基於 XML-RPC 的通訊協定，定義標準資料結構與方法，讓部落格引擎支援 Windows Live Writer、MarsEdit、BlogJet 等離線編輯器。

核心資料結構 (六大類型)

• BlogInfo：部落格網址、ID、名稱
• UserInfo：使用者 ID、名字、姓氏、Email
• Post：文章標題、內容、分類
• CategoryInfo：分類編號、名稱
• MediaObject：媒體檔名、類型、資料 (Base64)
• MediaObjectInfo：媒體物件回傳資訊

特徵：以字串為基礎型別，參數/回傳無整數型別，少數布林與 Base64 編碼字串。

九大標準方法

實作步驟

1. 下載 XML-RPC.NET 程式庫 (開源實作)
2. 專案加入參考 CookComputing.XmlRpcV2.dll
3. 定義介面繼承 IXmlRpcProxy，標記方法屬性
4. 實作介面方法，連接資料庫/業務邏輯
5. 建立 .ashx 或 .aspx 端點處理 XML-RPC 請求

介面定義範例

using CookComputing.XmlRpc;

public interface IMetaWeblog
{
    [XmlRpcMethod("metaWeblog.newPost")]
    string NewPost(string blogid, string username, string password, Post post, bool publish);

    [XmlRpcMethod("metaWeblog.getCategories")]
    CategoryInfo[] GetCategories(string blogid, string username, string password);

    [XmlRpcMethod("metaWeblog.newMediaObject")]
    MediaObjectInfo NewMediaObject(string blogid, string username, string password, MediaObject media);
    // ... 其他方法
}

public struct Post
{
    public string title;
    public string description;
    public string[] categories;
    public DateTime dateCreated;
    // ...
}

部署驗證

Windows Live Writer 設定「其他部落格服務」，輸入 API 端點網址即可連線測試。成功後支援離線撰寫、圖片上傳、分類管理等完整功能。

實作 MetaWeblog API 讓你的部落格平台即時獲得豐富的編輯器生態支援。