support semantic api

Author: terry-fei

lib/api_semantic.js

@@ -0,0 +1,73 @@
+var urllib = require('urllib');
+var util = require('./util');
+var wrapper = util.wrapper;
+var postJSON = util.postJSON;
+
+/**
+ * 发送语义理解请求
+ * 详细请看：http://mp.weixin.qq.com/wiki/index.php?title=%E8%AF%AD%E4%B9%89%E7%90%86%E8%A7%A3
+ *
+ * Opts:
+ * ```
+ * {
+ *   "query":"查一下明天从北京到上海的南航机票",
+ *   "city":"北京",
+ *   "category": "flight,hotel",
+ *   "appid":"wxaaaaaaaaaaaaaaaa",
+ *   "uid":"123456"
+ * }
+ * ```
+ * Examples:
+ * ```
+ * api.semantic(opts, callback);
+ * ```
+ * Callback:
+ *
+ * - `err`, 调用失败时得到的异常
+ * - `result`, 调用正常时得到的对象
+ *
+ * Result:
+ * ```
+ * {
+ *   "errcode":0, 
+ *   "query":"查一下明天从北京到上海的南航机票", 
+ *   "type":"flight",
+ *   "semantic":{
+ *       "details":{
+ *           "start_loc":{
+ *               "type":"LOC_CITY",
+ *               "city":"北京市",
+ *               "city_simple":"北京",
+ *               "loc_ori":"北京"
+ *               },
+ *           "end_loc": {
+ *               "type":"LOC_CITY",
+ *               "city":"上海市",
+ *               "city_simple":"上海",
+ *               "loc_ori":"上海"
+ *             },
+ *           "start_date": {
+ *               "type":"DT_ORI",
+ *               "date":"2014-03-05",
+ *               "date_ori":"明天"
+ *             },
+ *          "airline":"中国南方航空公司"
+ *       },
+ *   "intent":"SEARCH"
+ * }
+ * ```
+ * @param {Object} opts 查询条件
+ * @param {Function} callback 回调函数
+ */
+exports.semantic = function (opts, callback) {
+  this.preRequest(this._semantic, arguments);
+};
+
+/*!
+ * 发送语义理解请求的未封装版本
+ */
+exports._semantic = function (opts, callback) {
+  // https://api.weixin.qq.com/semantic/semproxy/search?access_token=YOUR_ACCESS_TOKEN
+  var url = this.prefix + 'semantic/semproxy/search?access_token=' + this.token.accessToken;
+  urllib.request(url, postJSON(opts), wrapper(callback));
+};