微信开放平台开发(1) 语义理解

关键字：微信公众平台 微信开放平台 语义理解 semantic 
作者：方倍工作室 
原文：http://www.cnblogs.com/txw1958/p/weixin-semantic-analysis.html 

微信开放平台语义理解接口调用（http请求）简单方便，用户无需掌握语义理解及相关技术，只需根据自己的产品特点，选择相应的服务即可搭建一套智能语义服务。

第一步：创建应用

请到“管理中心”创建应用，点击“创建移动应用”或者“创建网站应用”，填写相关资料，然后将该应用提交审核，只有审核通过的应用才能进行开发。

注册完毕，我们会在 7 个工作日内完成审核工作。审核通过之后，开放平台将分配给该移动应用全局唯一的AppID和AppSecret。

第二步：根据AppID和AppSecret获得access token

调用接口：

http请求方式: GET


https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET

参数说明：

返回说明：

正常情况下，微信会返回下述JSON数据包。

{
"access_token":"ACCESS_TOKEN",
"expires_in":7200
} 

错误时微信会返回错误码等信息，JSON数据包示例如下（该示例为AppID无效错误）:

{
"errcode":40013,
"errmsg":"invalid appid"
} 

第三步：使用access token调用语义理解接口

输入说明：

http请求方式: POST（请使用https协议）


https://api.weixin.qq.com/semantic/semproxy/search?access_token=YOUR_ACCESS_TOKEN

POST数据格式：JSON
POST数据例子：


{
"query":"查一下明天从北京到上海的南航机票",
"city":"北京",
"category": "flight,hotel",
"appid":"wxaaaaaaaaaaaaaaaa",
"uid":"123456"
}

输入参数说明：

返回说明：

正常情况下，微信会返回下述JSON数据包。

{
    "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"
    }
}

返回参数说明：

更多详细内容与协议说明，请查看：语义理解接口协议文档

代码实现 

<?php

/*
    方倍工作室 http://www.fangbei.org/
    CopyRight 2014 All Rights Reserved
    微信开放平台接口SDK
*/

/*
    require_once('weixin.class.php');
    $weixin = new class_weixin();
*/

define('APPID',         "wxed782be999f86eab");
define('APPSECRET',        "72edec63779f7aa16a3a33447e2c7-fb");

class class_weixin
{
    var $appid = APPID;
    var $appsecret = APPSECRET;

    //构造函数，获取Access Token
    public function __construct($appid = NULL, $appsecret = NULL)
    {
        if($appid && $appsecret){
            $this->appid = $appid;
            $this->appsecret = $appsecret;
        }

        //1. 本地写入
        $res = file_get_contents('access_token.json');
        $result = json_decode($res, true);
        $this->expires_time = $result["expires_time"];
        $this->access_token = $result["access_token"];

        if (time() > ($this->expires_time + 3600)){
            $url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=".$this->appid."&secret=".$this->appsecret;
            $res = $this->http_request($url);
            $result = json_decode($res, true);
            $this->access_token = $result["access_token"];
            $this->expires_time = time();
            file_put_contents('access_token.json', '{"access_token": "'.$this->access_token.'", "expires_time": '.$this->expires_time.'}');
        }
    }

    public function semantic_search($record)
    {
        $data = urldecode(json_encode($record));
        $url = "https://api.weixin.qq.com/semantic/semproxy/search?access_token=".$this->access_token;
        $res = $this->http_request($url, $data);
        return json_decode($res, true);
    }

    //HTTP请求（支持HTTP/HTTPS，支持GET/POST）
    protected function http_request($url, $data = null)
    {
        $curl = curl_init();
        curl_setopt($curl, CURLOPT_URL, $url);
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, FALSE);
        if (!empty($data)){
            curl_setopt($curl, CURLOPT_POST, 1);
            curl_setopt($curl, CURLOPT_POSTFIELDS, $data);
        }
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, TRUE);
        $output = curl_exec($curl);
        curl_close($curl);
        return $output;
    }

    //日志记录
    private function logger($log_content)
    {
        if(isset($_SERVER['HTTP_APPNAME'])){   //SAE
            sae_set_display_errors(false);
            sae_debug($log_content);
            sae_set_display_errors(true);
        }else if($_SERVER['REMOTE_ADDR'] != "127.0.0.1"){ //LOCAL
            $max_size = 500000;
            $log_filename = "log.xml";
            if(file_exists($log_filename) and (abs(filesize($log_filename)) > $max_size)){unlink($log_filename);}
            file_put_contents($log_filename, date('Y-m-d H:i:s').$log_content."\r\n", FILE_APPEND);
        }
    }
}

接口调用

    $weixin = new class_weixin();
    $record =  array('query' => "查一下明天从北京到深圳的深航机票",
                     'city' => "北京",
                     'category' => "flight,hotel",
                     'appid' => $weixin->appid,
                     'uid' => ""
                     );
    $result = $weixin->semantic_search($record);

结果返回

{
       "errcode" : 0,
       "query" : "查一下明天从北京到深圳的国航机票",
       "semantic" : {
          "details" : {
             "airline" : "中国国际航空公司",
             "answer" : "已帮您预定2015-12-19,从北京市出发，前往深圳市的航班。",
             "context_info" : {
                "isFinished" : "1",
                "null_times" : "0"
             },
             "end_loc" : {
                "city" : "深圳市",
                "city_simple" : "深圳",
                "loc_ori" : "深圳",
                "modify_times" : "0",
                "province" : "广东省",
                "province_simple" : "广东|粤",
                "slot_content_type" : "2",
                "type" : "LOC_CITY"
             },
             "hit_str" : "查 一下 明天 从 北京 到 深圳 国航 机票 ",
             "start_date" : {
                "date" : "2015-12-19",
                "date_lunar" : "2015-11-09",
                "date_ori" : "明天",
                "modify_times" : "0",
                "slot_content_type" : "2",
                "type" : "DT_ORI",
                "week" : "6"
             },
             "start_loc" : {
                "city" : "北京市",
                "city_simple" : "北京|京",
                "loc_ori" : "北京",
                "modify_times" : "0",
                "slot_content_type" : "2",
                "type" : "LOC_CITY"
             }
          },
          "intent" : "SEARCH"
       },
       "type" : "flight"
    }

原文：http://www.cnblogs.com/txw1958/p/weixin-semantic-analysis.html