API 概覽

概覽

本文檔中列出的所有 API 基礎(chǔ)調(diào)用 URL 是 https://service.mysubmail.com/ （ 如 API：短網(wǎng)址API 實際請求 URL https://service.mysubmail.com/shorturl ）。SUBMAIL 支持 json (默認) 和 xml 格式，如果你想要 API 返回碼的格式為 xml，請在 完整 URL 的末尾加上 .xml。

SUBMAIL 還提供開發(fā)模式的 API，方便開發(fā)者調(diào)試和集成 SUBMAIL 應(yīng)用。

RESTful API

SUBMAIL API 基于 RESTful API 風格，它具備完整的 HTTP 請求規(guī)范，多數(shù)的 SUBMAIL API 需采用 POST 方式發(fā)送請求，少量的服務(wù)類 API 使用 GET 方式獲取數(shù)據(jù)。除 API 列舉的請求方式外，其他方法都不被支持。

繼承 RESTful API 風格，所有的 SUBMAIL API 都具有 HTTP 返回代碼

• 2XX - 請求成功。
• 4XX - 請求失敗。（具體出錯原因，會在返回數(shù)據(jù)中標注錯誤代碼和原因）
• 5XX - 服務(wù)器錯誤。

參閱 HTTP 狀態(tài)碼 | API 錯誤代碼

SUBMAIL WEB API

• shorturl ( 短網(wǎng)址API )
• shorturl/group( 短網(wǎng)址群組API)
• service/timestamp ( 服務(wù)器 UNIX 時間戳 )
• service/status （服務(wù)器狀態(tài)）