Merge branch 'ifeiteng-add-semantic-api'

Author: JacksonTian

index.js

@@ -43,6 +43,8 @@ API.mixin(require('./lib/api_payment'));
 API.mixin(require('./lib/api_feedback'));
 // 短网址接口
 API.mixin(require('./lib/api_url'));
+// 语义查询接口
+API.mixin(require('./lib/api_semantic'));
 
 wechat.API = API;
 wechat.OAuth = require('./lib/oauth');

lib/api_semantic.js

@@ -0,0 +1,74 @@
+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"
+ * }
+ * ```
+ * Examples:
+ * ```
+ * api.semantic(uid, 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 {String} openid 用户ID
+ * @param {Object} opts 查询条件
+ * @param {Function} callback 回调函数
+ */
+exports.semantic = function (uid, opts, callback) {
+  this.preRequest(this._semantic, arguments);
+};
+
+/*!
+ * 发送语义理解请求的未封装版本
+ */
+exports._semantic = function (uid, opts, callback) {
+  // https://api.weixin.qq.com/semantic/semproxy/search?access_token=YOUR_ACCESS_TOKEN
+  var url = 'https://api.weixin.qq.com/semantic/semproxy/search?access_token=' + this.token.accessToken;
+  opts.appid = this.appid;
+  opts.uid = uid;
+  urllib.request(url, postJSON(opts), wrapper(callback));
+};

test/api_semantic.test.js

@@ -0,0 +1,23 @@
+var config = require('./config');
+var API = require('../').API;
+var expect = require('expect.js');
+
+describe('api_semantic', function () {
+  var api = new API(config.appid, config.appsecret);
+  it('should ok', function (done) {
+    var condition = {
+      "query":"查一下明天从北京到上海的南航机票",
+      "city":"北京",
+      "category": "flight,hotel"
+    };
+
+    var uid = "123456";
+
+    api.semantic(uid, condition, function (err, data, res) {
+      expect(err).to.be.ok();
+      expect(data).to.have.property('errcode');
+      expect(data).to.have.property('errmsg');
+      done();
+    });
+  });
+});