个微API接口

 API接口的核心

对于小白而言，初看API文档可能是一头雾水的——从哪里看，怎么看，看什么是摆在面前的问题。

其实对于产品经理而言，我们应该更关注这个公司可以提供什么样的API接口服务，比如我知道高德可以提供地图API，规划路线的API，这样的话在我们设计功能和工作中就可以想到调用他们的服务或者参考。

所以产品小白们看不懂也不用过于担心，未来工作中你也会更深入了解清楚，因为看懂并不复杂，以下是API接口的核心点，所有的说明文档离不开这5个核心点。

以下说明均以微信开放平台为例说明，文末有各开放平台的地址，大家有空可以去学习。

1. 接口地址

2. 请求参数（报文）

3. 返回结果

    （1）成功

    （2）失败

四、API接口的应用

测试地址：E云管家 微信个人号开发

 

请求URL：

• http://域名/agreeAddChatRoomMember

请求方式：

• POST

请求头Headers：

• Content-Type：application/json
• Authorization：login接口返回

参数：

参数名	必选	类型	说明
wId	是	String	登录实例标识
chatRoomId	是	String	群id
newMsgId	是	number	入群邀请回调返回newmMsgid
xml	是	String	入群邀请的回调xml

请求参数示例

{
    "wId": "2c7a5bf6-e23d-4fb0-8f03-b90e844b539f",
    "chatRoomId": "18061832422@chatroom",
    "newMsgId": 7175333311063873621,
    "xml":"<sysmsg type=\"NewXmlChatRoomAccessVerifyApplication\">\n\t<NewXmlChatRoomAccessVerifyApplication>\n\t\t<text><![CDATA[\"朝夕\"想邀请1位朋友加入群聊]]></text>\n\t\t<link>\n\t\t\t<scene>roomaccessapplycheck_approve</scene>\n\t\t\t<text><![CDATA[  去确认]]></text>\n\t\t\t<ticket><![CDATA[AQAAAAEAAAAYoqpRKaJIGP+bvAGdxtKlyNkkBVxU4H4VjouTQFRqPDcWj8jNkBE/MSS9AQs1tk/deahMXMaXyL02CI54LTyctebq3g==]]></ticket>\n\t\t\t<invitationreason><![CDATA[8888888]]></invitationreason>\n\t\t\t<inviterusername><![CDATA[zhangchuan2288]]></inviterusername>\n\t\t\t<memberlist>\n\t\t\t\t<memberlistsize>1</memberlistsize>\n\t\t\t\t<member>\n\t\t\t\t\t<username><![CDATA[wxid_phyyedw9xap22]]></username>\n\t\t\t\t\t<nickname><![CDATA[我们一起笑。]]></nickname>\n\t\t\t\t\t<headimgurl><![CDATA[http://wx.qlogo.cn/mmhead/ver_1/QVH2YybBlUaH18IX7UC3YYpX2GFdUgK7sVdjGIzzyMH6FBoGx53Pv7R7netr5tzw4g8icTy4HrP4UrA3easfjjlzBP8iccUUVlQCFJ3y8fNfU/132]]></headimgurl>\n\t\t\t\t</member>\n\t\t\t</memberlist>\n\t\t</link>\n\t\t<RoomName><![CDATA[18061832422@chatroom]]></RoomName>\n\t</NewXmlChatRoomAccessVerifyApplication>\n</sysmsg>"
}

成功返回示例

{
    "message": "成功",
    "code": "1000",
    "data": null
}

错误返回示例

{
    "message": "失败",
    "code": "1001",
    "data": null
}

返回数据：

参数名	类型	说明
code	String	1000成功 1001失败
msg	String	反馈信息
data	JSONObject