社群媒體平台通常必須在不同服務、不同裝置與不同開發者之間交換資料。XML 因為結構清楚、可描述性高,且容易跨平台處理,成為許多社群媒體 API 的重要資料格式。
從頁面內容、使用者資料、好友清單到搜尋請求,XML 都能提供一致的表達方式。對開發者而言,理解這些格式,是整合社群服務的第一步。
| 方言 | 說明 |
|---|---|
| SOAP | 用於 Web 服務中交換結構化資料的 XML 協議,常用於遠端程序呼叫與文件導向訊息。 |
| RSS | 常見的網站提要格式,適合訂閱與聚合部落格、新聞等內容。 |
| Atom | 比 RSS 更具擴充性的提要格式,可承載圖片、外部連結與中繼資料。 |
| FBML | Facebook 提供的標記語言,用於在該平台中建立互動頁面。 |
| OST 與 OSML | OpenSocial 生態系中的模板與標記語言,用於建立社群應用。 |
eBay API 允許開發者查詢使用者資料、商品資訊與拍賣狀態。以下範例展示如何以 XML 形式提出 GetUserProfile 請求。
<?xml version="1.0" encoding="utf-8"?>
<GetUserProfileRequest xmlns="urn:ebay:apis:eBLBaseComponents">
<UserID>johndoesUserID</UserID>
<IncludeSelector>Details</IncludeSelector>
</GetUserProfileRequest>
若需要更完整的資料,可透過 IncludeSelector 指定 Details。伺服器回應時,會傳回包含註冊日期、回饋分數、商店網址等資訊的 XML 文件。
除了純 XML,eBay 也支援 SOAP 信封。這種方式適合需要與企業級 Web 服務整合的情境。
<soapenv:Envelope
xmlns:soapenv="https://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<GetUserProfileRequest xmlns="urn:ebay:apis:eBLBaseComponents">
<UserID>johndoesUserID</UserID>
<IncludeSelector>Details</IncludeSelector>
</GetUserProfileRequest>
</soapenv:Body>
</soapenv:Envelope>
Amazon ECS 提供多種 Web 服務,其中 CustomerContentSearch 可用來查詢客戶公開資料。這類請求通常需要簽章,以確保請求未被竄改。
簽章流程大致如下:先將請求參數進行 URL 編碼,再依字母順序排序,接著串接成規範字串,最後以秘密金鑰搭配 SHA-256 產生 HMac 簽章。
GET
ecs.amazonaws.com
/onca/XML
AssociateTag=johnDoesAssociateID
&AWSAccessKeyId=johndoesAccessKeyID
&Name=Jane%20Doe
&Operation=CustomerContentSearch
&Service=AWSECommerceService
完成簽章後,再將簽章值附加到請求 URL 中。伺服器回應通常也是 XML,內含客戶編號與相關請求資訊。
許多 Google 服務在交換資料前需要授權。ClientLogin API 可讓應用程式取得後續請求所需的驗證記號。
curl -k --header "Authorization: GoogleLogin auth=ABCDE..." \
https://apps-apis.google.com/a/feeds/example.com/user/2.0/johndoe
成功後,使用者資料可以以 Atom 或 RSS 形式回傳。開發者只需在請求中調整參數,即可取得不同格式的結果。
curl -k --header "Authorization: GoogleLogin auth=ABCDE..." \
https://apps-apis.google.com/a/feeds/example.com/user/2.0/johndoe?alt=rss
Facebook Platform 允許開發者在頁面中嵌入 FBML 標記,例如登入按鈕、使用者頭像與好友資訊。這讓社群功能能直接融入網站體驗。
圖 1:以 FBML 呈現的響應

若需要在一般 HTML 頁面中使用 Facebook Connect,則可改用 XFBML。它是 FBML 的子集,適合嵌入現有網頁。
圖 2:以 XFBML 呈現的響應

Twitter API 以 REST 架構為基礎,可回傳 XML、JSON、RSS 與 Atom。開發者只要調整網址的格式參數,就能取得不同資料表示法。
curl https://twitter.com/statuses/public_timeline.rss
curl -u johndoe:johndoespassword \
https://twitter.com/statuses/friends_timeline.xml
curl https://twitter.com/statuses/public_timeline.atom
這種設計讓 Twitter 能同時服務機器導向的應用程式與閱讀器導向的客戶端。
OpenSocial 由多家社群平台共同推動,目標是建立共通的 API 與標記語言。其中 OST 提供宣告式模板,OSML 則定義可被容器解析的標記。
<os:PeopleRequest
key="friends"
userId="@viewer"
groupId="@friends"/>
透過這類標記,開發者可以請求使用者資料或好友清單,再由容器在執行時完成資料綁定與呈現。
社群媒體 API 的整合,表面上是請求與回應的技術問題,實際上卻牽涉資料格式、驗證機制、平台慣例與使用者體驗。XML 在這其中提供了穩定且可擴充的基礎。
從 eBay 的 XML 與 SOAP,到 Amazon 的簽章請求、Google 的 Atom 與 RSS、Facebook 的 FBML、Twitter 的多格式輸出,以及 OpenSocial 的模板語言,開發者若能掌握這些共通概念,就能更有效率地跨平台整合社群服務。