具体我们来看看几个接口的官方定义数据。
1）创建标签的接口
接口调用请求说明
http请求方式：POST（请使用https协议）
https://www.easck.com/cgi-bin/tags/create?access_token=ACCESS_TOKEN
POST数据格式：JSON
POST数据例子：
{
"tag" : {
"name" : "广东"//标签名
}
}
返回说明（正常时返回的json数据包示例）
{
"tag":{
"id":134,//标签id
"name":"广东"
}
}
这样我们就可以定义一个实体类来承载这个返回的数据了。
/// <summary>
/// 标签信息
/// </summary>
public class TagJson
{
/// <summary>
/// 标签id，由微信分配
/// </summary>
public int id { get; set; }
/// <summary>
/// 标签名，UTF8编码
/// </summary>
public string name { get; set; }
}
这样，创建标签的完整实现代码如下所示
/// <summary>
/// 创建标签
/// 一个公众号，最多可以创建100个标签。
/// </summary>
/// <param name="accessToken">调用接口凭证</param>
/// <param name="name">标签名（30个字符以内）</param>
/// <returns></returns>
public TagJson CreateTag(string accessToken, string name)
{
var url = string.Format("https://www.easck.com/cgi-bin/tags/create?access_token={0}", accessToken);
var data = new
{
tag = new
{
name = name
}
};
var postData = data.ToJson();
var result = JsonHelper<TagCreateResult>.ConvertJson(url, postData);
return result != null ? result.tag : null;
}
2）获取公众号已创建的标签
接口调用请求说明
http请求方式：GET（请使用https协议）
https://www.easck.com/cgi-bin/tags/get?access_token=ACCESS_TOKEN
返回数据格式：JSON返回的数据例子：
{
"tags":[{
"id":1,
"name":"黑名单",
"count":0 //此标签下粉丝数
},{
"id":2,
"name":"星标组",
"count":0
},{
"id":127,
"name":"广东",
"count":5
}
]
}
