mirror of
https://github.com/GrandDuke1106/AutoApiSS.git
synced 2024-12-22 08:46:25 -05:00
202 lines
12 KiB
Markdown
202 lines
12 KiB
Markdown
# 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/)的**原理说明、设计理念**。
|
||
* **不保证一定能续期！不保证一定能续期！不保证一定能续期**！或者说，**只是增大续订可能性**。过期前、后30天都可能续期！！！
|
||
* 若理解并接受上述说明，请接着操作；**若否，请点击浏览器右上角 X 。**
|
||
|
||
### 项目说明 ###
|
||
* 全自定义版本
|
||
* 支持多账号、随机时间调用、api随机抽取排序、副应用模式等
|
||
|
||
### 特别说明/Thanks ###
|
||
* 原教程博主-黑幕（酷安id-Paran）：https://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本项目的代码到你自己的账号，然后你账号下会出现一个一模一样的项目，接下来的操作均在你的这个项目下进行。（看不到图片/图裂请科学上网）
|
||
|
||
|
||
|
||
* 根据[原教程](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后，留意结尾不要留空格或者空行
|
||
|
||
|
||
|
||
再然后把你项目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应用机密']
|
||
```
|
||
|
||
|
||
最终格式应该是类似这样的：
|
||
|
||
|
||
|
||
* 第四步，修改参数配置
|
||
|
||
你项目的testapi.py文件第15行有个config_list，更改相应选项完成配置（**看不懂可直接掠过**）
|
||
|
||
|
||
|
||
各参数说明：
|
||
* 每次轮数：每启动一次运行多少轮api调用，一轮调用10个api
|
||
|
||
* 是否启动随机时间：每一轮结束隔“多久”才开始下一轮调用，这个“多久”会根据后面的参数随机生成
|
||
|
||
* 延时范围起始，结束：例如设置600跟1200，则“多久”会在600到1200秒这个范围随机生成一个数，到时间开启下一轮调用
|
||
|
||
* 是否开启随机api顺序:根据一定规则从28个api抽13个随机排序，我设置的是30天换一次顺序。不开启则默认原教程10个api。
|
||
|
||
* 是否开启各api延时：就是每个api调用要不要停一下才开始下一个api调用。（个人建议不开）
|
||
|
||
同样有范围，例如：api延时范围开始跟api延时结束分别设置为10，20.则会在10到20秒这个范围随机生成一个数，然后调用下一个api
|
||
|
||
* 是否开启各账号延时：就是每个账号调用要不要停一下才开始下一个账号调用。
|
||
|
||
同样有范围，例如：账号延时范围开始跟分结束分别设置为60，120.则会在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,
|
||
|
||
|
||
|
||
|
||
设置名字为GITHUB_TOKEN , 然后勾选 repo , admin:repo_hook , workflow 等选项，最后点击Generate token即可。
|
||
|
||
|
||
|
||
|
||
|
||
* 第六步，点击右上角星星/star立马调用一次，再点击上面的Action就能看到每次的运行日志，看看运行状况
|
||
|
||
（必需点进去Test Api看下，api有没有调用到位，有没有出错。外面的Auto Api打勾只能说明运行是正常的，我们还需要确认10个api调用成功了，就像图里的一样。如果少了几个api，要么是注册应用的时候赋予api权限没弄好；要么是没登录激活onedrive，登录激活一下）
|
||
|
||
|
||
|
||
* 第七步，没出错的话，就搞定啦！！再看看下面的定时次数要不要修改，不打算改就忽略。
|
||
|
||
**然后第二天回来确认下是否自动运行了（ation里是否多出来几个）**,是的话就不用管了，完结。
|
||
|
||
我设定的每天9、13、16点自动运行一次（点击右上角星星/star也可以立马调用一次），你们自行斟酌修改（我也不知道保持活跃要调用多少次、多久）：
|
||
|
||
* 定时自动启动修改地方：（在.github/workflow/autoapi.yml文件里，自行百度cron定时任务格式，最短每5分钟一次）
|
||
|
||
|
||
|
||
------------------------------------------------------------
|
||
### 题外话 ###
|
||
> 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-卷腿毛菌
|
||
|
||
|