AutoApiSS/README.md
2023-06-06 18:44:24 +08:00

202 lines
12 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# AutoApiS-超级版
AutoApi系列AutoApi、AutoApiSecret、AutoApiSR、AutoApiS
# 置顶 #
* 本项目是建立在[原教程](https://blog.432100.xyz/index.php/archives/50/)可以正确调用api的**假设**上的核心是paran/黑幕大佬的py脚本。
* 本项目只是提供一个自动、免费、无需额外设备的脚本运行方式,换句话说,**借用github的电脑/服务器来干活**。(因为原教程需要服务器/超长时间运转的设备,大部分人都不具备,本项目应运而生)
* 本项目运行依赖**github action**服务此功能github固有而**非私人提供**的服务器且整个运行过程只涉及你与github。
* 请务必先阅读理解[原教程](https://blog.432100.xyz/index.php/archives/50/)的**原理说明、设计理念**。参考[此链接](https://www.ioiox.com/archives/103.html)
* **不保证一定能续期!不保证一定能续期!不保证一定能续期**!或者说,**只是增大续订可能性**。过期前、后30天都可能续期
* 若理解并接受上述说明,请接着操作;**若否,请点击浏览器右上角 X 。**
### 项目说明 ###
* 全自定义版本
* 支持多账号、随机时间调用、api随机抽取排序、副应用模式等
### 特别说明/Thanks ###
* 原教程博主-黑幕酷安id-Paranhttps://blog.432100.xyz/index.php/archives/50/
* 普通版地址https://github.com/wangziyingwen/AutoApi
* 加密版地址推荐https://github.com/wangziyingwen/AutoApiSecret
* 模仿人为应用开发版包含升级步骤https://github.com/wangziyingwen/AutoApiSR
* 超级版地址: https://github.com/wangziyingwen/AutoApiS
* **常见错误及解决办法/更新日志**https://github.com/wangziyingwen/Autoapi-test
* 网页获取refresh_token小工具不建议使用https://github.com/wangziyingwen/GetAutoApiToken
* 视频教程:(我操作很慢,自行倍速/快进Secret版的教程将就看吧
* 在线/下载地址https://kino-onemanager.herokuapp.com/Video/AutoApi%E6%95%99%E7%A8%8B.mp4?preview
* B站https://www.bilibili.com/video/av95688306/
### 区别 ###
[普通版(弃用)](https://github.com/wangziyingwen/AutoApi):密钥暴露,不在乎的话可以使用
[加密版(推荐)](https://github.com/wangziyingwen/AutoApiSecret)应用id机密加密隐藏提高安全性
[模仿人为应用开发版(半弃用)](https://github.com/wangziyingwen/AutoApiSR):顾名思义,加密版的升级版。由于超级版兼容模拟版的功能,此版本处于一种尴尬位置。(当然也可以正常使用)
[超级版(不建议)](https://github.com/wangziyingwen/AutoApiS):进一步升级版,增加自定义参数、模式。按目前情况,微软续订要求很低,暂时不需要使用此项目。
**以上推荐/不建议等只是个人意见,请自行选择版本,可同时使用**
--------------------------------------------------------------
### 步骤 ###
*** **有错误/问题请看**: [常见错误及解决办法/更新日志](https://github.com/wangziyingwen/Autoapi-test) ***
* 第一步,先大致浏览[原教程](https://blog.432100.xyz/index.php/archives/50/)了解如何获取应用id、机密、refresh_token 3样东西以方便接下来的操作。
* 第二步,登陆/新建github账号回到本项目页面点击右上角fork本项目的代码到你自己的账号然后你账号下会出现一个一模一样的项目接下来的操作均在你的这个项目下进行。看不到图片/图裂请科学上网)
![image](https://github.com/wangziyingwen/ImageHosting/blob/master/AutoApi/fork.png)
* 根据[原教程](https://blog.432100.xyz/index.php/archives/50/)获取应用id、机密、refresh_token自己复制保存注意区分id机密千万别弄混了
**注意**
**赋予api权限的时候选择以下几个**
Calendars.ReadWrite、Contacts.ReadWrite、Directory.ReadWrite.All、
Files.ReadWrite.All、MailboxSettings.Read、Mail.ReadWrite、
Notes.ReadWrite.All、People.Read.All、Sites.ReadWrite.All、
Tasks.ReadWrite、User.ReadWrite.All
在你电脑上新建多个txt文本例如你有两个账号则账号 0 对应为 0.txt , 账号 1 对应为 1.txt , 以此类推。(只有一个账号则只需一个0.txt一定要从0开始数)
再把各个账号对应的refresh_token粘贴进对应的txt文件。
> refresh_token位置如图下。复制refresh_token紧接着的双引号里的内容红竖线框起来的不要把双引号复制进去。复制进txt后留意结尾不要留空格或者空行
![image](https://github.com/wangziyingwen/ImageHosting/blob/master/AutoApi/token地方.png)
再然后把你项目token文件夹里的文件全删掉记得点commint确认删除再把你的0.txt...n.txt上传到token文件夹下。
* 第三步,依次点击上栏 Setting > Secrets > Add a new secret新建两个secret如图ID_LIST、KEY_LIST 。
内容分别如下: ( 把账号X应用id改成你账号X的应用id , 账号X应用机密改成你账号X的机密直接替换单引号里的内容单引号不要动 )
(需要配置更多账号的话,以此类推,直接复制增加;如果**只需一个账号,则 id_list = [r'账号0应用id']** )
**注意所有符号均是英文条件下的符合**
ID_LIST
```shell
id_list = [r'账号0应用id',r'账号n应用id']
```
KEY_LIST
```shell
secret_list = [r'账号0应用机密',r'账号n应用机密']
```
![image](https://github.com/wangziyingwen/ImageHosting/blob/master/AutoApi/机密2.png)
最终格式应该是类似这样的:
![image](https://github.com/wangziyingwen/ImageHosting/blob/master/AutoApi/格式2.png)
* 第四步,修改参数配置
你项目的testapi.py文件第15行有个config_list更改相应选项完成配置**看不懂可直接掠过**
各参数说明:
* 每次轮数每启动一次运行多少轮api调用一轮调用10个api
* 是否启动随机时间:每一轮结束隔“多久”才开始下一轮调用,这个“多久”会根据后面的参数随机生成
* 延时范围起始结束例如设置600跟1200则“多久”会在600到1200秒这个范围随机生成一个数到时间开启下一轮调用
* 是否开启随机api顺序:根据一定规则从28个api抽13个随机排序我设置的是30天换一次顺序。不开启则默认原教程10个api。
* 是否开启各api延时就是每个api调用要不要停一下才开始下一个api调用。个人建议不开
同样有范围例如api延时范围开始跟api延时结束分别设置为1020.则会在10到20秒这个范围随机生成一个数然后调用下一个api
* 是否开启各账号延时:就是每个账号调用要不要停一下才开始下一个账号调用。
同样有范围例如账号延时范围开始跟分结束分别设置为60120.则会在60到120秒这个范围随机生成一个数然后调用下一个账号
* 是否开启备用应用更换应用id调用api。同样每30天更换一次应用id。目前每个账号只至支持1个副应用
开启后需分别为各账号再注册一个应用然后在设置的secret再增加两条
ID_LIST2
内容为: id_list2=[r'帐号1副应用id',r'帐号n副应用id']
KEY_LIST2
内容为: secret_list2=[r'帐号1副应用机密',r'帐号n副应用机密']
然后类似的在backuptoken文件夹里放入对应的副应用的0.txt....n.txt。
这里看不懂的话直接选N吧
* 是否开启测试瞬间完成运行以便查看id、机密、token等是否填写错误能否正确运行。
若配合备用应用模式使用则会同时测试各账号的主副应用看看主副应用是否都能成功调用api
测试完务必改回N
* 第五步,进入你的个人设置页面(右上角头像 Settings不是仓库里的 Settings),选择 Developer settings > Personal access tokens > Generate new token,
![image](https://github.com/wangziyingwen/ImageHosting/blob/master/AutoApi/Settings.png)
![image](https://github.com/wangziyingwen/ImageHosting/blob/master/AutoApi/token.png)
设置名字为GITHUB_TOKEN , 然后勾选 repo , admin:repo_hook , workflow 等选项最后点击Generate token即可。
![image](https://github.com/wangziyingwen/ImageHosting/blob/master/AutoApi/repo.png)
![image](https://github.com/wangziyingwen/ImageHosting/blob/master/AutoApi/adminrepo.png)
![image](https://github.com/wangziyingwen/ImageHosting/blob/master/AutoApi/workflow.png)
* 第六步,点击右上角星星/star立马调用一次再点击上面的Action就能看到每次的运行日志看看运行状况
必需点进去Test Api看下api有没有调用到位有没有出错。外面的Auto Api打勾只能说明运行是正常的我们还需要确认10个api调用成功了就像图里的一样。如果少了几个api要么是注册应用的时候赋予api权限没弄好要么是没登录激活onedrive登录激活一下
![image](https://github.com/wangziyingwen/ImageHosting/blob/master/AutoApi/日志.png)
* 第七步,没出错的话,就搞定啦!!再看看下面的定时次数要不要修改,不打算改就忽略。
**然后第二天回来确认下是否自动运行了ation里是否多出来几个**,是的话就不用管了,完结。
我设定的每天9、13、16点自动运行一次点击右上角星星/star也可以立马调用一次你们自行斟酌修改我也不知道保持活跃要调用多少次、多久
* 定时自动启动修改地方:(在.github/workflow/autoapi.yml文件里自行百度cron定时任务格式最短每5分钟一次
![image](https://github.com/wangziyingwen/ImageHosting/blob/master/AutoApi/定时.png)
------------------------------------------------------------
### 题外话 ###
> Api调用
你们可以自己去graph浏览器看一下学着自己修改要调用什么api(最重要的是调用outlook、onedrive)
https://developer.microsoft.com/zh-CN/graph/graph-explorer/preview
### GithubAction介绍 ###
提供的虚拟环境:
· 2-core CPU
· 7 GB RAM 内存
· 14 GB SSD 硬盘空间
使用限制:
* 每个仓库只能同时支持20个 workflow 并行。
* 每小时可以调用1000次 GitHub API 。
* 每个 job 最多可以执行6个小时。
* 免费版的用户最大支持20个 job 并发执行macOS 最大只支持5个。
* 私有仓库每月累计使用时间为2000分钟超过后$ 0.008/分钟,公共仓库则无限制。
我们这里用的公共仓库按理你们可以设定无限循环调用然后6小时启动一次保证24小时全天候调用
### 最后 ###
教程很直白了,应该都会弄吧!
代码小白,多包涵!有问题/修改建议可以点击上方issues发布一下或者PY给我:
wz.lxh@outlook.com
Q群[657581700](https://jq.qq.com/?_wv=1027&k=5FQJbWmV) (项目相关讨论)
tg群[OneDrive E5](https://t.me/joinchat/OLlK9RsbBlmTYOJS_BU4Mg) **非项目相关**讨论!**tg可能不会及时在线回答问题**任何项目相关的问题或出错请进Q群/邮箱/issue
最后的最后,再次感谢黑幕/paran大佬
————wangziyingwen/酷安id-卷腿毛菌