WeChat 공개 플랫폼 개발: 고급 인터페이스 설명
- 高洛峰원래의
- 2017-02-27 13:23:562804검색
여기에 언급된 고급 인터페이스는 인증된 서비스 계정에 제공되는 고급 기능을 의미합니다.
고급 기능은 크게 다음과 같이 분류할 수 있습니다.
사용자 인터페이스
그룹 인터페이스
고객 서비스 인터페이스(이전에 소개된 다중 고객 서비스와 다름)
그룹 전송 인터페이스
멀티미디어 인터페이스
QR 코드 인터페이스
템플릿 메시지 인터페이스(일부 계정은 활성화할 수 없음)
OAuth2 .0 (상대적으로 복잡하며 나중에 소개됩니다)
위의 모든 인터페이스는 Senparc.Weixin.MP.AdvancedAPIs 네임스페이스에 포함되어 있습니다.
일부 일반적인 작업
거의 모든 상위 수준 인터페이스에는 통신을 위해 AccessToken이 필요합니다(특별한 지침이 없는 다음 인터페이스에는 이 AccessToken이 필요하지만 전부는 아님). 매개변수가 전달되었습니다. AccessToken을 획득하고 작동하는 방법에 대한 자세한 내용은 Senparc.Weixin.MP SDK WeChat 공개 플랫폼 개발 튜토리얼(8): 일반 인터페이스 설명을 참조하세요.
사용자 인터페이스
소스 파일 폴더: Senparc.Weixin.MP/AdvancedAPIs/User
소스 코드의 관련 메소드는 다음과 같습니다.
namespace Senparc.Weixin.MP.AdvancedAPIs
{
//接口详见：http://mp.weixin.qq.com/wiki/index.php?title=%E8%8E%B7%E5%8F%96%E7%94%A8%E6%88%B7%E5%9F%BA%E6%9C%AC%E4%BF%A1%E6%81%AF
/// <summary>
/// 用户接口
/// </summary>
public static class User
{
/// <summary>
/// 获取用户信息
/// </summary>
/// <param name="accessToken">调用接口凭证</param>
/// <param name="openId">普通用户的标识，对当前公众号唯一</param>
/// <param name="lang">返回国家地区语言版本，zh_CN 简体，zh_TW 繁体，en 英语</param>
/// <returns></returns>
public static UserInfoJson Info(string accessToken, string openId, Language.zh_CN)
{
string url = string.Format("https://api.weixin.qq.com/cgi-bin/user/info?access_token={0}&openid={1}&lang={2}",
accessToken, openId, lang.ToString());
return HttpUtility.Get.GetJson<UserInfoJson>(url);
//错误时微信会返回错误码等信息，JSON数据包示例如下（该示例为AppID无效错误）:
//{"errcode":40013,"errmsg":"invalid appid"}
}
/// <summary>
/// 获取关注着OpenId信息
/// </summary>
/// <param name="accessToken"></param>
/// <param name="nextOpenId"></param>
/// <returns></returns>
public static OpenIdResultJson Get(string accessToken, string nextOpenId)
{
string url = string.Format("https://api.weixin.qq.com/cgi-bin/user/get?access_token={0}",
accessToken);
if (!string.IsNullOrEmpty(nextOpenId))
{
url += "&next_openid=" + nextOpenId;
}
return HttpUtility.Get.GetJson<OpenIdResultJson>(url);
}
}
}그룹 인터페이스
소스 파일 폴더: Senparc.Weixin.MP/AdvancedAPIs/Groups
소스 코드의 관련 메소드는 다음과 같습니다.
namespace Senparc.Weixin.MP.AdvancedAPIs
{
/// <summary>
/// 用户组接口
/// </summary>
public static class Groups
{
/// <summary>
/// 创建分组
/// </summary>
/// <returns></returns>
public static CreateGroupResult Create(string accessToken, string name)
{
var urlFormat = "https://api.weixin.qq.com/cgi-bin/groups/create?access_token={0}";
var data = new
{
group = new
{
name = name
}
};
return CommonJsonSend.Send<CreateGroupResult>(accessToken, urlFormat, data);
}
/// <summary>
/// 发送文本信息
/// </summary>
/// <param name="accessToken"></param>
/// <returns></returns>
public static GroupsJson Get(string accessToken)
{
var urlFormat = "https://api.weixin.qq.com/cgi-bin/groups/get?access_token={0}";
var url = string.Format(urlFormat, accessToken);
return HttpUtility.Get.GetJson<GroupsJson>(url);
}
/// <summary>
/// 获取用户分组
/// </summary>
/// <param name="accessToken"></param>
/// <param name="openId"></param>
/// <returns></returns>
public static GetGroupIdResult GetId(string accessToken, string openId)
{
var urlFormat = "https://api.weixin.qq.com/cgi-bin/groups/getid?access_token={0}";
var data = new { openid = openId };
return CommonJsonSend.Send<GetGroupIdResult>(accessToken, urlFormat, data);
}
/// <summary>
/// 创建分组
/// </summary>
/// <param name="accessToken"></param>
/// <param name="id"></param>
/// <param name="name">分组名字（30个字符以内）</param>
/// <returns></returns>
public static WxJsonResult Update(string accessToken, int id, string name)
{
var urlFormat = "https://api.weixin.qq.com/cgi-bin/groups/update?access_token={0}";
var data = new
{
group = new
{
id = id,
name = name
}
};
return CommonJsonSend.Send(accessToken, urlFormat, data);
}
/// <summary>
/// 移动用户分组
/// </summary>
/// <param name="accessToken"></param>
/// <param name="openId"></param>
/// <param name="toGroupId"></param>
/// <returns></returns>
public static WxJsonResult MemberUpdate(string accessToken, string openId, int toGroupId)
{
var urlFormat = "https://api.weixin.qq.com/cgi-bin/groups/members/update?access_token={0}";
var data = new
{
openid = openId,
to_groupid = toGroupId
};
return CommonJsonSend.Send(accessToken, urlFormat, data);
}
}
}고객 서비스 인터페이스
설명하자면, 여기의 고객 서비스 인터페이스는 이전의 "다중 고객 서비스"와 다릅니다. 이전에 소개된 다중 고객 서비스는 사용자 대화 상태를 다중 고객 서비스로 전환하고 메시지가 전용으로 전송됩니다. 다중 고객 서비스 클라이언트. 이 대화는 사용자에 의해 시작됩니다. 여기서 "고객 서비스"는 실제로 언제든지 지정된 사용자에게 적극적으로 메시지를 푸시하는 것을 의미하며(사용자는 48시간 이내에 상호 작용함) 사용자가 대화를 시작할 필요가 없습니다.
소스 파일 폴더: Senparc.Weixin.MP/AdvancedAPIs/Custom
소스 코드의 관련 메소드는 다음과 같습니다.
namespace Senparc.Weixin.MP.AdvancedAPIs
{
/// <summary>
/// 客服接口
/// </summary>
public static class Custom
{
private const string URL_FORMAT = "https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token={0}";
/// <summary>
/// 发送文本信息
/// </summary>
/// <param name="accessToken"></param>
/// <param name="openId"></param>
/// <param name="content"></param>
/// <returns></returns>
public static WxJsonResult SendText(string accessToken, string openId, string content)
{
var data = new
{
touser = openId,
msgtype = "text",
text = new
{
content = content
}
};
return CommonJsonSend.Send(accessToken, URL_FORMAT, data);
}
/// <summary>
/// 发送图片消息
/// </summary>
/// <param name="accessToken"></param>
/// <param name="openId"></param>
/// <param name="mediaId"></param>
/// <returns></returns>
public static WxJsonResult SendImage(string accessToken, string openId, string mediaId)
{
var data = new
{
touser = openId,
msgtype = "image",
image = new
{
media_id = mediaId
}
};
return CommonJsonSend.Send(accessToken, URL_FORMAT, data);
}
/// <summary>
/// 发送语音消息
/// </summary>
/// <param name="accessToken"></param>
/// <param name="openId"></param>
/// <param name="mediaId"></param>
/// <returns></returns>
public static WxJsonResult SendVoice(string accessToken, string openId, string mediaId)
{
var data = new
{
touser = openId,
msgtype = "voice",
voice = new
{
media_id = mediaId
}
};
return CommonJsonSend.Send(accessToken, URL_FORMAT, data);
}
/// <summary>
/// 发送视频消息
/// </summary>
/// <param name="accessToken"></param>
/// <param name="openId"></param>
/// <param name="mediaId"></param>
/// <param name="thumbMediaId"></param>
/// <returns></returns>
public static WxJsonResult SendVideo(string accessToken, string openId, string mediaId, string thumbMediaId)
{
var data = new
{
touser = openId,
msgtype = "video",
video = new
{
media_id = mediaId,
thumb_media_id = thumbMediaId
}
};
return CommonJsonSend.Send(accessToken, URL_FORMAT, data);
}
/// <summary>
/// 发送音乐消息
/// </summary>
/// <param name="accessToken"></param>
/// <param name="openId"></param>
/// <param name="title">音乐标题（非必须）</param>
/// <param name="description">音乐描述（非必须）</param>
/// <param name="musicUrl">音乐链接</param>
/// <param name="hqMusicUrl">高品质音乐链接，wifi环境优先使用该链接播放音乐</param>
/// <param name="thumbMediaId">视频缩略图的媒体ID</param>
/// <returns></returns>
public static WxJsonResult SendMusic(string accessToken, string openId, string title, string description,
string musicUrl, string hqMusicUrl, string thumbMediaId)
{
var data = new
{
touser = openId,
msgtype = "music",
music = new
{
title = title,
description = description,
musicurl = musicUrl,
hqmusicurl = hqMusicUrl,
thumb_media_id = thumbMediaId
}
};
return CommonJsonSend.Send(accessToken, URL_FORMAT, data);
}
/// <summary>
/// 发送图文消息
/// </summary>
/// <param name="accessToken"></param>
/// <param name="openId"></param>
/// <param name="title">音乐标题（非必须）</param>
/// <param name="description">音乐描述（非必须）</param>
/// <param name="musicUrl">音乐链接</param>
/// <param name="hqMusicUrl">高品质音乐链接，wifi环境优先使用该链接播放音乐</param>
/// <param name="thumbMediaId">视频缩略图的媒体ID</param>
/// <returns></returns>
public static WxJsonResult SendNews(string accessToken, string openId, List<Article> articles)
{
var data = new
{
touser = openId,
msgtype = "news",
news = new
{
articles = articles.Select(z => new
{
title = z.Title,
description = z.Description,
url = z.Url,
picurl = z.PicUrl//图文消息的图片链接，支持JPG、PNG格式，较好的效果为大图640*320，小图80*80
}).ToList()
}
};
return CommonJsonSend.Send(accessToken, URL_FORMAT, data);
}
}
}그룹 인터페이스
여기에서 대량 전송의 효과는 WeChat 백엔드에 로그인하는 것과 동일합니다.
소스 파일 폴더: Senparc.Weixin.MP/AdvancedAPIs/GroupMessage
소스 코드의 관련 메소드는 다음과 같습니다.
namespace Senparc.Weixin.MP.AdvancedAPIs
{
/// <summary>
/// 高级群发接口
/// </summary>
public static class GroupMessage
{
/// <summary>
/// 根据分组进行群发
///
/// 请注意：
/// 1、该接口暂时仅提供给已微信认证的服务号
/// 2、虽然开发者使用高级群发接口的每日调用限制为100次，但是用户每月只能接收4条，请小心测试
/// 3、无论在公众平台网站上，还是使用接口群发，用户每月只能接收4条群发消息，多于4条的群发将对该用户发送失败。
///
/// </summary>
/// <param name="accessToken"></param>
/// <param name="groupId">群发到的分组的group_id</param>
/// <param name="mediaId">用于群发的消息的media_id</param>
/// <returns></returns>
public static SendResult SendGroupMessageByGroupId(string accessToken, string groupId, string mediaId)
{
const string urlFormat = "https://api.weixin.qq.com/cgi-bin/message/mass/sendall?access_token={0}";
var data = new
{
filter = new
{
group_id = groupId
},
mpnews = new
{
media_id = mediaId
},
msgtype = "mpnews"
};
return CommonJsonSend.Send<SendResult>(accessToken, urlFormat, data);
}
/// <summary>
/// 根据OpenId进行群发
/// </summary>
/// <param name="accessToken"></param>
/// <param name="mediaId">用于群发的消息的media_id</param>
/// <param name="openIds">openId字符串数组</param>
/// <returns></returns>
public static SendResult SendGroupMessageByOpenId(string accessToken, string mediaId, params string[] openIds)
{
const string urlFormat = "https://api.weixin.qq.com/cgi-bin/message/mass/send?access_token={0}";
var data = new
{
touser = openIds,
mpnews = new
{
media_id = mediaId
},
msgtype = "mpnews"
};
return CommonJsonSend.Send<SendResult>(accessToken, urlFormat, data);
}
/// <summary>
/// 删除群发消息
/// </summary>
/// <param name="accessToken"></param>
/// <param name="mediaId">发送出去的消息ID</param>
/// <returns></returns>
public static WxJsonResult DeleteSendMessage(string accessToken, string mediaId)
{
//官方API地址为https://api.weixin.qq.com//cgi-bin/message/mass/delete?access_token={0}，应该是多了一个/
const string urlFormat = "https://api.weixin.qq.com/cgi-bin/message/mass/delete?access_token={0}";
var data = new
{
msgid = mediaId
};
return CommonJsonSend.Send<WxJsonResult>(accessToken, urlFormat, data);
}
}
}멀티미디어 인터페이스
멀티미디어 인터페이스 사진, 음성, 그래픽 메시지 등의 멀티미디어 정보를 업로드하는 데 사용됩니다. 일반적으로 이러한 정보는 고객 서비스 인터페이스 또는 그룹 전송에 사용될 수 있습니다.
소스 파일 폴더: Senparc.Weixin.MP/AdvancedAPIs/Media
소스 코드의 관련 메소드는 다음과 같습니다.
namespace Senparc.Weixin.MP.AdvancedAPIs
{
//接口详见：http://mp.weixin.qq.com/wiki/index.php?title=%E4%B8%8A%E4%BC%A0%E4%B8%8B%E8%BD%BD%E5%A4%9A%E5%AA%92%E4%BD%93%E6%96%87%E4%BB%B6
/// <summary>
/// 多媒体文件接口
/// </summary>
public static class Media
{
/// <summary>
/// 上传媒体文件
/// </summary>
/// <param name="accessToken"></param>
/// <param name="type"></param>
/// <param name="file"></param>
/// <returns></returns>
public static UploadResultJson Upload(string accessToken, UploadMediaFileType type, string file)
{
var url = string.Format("http://file.api.weixin.qq.com/cgi-bin/media/upload?access_token={0}&type={1}", accessToken, type.ToString());
var fileDictionary = new Dictionary<string, string>();
fileDictionary["media"] = file;
return HttpUtility.Post.PostFileGetJson<UploadResultJson>(url, null, fileDictionary, null);
}
/// <summary>
/// 下载媒体文件
/// </summary>
/// <param name="accessToken"></param>
/// <param name="mediaId"></param>
/// <param name="stream"></param>
public static void Get(string accessToken, string mediaId, Stream stream)
{
var url = string.Format("http://file.api.weixin.qq.com/cgi-bin/media/get?access_token={0}&media_id={1}",
accessToken, mediaId);
HttpUtility.Get.Download(url, stream);
}
/// <summary>
/// 上传图文消息素材
/// </summary>
/// <param name="accessToken">Token</param>
/// <param name="news">图文消息组</param>
/// <returns></returns>
public static UploadMediaFileResult UploadNews(string accessToken, params NewsModel[] news)
{
const string urlFormat = "https://api.weixin.qq.com/cgi-bin/media/uploadnews?access_token={0}";
var data = new
{
articles = news
};
return CommonJsonSend.Send<UploadMediaFileResult>(accessToken, urlFormat, data);
}
}
}QR 코드 인터페이스
QR 코드 인터페이스를 사용하여 QR 코드를 쉽게 생성하고 확인할 수 있습니다. 생성된 QR 코드는 사용자가 스캔 중인 장면에 집중하거나 식별할 수 있도록 하는 데 사용됩니다.
소스 파일 폴더: Senparc.Weixin.MP/AdvancedAPIs/QrCode
소스 코드의 관련 메소드는 다음과 같습니다.
namespace Senparc.Weixin.MP.AdvancedAPIs
{
//API：http://mp.weixin.qq.com/wiki/index.php?title=%E7%94%9F%E6%88%90%E5%B8%A6%E5%8F%82%E6%95%B0%E7%9A%84%E4%BA%8C%E7%BB%B4%E7%A0%81
/// <summary>
/// 二维码接口
/// </summary>
public static class QrCode
{
/// <summary>
/// 创建二维码
/// </summary>
/// <param name="expireSeconds">该二维码有效时间，以秒为单位。 最大不超过1800。0时为永久二维码</param>
/// <param name="sceneId">场景值ID，临时二维码时为32位整型，永久二维码时最大值为1000</param>
/// <returns></returns>
public static CreateQrCodeResult Create(string accessToken, int expireSeconds, int sceneId)
{
var urlFormat = "https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token={0}";
object data = null;
if (expireSeconds > 0)
{
data = new
{
expire_seconds = expireSeconds,
action_name = "QR_SCENE",
action_info = new
{
scene = new
{
scene_id = sceneId
}
}
};
}
else
{
data = new
{
action_name = "QR_LIMIT_SCENE",
action_info = new
{
scene = new
{
scene_id = sceneId
}
}
};
}
return CommonJsonSend.Send<CreateQrCodeResult>(accessToken, urlFormat, data);
}
/// <summary>
/// 获取二维码（不需要AccessToken）
/// 错误情况下（如ticket非法）返回HTTP错误码404。
/// </summary>
/// <param name="ticket"></param>
/// <param name="stream"></param>
public static void ShowQrCode(string ticket, Stream stream)
{
var urlFormat = "https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket={0}";
HttpUtility.Get.Download(string.Format(urlFormat, ticket), stream);
}
}
}템플릿 메시지 인터페이스
템플릿 메시지는 SMS 알림과 유사하며 특정 템플릿 형식(그래픽 및 문자 메시지와 다름)을 따르며 확인된 모든 서비스 계정에서 얻을 수 없습니다.
소스 파일 폴더: Senparc.Weixin.MP/AdvancedAPIs/TemplateMessage
소스 코드의 관련 메소드는 다음과 같습니다.
namespace Senparc.Weixin.MP.AdvancedAPIs
{
/// <summary>
/// 模板消息接口
/// </summary>
public static class Template
{
public static WxJsonResult SendTemplateMessage<T>(string accessToken, string openId, string templateId, string topcolor, T data)
{
const string urlFormat = "https://api.weixin.qq.com/cgi-bin/message/template/send?access_token={0}";
var msgData = new TempleteModel()
{
template_id = templateId,
topcolor = topcolor,
touser = openId,
data = data
};
return CommonJsonSend.Send<WxJsonResult>(accessToken, urlFormat, msgData);
}
}
}OAuth2.0 인터페이스
OAuth 인터페이스는 WeChat 내장 브라우저를 사용하여 접속한 사용자의 신원을 안전하게 확인하는 데 사용됩니다(예: OpenId 획득)
소스 파일 폴더: Senparc.Weixin.MP/AdvancedAPIs/OAuth
다른 인터페이스 OAuth2.0과 비교하면 약간 복잡합니다.
더 많은 WeChat 공개 플랫폼 개발: 고급 인터페이스 설명 관련 기사는 PHP 중국어 웹사이트를 주목하세요!
성명：
본 글의 내용은 네티즌들의 자발적인 기여로 작성되었으며, 저작권은 원저작자에게 있습니다. 본 사이트는 이에 상응하는 법적 책임을 지지 않습니다. 표절이나 침해가 의심되는 콘텐츠를 발견한 경우 admin@php.cn으로 문의하세요.