潮州母语作为国内最早建立的潮州字典类网站,自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