在“用户管理”页面，公众平台运营者只需要将鼠标移动到的头像上面，就能查看的相关信息，诸如的名称、备注名、所在地区、签名及分组等。点击名称，还可以进入对话框，和进行一对一的互动沟通。
公众平台用户想要群发信息，可以点击后台“功能”下面的
“群发功能”选项。点击之后，就会出现一个群发功能页面。在这个页
面中，点击“新建群发信息”按钮，然后在下方的群发信息中选择“新
建图文消息”。
点击“新建图文消息”，就进入单个图文信息编辑页面。用户首先
需要给图文消息取一个标题，然后再输入作者，之后就可以编辑正文
内容了。编辑完成后，还需要在下方的发布样式中上传一个图片的封
面，然后输入一段简单的摘要。
编辑完成后，用户可以点击“预览”按钮查看图文信息效果，也可
以直接点击“保存并群发”按钮进行群发。
公众平台新建多条图文消息和新建单条图文消息的 *** 作步骤基本一样，主要
的区别在于由建立单条图文消息变为建立多条图文消息。多条图文消息
群发后，接收到的是一个综合性的群发消息。
首先确认是否有相应的接口权限，这里主要用到获取素材相关的接口，可以看到对应接口文档，个人号还是有对应权限的。
在新增了永久素材后，开发者可以分类型获取永久素材的列表：
1、获取永久素材的列表，也包含公众号在公众平台官网素材管理模块中新建的图文消息、语音、视频等素材 。
2、临时素材无法通过本接口获取。
3、调用该接口需https协议。
实现的逻辑还是比较简单的，具体分两个步骤：
1、获取公众号的access_token
获取公众号的access_token的在前文中已经实现。
基于微信小程序云函数的方式获取微信公众号access_token -
2、遍历调用公众号永久素材列表接口获取数据
调用素材列表接口，获取相应的文章信息，这里主要获取公众号的图文信息(type为news)，接口调用请求说明：
http请求方式: POST
https://api.weixin.qq.com/cgi-bin/material/batchget_material?access_token=ACCESS_TOKEN
调取素材列表之后在小程序中通过视图组件scroll-view来实现，主要有标题、封面图、摘要：
<scroll-view class="container"scroll-y='true' style="height:{{height}}px" bindscrolltolower='lower'>
<block wx:for="{{res}}" >
<view class='feed-item' id='{{item.title}}' bindtap='getDetial'>
<view>
<text >{{item.title}}</text>
</view>
<view style='text-align: center'>
<image src='{{item.image_url}}'>tupian </image>
</view>
<view>
<text >{{item.digest}}</text>
</view>
</view>
</block>
</scroll-view>
文章列表在页面首次加载时就获取：
/**
* 生命周期函数--监听页面加载
*/
onLoad: function (options) {
wx.getSystemInfo({
success: (res) =>{
this.setData({
height: res.windowHeight
})
}
})
this.getData()
}
函数getData()实现步骤，具体请求函数用云函数来实现，先从调取acces_token：
// 云函数入口文件
const cloud = require('wx-server-sdk')
const news = require('New')
cloud.init()
// 云函数入口函数
exports.main = async (event, context) =>{
let token = null
await cloud.callFunction({
name:'token'
}).then(function(data){
token = data.result
})
let offset = event.offset
let count = event.count
let nw = new news(token)
let rst = nw.getWechatPosts(offset,count)
return rst
}
然后调取文章列表信息，每次获取10条信息：
//获取文章列表
getData(){
var that = this
let pgno = this.data.pageNo+1
let result = this.data.res
wx.cloud.callFunction({
name:'news',
data:{
offset:this.data.offset,
count:this.data.count
},
success:function(res){
var resArr = []
let body = res.result.body
let total_count = body.total_count//总共图文数量
let item_count = body.item_count//本次调用数量
let item = body.item
let page_total = parseInt((total_count + that.data.count - 1) / that.data.count)
let mud = total_count % that.data.count
const db = wx.cloud.database()
for (let i = 0i <item.lengthi++) {
let news_item = item[i].content.news_item
//单图文消息及多图文消息
for (let j = 0j <news_item.lengthj++) {
let title = news_item[j].title//标题
let url = news_item[j].url//详细地址
let image_url = news_item[j].thumb_url//封面图片地址
let digest = news_item[j].digest//摘要
let author = news_item[j].author//作者
let content = news_item[j].content
resArr.push(new nw(total_count, item_count, title, url, image_url, digest, author, content))
let res_id = null
db.collection('content').where({
_id: url
}).get({
success: function (res) {
res_id = res.data[0]._id
}
})
if (res_id === url){
}else{
db.collection('content').add({
data: {
_id: url,
content: content,
title: title
},
success: function (res) {
}
})
}
}
that.setData({
res: result.concat(resArr),
page_total: page_total,
pageNo: pgno,
mud: mud
})
}
}
})
}
scroll-view组件到底触发事件实现函数：
lower() {
//总页数18/10=1
var pageno = this.data.pageNo
var page = this.data.page_total
console.log("总页数：" + page+",第"+pageno+"页"+"zuohouy:"+this.data.mud)
if (pageno >page) {//page 4
wx.showToast({ //如果全部加载完成了也d一个框
title: '我也是有底线的',
icon: 'success',
duration: 300
})
return false
} else {
wx.showLoading({ //期间为了显示效果可以添加一个过度的d出框提示“加载中”
title: '加载中',
icon: 'loading',
})
let offset = this.data.offset
let count = this.data.count
offset = this.data.offset + this.data.count
console.log("offset:" + offset+"count:"+count)
this.setData({
offset: offset,
count: count
})
setTimeout(() =>{
this.getData()
wx.hideLoading()
}, 1500)
}
}
我们整体性的架构设计，包含一个Web管理后台、一个Web API统一接口层、当然还有数据库什么，另外还有一个小程序客户端。整个架构体系还是以我之前随笔介绍的《整合微信小程序的Web API接口层的架构设计》内容为蓝本
整个体系以Web API为主提供服务，同时后台管理系统通过各种界面维护着数据的增删改等基础管理工作。
Web API的分层，我们可以通过下图来了解具体的分层结构。
随着基于JSON格式的Web API的广泛应用，越来越多的企业采用Web API接口服务层，作为统一接口的核心所在，也成为Web API核心层。基于JSON格式的接口，可以广泛地、跨平台的应用于IOS、安卓等移动端，也可以应用在常规的Web业务系统，Winform业务系统、微信应用、微信小程序等方方面面，因此企业内部形成自己是的一套Web API标准和详细的文档非常重要。
我们可以细化为下面的架构设计图，所有模块均围绕着Web API 接口层进行扩展，底层的数据存储对上层的应用是完全透明，我们可以根据需要拆分各种业务数据库，以及使用我们认为合适的数据库。
其中我们在Web API接口层上还看到一个微信消息交互的模块，这个模块我们为了方便域名端口的处理，和Web API 是统一放在一起的，它负责和腾讯微信服务器进行消息的交互处理，从而实现各种消息推送处理。
2、基于Asp.NET MVC的Web API接口的实现
1）GET方式
GET方式，接口参数包括有零或一个参数，以及多个参数的方式，返回的值可以是简单的字符串等基础类型，也可以是复杂的自定义对象类型等，如下面几种接口代码所示。
/// <summary>
/// 简单的GET方式获取数据 /// </summary>
/// <param name="id">字符串ID</param>
/// <param name="token">接口访问令牌</param>
/// <returns>返回字符串值</returns> [HttpGet] public string Test(string id, string token)
{ return string.Format("返回结果, id:{0}", id)
} /// <summary>
/// 多个参数的GET方式获取数据 /// </summary>
/// <param name="id">字符串ID</param>
/// <param name="name">名称</param>
/// <param name="token">接口访问令牌</param>
/// <returns>返回字符串值</returns> [HttpGet] public string TestMulti(string id, string name, string token)
{ return string.Format("返回结果, id:{0} name:{1}", id, name)
} /// <summary>
/// 参数测试GET返回自定义实体类对象 /// </summary>
/// <param name="id">字符串ID</param>
/// <param name="token">接口访问令牌</param>
/// <returns>返回自定义实体类对象</returns> [HttpGet] public virtual CommonResult TestObject(string id, string token)
{ return new CommonResult() { Data1 = id, Success = true }
} /// <summary>
/// 测试GET返回列表对象 /// </summary>
/// <param name="token">接口访问令牌</param>
/// <returns>返回列表对象</returns> [HttpGet] public List<string>TestAction(string token)
{
List<string>list = new List<string>() { "123", "234", "345" } return list
}
2）POST方式
POST方式，同样也和GET方式的一样，接口参数包括有零或一个参数，以及多个参数的方式，返回的值可以是简单的字符串等基础类型，也可以是复杂的自定义对象类型等，这就是几种常规的接口处理。但是，对于多个参数的接口定义，我们需要对它们进行转换处理，需要使用JObject param的方式进行定义，这样可以很好对多个参数或者自定义的实体类参数进行解析。
下面是几种常规的POST接口定义方式。
/// <summary>
/// 测试使用POST方式提交数据，参数输入为多个，使用JObject处理 /// </summary>
/// <returns>返回字符串</returns> [HttpPost] public string TestPost(JObject param, string token)
{ dynamic obj = param string id = obj.id if (obj != null)
{ return string.Format("返回结果, id:{0}", id)
} else
{ throw new MyApiException("传递参数出现错误")
}
} /// <summary>
/// 测试使用POST方式提交数据，参数输入为多个，使用JObject处理 /// </summary>
/// <returns>返回参数计算数值</returns> [HttpPost] public int TestPostSimple(JObject param)
{ dynamic obj = param if (obj != null)
{ return obj.x * obj.y * 10
} else
{ throw new MyApiException("传递参数出现错误")
}
}
/// <summary>
/// 测试POST的方法，方法统一采用JObject param 方式定义，包含一个msg字符串对象，以及一个CListItem对象 /// </summary>
/// <returns>返回一个通用的CommonResult对象，包括Data1,Data2,Data3的信息</returns> [HttpPost] public CommonResult TestPostObject(JObject param)
{ dynamic obj = param if (obj != null)
{ string msg = obj.msg//消息对象 //如果obj.item为类对象，那么需要转换为JObject然后使用ToObject转换为对应类型
CListItem item = ((JObject)obj.item).ToObject<CListItem>() var result = new CommonResult(true, msg)
result.Data1 = msg
result.Data2 = item.Text
result.Data3 = item.Value return result
} else
{ throw new MyApiException("传递参数出现错误")
}
} /// <summary>
/// 修改分组，方法统一采用JObject param 方式定义，包括一个字符串对象contactId，一个字符串列表对象groupIdList /// </summary>
/// <returns>返回一个通用的对象</returns> [HttpPost] public CommonResult TestPostList(JObject param)
{ dynamic obj = param if (obj != null)
{ string contactId = obj.contactId//联系人ID //如果是List<string>的类似列表，不能直接转换，先转换为JArray后使用ToObject转换为对应列表
List<string>groupIdList = ((JArray)obj.groupIdList).ToObject<List<string>>() var result = true//BLLFactory<Address>.Instance.ModifyAddressGroup(contactId, groupIdList)
return new CommonResult(result)
} else
{ throw new MyApiException("传递参数出现错误，请检查是否包含了contactId和groupIdList")
}
}
接口类，我们一般把类继承自自己的API接口基类，并对它的异常处理进行处理，以便对错误统一格式回应，如下接口类的代码定义所示。
/// <summary>
/// 此控制器用来详细介绍各种GET/POST的接口设计 /// 对于GET方式，方法可以接受多个参数 /// 对于POST方式，方法如果有参数使用POST方式，统一采用JObject param对象参数。 /// 如果POST方式有多个参数，如Web API接口加token，则需要客户端把该参数追加在URL上，如url?token=123，然后在使用POST *** 作 /// </summary> [ExceptionHandling] public class TestController : BaseApiController
其中ExceptionHandling是我们的统一异常过滤处理定义，代码如下所示。
/// <summary>
/// API自定义错误过滤器属性 /// </summary>
public class ExceptionHandlingAttribute : ExceptionFilterAttribute
{ /// <summary>
/// 统一对调用异常信息进行处理，返回自定义的异常信息 /// </summary>
/// <param name="context">HTTP上下文对象</param>
public override void OnException(HttpActionExecutedContext context)
{ //自定义异常的处理
MyApiException ex = context.Exception as MyApiException if (ex != null)
{ //记录关键的异常信息 LogHelper.Error(context.Exception) throw new HttpResponseException(new HttpResponseMessage(HttpStatusCode.InternalServerError)
{ //封装处理异常信息，返回指定JSON对象
Content = new StringContent(new BaseResultJson(ex.Message, false, ex.errcode).ToJson()),
ReasonPhrase = "Exception"
})
}
//常规异常的处理
string msg = string.IsNullOrEmpty(context.Exception.Message) ? "接口出现了错误，请重试或者联系管理员" : context.Exception.Message throw new HttpResponseException(new HttpResponseMessage(HttpStatusCode.InternalServerError)
{
Content = new StringContent(msg),
ReasonPhrase = "Critical Exception"
})
}
}
3）小程序端代码处理
小程序端主要是通过JS代码进行处理，实现数据的获取及提交处理等。
如我们列举一个代表性的POST处理代码，如下所示。
//测试POst方法 wx.request({
url: 'http://localhost:27206/api/SmallApp/Test/TestPostObject',
data: {
msg : '测试内容',
item: {Text :'Text', Value:'testValue'}
},
header: {'Content-Type': 'application/json' },
method: 'POST',
success: function (res) {
console.log(res.data)
}
})
而对于GET方式，我们的小程序调用方式如下所示。
getFilms: function(start) {
console.log('start:' + start) var that = this
wx.request({
url: 'http://www.iqidi.com/api/h5/test/movies',
data: {
offset: start,
type: 'hot',
limit: that.data.limit
},
header: { 'Content-Type': 'application/json'
},
success: function (res) {
console.log(res.data) var data = res.data.data
console.log(data) if (data.movies.length === 0) {
that.setData({
hasMore: false,
hideLoading :true,
})
}
else {
that.setData({
films: that.data.films.concat(data.movies),
start: that.data.start + data.movies.length,
hasMore: true,
hideLoading :true,
})
}
}
})
以上就是我们常规接口（单个参数或者多个参数，简单对象和复杂对象的处理）的定义代码，希望读者在开发Web API接口的时候，可以有所帮助。
欢迎分享，转载请注明来源：内存溢出
微信扫一扫
支付宝扫一扫
评论列表（0条）