GraphAPI 1.0中新增加的Teams API
这篇继续介绍BUILD大会里的内容：两个新加入GraphAPI 1.0的关于Teams的API。
这两个新增api是关于在频道Channel里发送消息和回复消息的。实际上这两个api在beta版本中早就已经加入，上个月build大会中公布的只是把这两个api正式发布到1.0版本，这意味着微软官方会对这两个api作长期的支持，这也意味着大家在生产环境可以使用了。 :)
我们先来看一下如何在一个channel里发送消息，使用如下的rest api。
POST /teams/{team-id}/channels/{channel-id}/messages
其中 team-id 就是channel所属的team的id， channel-id 就新消息要发送到的channel的id。
大家要注意的是这个rest api目前只是支持Delegated permission，并不支持Application permission，也就是说你以当前登入用户的身份来发送消息。需要申请的权限是：ChannelMessage.Send, Group.ReadWrite.All。
发送的内容(HTTP body)可以是一个简单的纯文字内容，如下：
{
"body": {
"content": "Hello！"
}
}
还可以发送一个 @ 某人的富文本消息，http body内容如下：
{
"body": {
"contentType": "html",
"content": "Hello <at id=\"0\">Tony</at>"
},
"mentions": [
{
"id": 0,
"mentionText": "Tony",
"mentioned": {
"user": {
"displayName": "Tony",
"id": "a01a899c-3e5f-4f0e-85b9-d75e24166e1a",
"userIdentityType": "aadUser"
}
}
}
]
}
还可以发送更加复杂的互动卡片，具体的内容，大家可以参考官方api文档。
回复一条消息的api和上面发送消息的api的权限一样ChannelMessage.Send, Group.ReadWrite.All，它目前也只是支持Delegated permission，并不支持Application permission。url是：
POST /teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies
message-id就是你需要回复的那条消息的id。
http body的内容和上面发送消息的body格式一样。api返回的内容如下。它实际上是一个message结构，具体内容可以参考这里。
{
"id": "message-id",
"messageType": "message",
"createdDateTime": "2020-01-01T00:11:22.333Z",
"lastModifiedDateTime": null,
"subject": null,
"summary": null,
"importance": "normal",
"locale": "en-us",
"policyViolation": null,
"from": {
"application": null,
"device": null,
"conversation": null,
"user": {
"displayName": "Tony",
"userIdentityType": "aadUser"
}
},
"body": {
"contentType": "html",
"content": "Hello!"
},
"attachments": [],
"mentions": [],
"reactions": []
}
参考：