wechat-api/lib/api_semantic.js

微信公共平台Node库 API

'use strict';

var util = require('./util');
var wrapper = util.wrapper;
var postJSON = util.postJSON;

/**
 * 发送语义理解请求
 * 详细请看：http://mp.weixin.qq.com/wiki/0/0ce78b3c9524811fee34aba3e33f3448.html
 *
 * 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 = this.endpoint + '/semantic/semproxy/search?access_token=' + this.token.accessToken;
  opts.appid = this.appid;
  opts.uid = uid;
  this.request(url, postJSON(opts), wrapper(callback));
};