mirror of
https://github.com/GrandDuke1106/AutoApiSS.git
synced 2024-09-07 12:44:16 -04: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/)的**原理说明、设计理念**。参考[此链接](https://www.ioiox.com/archives/103.html)
|
||
* **不保证一定能续期!不保证一定能续期!不保证一定能续期**!或者说,**只是增大续订可能性**。过期前、后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本项目的代码到你自己的账号,然后你账号下会出现一个一模一样的项目,接下来的操作均在你的这个项目下进行。(看不到图片/图裂请科学上网)
|
||
|
||
![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延时结束分别设置为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,
|
||
|
||
![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-卷腿毛菌
|
||
|
||
|