潮州母語作爲國內最早建立的潮州字典類網站,自2005年創建以來,積累了一定的字典數據。爲了更快地在多種電子媒介上傳播潮州話,我們決定開放本網站的數據,讓開發者更方便的使用本網站的數據。
如果您需要使用API接口,請先發郵件到mogher@qq.com申請使用接口,我們在收到郵件後,會根據您的情況分配一個接口的Key給您使用。
使用開放接口的優點:
1)保持最新,目前Mogher的詞庫在不斷更新之中,使用API可以讓你的應用保持最新的數據。
2)免維護,更快捷,您不需要自己維護一個數據庫
3)保持數據的正確性,目前字庫和語音庫我們會根據用戶的反饋不斷糾正。
數據格式:
開放接口以目前最主流的數據交換格式:JSON,採用http協議,使用非常方便。目前開放了兩個接口:
接口一:綜合查詢接口(包含定義和多音字等)
接口地址:http://www.mogher.com/api/search
接口格式:/api/search?type=類型&keyword=關鍵字
格式說明:
type參數可選,可以指定爲:
1) single_char, 單個漢字
2) multi_char, 多個漢字
3) english_word , 英文單詞
keyword參數必填,可以使用單個漢字,多個漢字,或者英文單詞,如果type類型參數也提供,需要和keyword一致。注意keyword參數要使用urlencode編碼。
使用範例:
1) 查詢單個漢字: /api/search?keyword=%E4%B8%80
2) 查詢多個漢字: /api/search?keyword=%E4%B8%80%E4%BA%8C%E4%B8%89
3) 查詢英文單詞: /api/search?keyword=one
4) 查詢指定類型: /api/search?type=english_word&keyword=one
錯誤參數返回:{"from":"www.mogher.com","type":"english_word","result":[]}
接口二:簡單查詢接口(僅提供音標和發音)
接口地址:http://www.mogher.com/api/search_reading
接口格式:/api/search_reading?keyword=關鍵字
格式說明:
keyword參數必填,可以指定爲單個漢字或者多個漢字。
使用範例:
1) 查詢單個漢字: /api/search_reading?keyword=%E4%B8%80
2) 查詢多個漢字: /api/search_reading?keyword=%E4%B8%80%E4%BA%8C