企业微信api使用

获取access_token是调用企业微信API接口的第一步，相当于创建了一个登录凭证，其它的业务API接口，都需要依赖于access_token来鉴权调用者身份。
本次获取access_token是创建日程用的：https://developer.work.weixin.qq.com/devtool/interface/alone?id=18555

请求方式： POST（HTTPS）
请求地址： https://qyapi.weixin.qq.com/cgi-bin/oa/********/add?access_token=ACCESS_TOKEN
ACCESS_TOKEN使用自己生成的，有时效

时间戳转换工具网页版 https://www.beijing-time.org/shijianchuo/

**这里使用的post是工具是win10系统自带的**  [win10中用PowerShell调用HTTP post 接口](/project-2/doc-270/ "win10中用PowerShell调用HTTP post 接口")

#### 实例：企业微信api-用手机号获取userid
官方文档：https://developer.work.weixin.qq.com/document/path/95402
```
Invoke-WebRequest -UseBasicParsing https://qyapi.weixin.qq.com/cgi-bin/user/getuserid?access_token=ACCESS_TOKEN -ContentType "application/json" -Method POST -Body '{"mobile": "18866669999"}'
```

#### 企微api创建创建日历
https://developer.work.weixin.qq.com/document/path/93647
```
Invoke-WebRequest -UseBasicParsing https://qyapi.weixin.qq.com/cgi-bin/oa/calendar/add?access_token=ACCESS_TOKEN -ContentType "application/json" -Method POST -Body '
{
	"calendar": {
		"admins":[
				"ZhangSan"
		],
		"set_as_default": 1,
		"summary": "test_summary",
		"color": "#FF3030",
		"description": "test_describe",
		"shares": [{
				"userid": "ZhangSan"
			},
			{
				"userid": "LiSi",
			}
		],
		"is_public": 1,
		"public_range": {
			"userids": ["ZhangSan", "LiSi"],
			"partyids": [1232, 34353]
		},
		"is_corp_calendar": 1
	},
	"agentid": 1000027
}'

```

返回结果：
```
StatusCode        : 200
StatusDescription : OK
Content           : {"errcode":0,"errmsg":"ok","cal_id":"wcjJaHCAAAaX_A3_zGhs_bkkmgjd6688"}
RawContent        : HTTP/1.1 200 OK
                    Connection: keep-alive
                    Error-Code: 0
                    Error-Msg: ok
                    Content-Length: 71
                    Content-Type: application/json; charset=UTF-8
                    Date: Wed, 28 Dec 2022 09:13:08 GMT
                    Server: nginx

{"errcod...
Forms             :
Headers           : {[Connection, keep-alive], [Error-Code, 0], [Error-Msg, ok], [Content-Length, 71]...}
Images            : {}
InputFields       : {}
Links             : {}
ParsedHtml        :
RawContentLength  : 71

```

#### 企微日历创建创建日程
https://developer.work.weixin.qq.com/document/path/93648

```
Invoke-WebRequest -UseBasicParsing https://qyapi.weixin.qq.com/cgi-bin/oa/schedule/add?access_token=ACCESS_TOKEN -ContentType "application/json" -Method POST -Body '{
	"schedule": {
		"admins":[
				"ZhangSan"
		],
		"start_time": 1672279261,
		"end_time": 1672281001,
		"attendees": [{
			"userid": "ZhangSan"
		}],
		"summary": "需求评审会议",
		"description": "2.0版本需求初步评审",
		"reminders": {
			"is_remind": 1,
			"remind_before_event_secs": 3600,
			"is_repeat": 1,
			"repeat_type": 7,
			"repeat_until": 1672281001,
			"is_custom_repeat": 1,
			"repeat_interval": 1,
			"repeat_day_of_week": [3, 7],
			"repeat_day_of_month": [10, 21],
			"timezone": 8
		},
		"location": "测试",
		"cal_id": "wcjJaHCAAAaX_A3_zGhs_bkkmgjd6688"
	},
	"agentid": 1000027
}'
```

返回结果：
```
StatusCode        : 200
StatusDescription : OK
Content           : {"errcode":0,"errmsg":"ok","schedule_id":"15451f4accf9af139b756f4d9b69abcd"}
RawContent        : HTTP/1.1 200 OK
                    Connection: keep-alive
                    Error-Code: 0
                    Error-Msg: ok
                    Content-Length: 76
                    Content-Type: application/json; charset=UTF-8
                    Date: Wed, 28 Dec 2022 09:33:02 GMT
                    Server: nginx

{"errcod...
Forms             :
Headers           : {[Connection, keep-alive], [Error-Code, 0], [Error-Msg, ok], [Content-Length, 76]...}
Images            : {}
InputFields       : {}
Links             : {}
ParsedHtml        :
RawContentLength  : 76
```