It's easy to call (send an HTTP request to) the Weixin Open Platform semantic understanding API. You do not need to know anything about semantic understanding or the relevant technical details. You can simply select the relevant services based on your business features to build a smart semantic service.

# Step 1: Create an app

Go to the "Management Center", click "Create Mobile App" or "Create Website App", and fill in the relevant information. Then, submit this app for review. Development can start after the app is approved.

After you have finished the registration process, we will complete the review within seven business days. After the app is approved, the Open Platform will allocate a globally unique AppID and AppSecret to the mobile app.

# Step 2: Obtain an access token based on the AppID and AppSecret

# Call the API:

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

# Parameters

# Response description:

For a successful request, Weixin returns the following JSON packet:

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

When an error occurs, Weixin will return an error code and related information. An example of the JSON packet (for an invalid AppID error) is shown below:

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

# Step 3: Use the access token to call the semantic understanding API

# Information entry instructions:

HTTP request method: POST (HTTPS protocol should be used)
https://api.weixin.qq.com/semantic/semproxy/search?access_token=YOUR_ACCESS_TOKEN
POST data format: JSON
POST data example:
{
"query":"Query China Southern Airlines tickets from Beijing to Shanghai tomorrow",
"city":"Beijing",
"category": "flight,hotel",
"appid":"wxaaaaaaaaaaaaaaaa",
"uid":"123456"
}

# Parameter entry instructions:

# Response description:

For a successful request, Weixin returns the following JSON packet:

{
	"errcode":0,
	"query":"Query China Southern Airlines tickets from Beijing to Shanghai tomorrow",
	"type":"flight",
	"semantic":{
		"details":{
			"start_loc":{
			"type":"LOC_CITY",
Beijing
			"city_simple":"Beijing",
			"loc_ori":"Beijing"
			},
			"end_loc": {
			"type":"LOC_CITY",
			"city":"Shanghai City",
			"city_simple":"Shanghai",
			"loc_ori":"Shanghai"
			},
			"start_date": {
			"type":"DT_ORI",
			"date":"2014-03-05",
			"date_ori":"Tomorrow"
			},
			"airline":"China Southern Airlines"
		},
		"intent":"SEARCH"
	}
}

# Response parameters:

For more detailed information and protocol description, see Semantic Understanding API Protocol Documentation.