![图片[1]-宇柒云阁-开发文档-宇柒云阁](https://www.yuqiee.com/wp-content/uploads/2024/03/2024032104272871-1024x432.png)
前言
本开发文档专为参与宇柒云阁APP开发与维护的团队成员以及对此感兴趣的开发者精心编撰，旨在以明晰易懂的语言揭示我们在设计与实现过程中遵循的请求规则体系，以及背后的战略意图和整体设计思路。这份文档不仅是技术参考的桥梁，更是理解宇柒云阁APP内部工作原理和前期规划决策的重要窗口，力求帮助每位读者透彻理解我们的设计初衷与技术实践，从而更好地参与到项目的迭代与优化工作中，共同推动宇柒云阁APP向更高水平发展。
宇柒云阁官方协议规则
传输方式：HTTP
数据格式：JSON
字符编码：UTF-8
用户登录
此接口可用于向服务器后端发起登录请求，会返回用户的账户数据。
URL地址：https://api.yuqios.com/index.php?eti=yhdl&userid=宇柒云阁的账号ID
请求方式：POST
| 请求参数 | 请求方式 | 是否必填 | 请求内容 |
| zh | post | 是 | 用户账号 |
| mm | post | 是 | 用户密码 |
返回参数（JSON格式）：
| 参数名称 | 参数内容 | 备注 |
| code | 请求结果 | 成功是0，失败是-1 |
| msg | 请求反馈 | 返回失败原因 |
| id | 用户账号 | 正常是QQ邮箱 |
| mm | 用户密码 | |
| vip | 会员权限 | 默认0，最大1 |
| viptime | 权限到期 | 时间格式：20230809 |
| ip | 注册IP | 注册时候记录的IP |
| time | 注册时间 |
用户注册
此接口可用于向服务器后端发起注册账号请求，会返回注册成功的提示。
URL地址：https://api.yuqios.com/index.php?eti=yhzc&userid=宇柒云阁的账户ID
请求方式：POST
| 请求参数 | 请求方式 | 是否必填 | 请求内容 |
| zh | post | 是 | 用户账号 |
| mm | post | 是 | 用户密码 |
返回参数（JSON格式）：
| 参数名称 | 参数内容 | 备注 |
| code | 请求结果 | 成功是0，失败是-1 |
| msg | 请求反馈 | 返回提示 |
读取远程文档
此接口可用于向服务器后端发起远程文档读取请求，会返回远程文档的内容。
URL地址：https://api.yuqios.com/index.php?eti=dycs&userid=宇柒云阁账号的ID
请求方式：GET
| 请求参数 | 请求方式 | 是否必填 | 请求内容 |
| eti | get | 是 | 固定值：dycs |
| userid | get | 是 | 宇柒云阁账号的ID |
返回参数（TXT格式）：
直接返回静态文本，直接获取即可！
t()
{
sss user_zh="你的云阁ID"
ss("http://api.yuqios.com/index.php?eti=dycs&userid="+sss.user_zh,api)
hs(api,data)
ufnsui()
{
syso(data)
}
}
获取IP地址
此接口可用于向服务器后端发起GET请求，会返回用户当前的IP地址。
URL地址：https://api.yuqios.com/index.php?eti=ip
请求方式：GET
| 请求参数 | 请求方式 | 是否必填 | 请求内容 |
| eti | get | 是 | 固定值：ip |
返回参数（json格式）：
| 参数名称 | 参数内容 | 备注 |
| code | 请求结果 | 成功是0，失败是-1 |
| msg | 请求反馈 | 返回IP地址 |
t()
{
ss("http://api.yuqios.com/index.php?eti=ip",api2)
hs(api2,data2)
ufnsui()
{
json(data2,data2)
json(data2,"get","code",code)
f(code==-1)
{
json(data2,"get","msg",msg)
utw(null,"系统提示",msg,"好的",true,v)
{
endutw()
}
}
else f(code==0)
{
json(data2,"get","msg",sss.ip)
syso(sss.ip)
}
else
{
utw(null,"系统提示","数据库链接错误，请尝试重启程序，若无效则请联系客服询问","好的",true,v)
{
endutw()
}
}
}
}访问统计
此接口可用于向服务器后端发起GET请求，会统计和输出当前的访问次数。
URL地址：https://api.yuqios.com/index.php?eti=usertj&userid=宇柒云阁账号的ID
请求方式：GET
| 请求参数 | 请求方式 | 是否必填 | 请求内容 |
| eti | get | 是 | 固定值：usertj |
| userid | get | 是 | 宇柒云阁账号的ID |
返回参数（TXT格式）：
直接返回静态文本，直接获取即可！
t()
{
sss user_zh="宇柒云阁账号的ID"
ss("http://api.yuqios.com/index.php?eti=usertj&userid="+sss.user_zh,api)
hs(api,data)
ufnsui()
{
syso(data)
}
}卡密接口
此接口可用于向服务器后端发起GET请求，会输出卡密使用结果。
URL地址：https://api.yuqios.com/index.php?eti=key_end&userid=宇柒云阁账号的ID&key=卡密
网页版后台：http://api.yuqios.com/kami_admin
请求方式：GET
| 请求参数 | 请求方式 | 是否必填 | 请求内容 |
| eti | get | 是 | 固定值：key_end |
| userid | get | 是 | 宇柒云阁账号的ID |
| key | get | 是 | 卡密 |
返回参数（json格式）：
| 参数名称 | 参数内容 | 备注 |
| code | 反馈请求是否成功 | 成功为0，失败为-1 |
| msg | 请求反馈 | 返回提示 |
t()
{
ug(控件ID,"text",kami)
sss user_zh="宇柒云阁账号的ID"
ss("http://api.yuqios.com/index.php?eti=key_end&userid="+sss.user_zh+"&key="+kami,api2)
hs(api2,data2)
ufnsui()
{
json(data2,data2)
json(data2,"get","code",code)
f(code==-1)
{
json(data2,"get","msg",msg)
utw(null,"系统提示",msg,"好的",true,v)
{
endutw()
}
}
else f(code==0)
{
json(data2,"get","msg",msg)
utw(null,"系统提示",msg,"好的",true,v)
{
endutw()
}
}
else
{
utw(null,"系统提示","数据库链接错误，请尝试重启程序，若无效则请联系客服询问","好的",true,v)
{
endutw()
}
}
}
}动态密码
此接口可用于向服务器后端发起GET请求，会输出卡密使用结果。
URL地址：https://api.yuqios.com/dongtai.php? userid=宇柒云阁账号的ID&api=true
请求方式：GET
| 请求参数 | 请求方式 | 是否必填 | 请求内容 |
| userid | get | 是 | 宇柒云阁账号的ID |
| api | get | 否 | 固定值：true |
返回参数（json格式）：
| 参数名称 | 参数内容 | 备注 |
| code | 反馈请求是否成功 | 成功为0，失败为-1 |
| time | 到期时间 | 当前密码的有效时间 |
| dtm | 动态码 | 当前有效动态码 |
使用方法：就是将地址（https://api.yuqios.com/dongtai.php?userid=宇柒云阁账号的ID）给用户访问，然后用户可以通过这个地址获得密码，再使用下方的代码让用户输入密码进入软件即可。
PS：这个密码是定时自动更新的，而本功能主要是用来打广告，广告在宇柒云阁中配置即可。
t()
{
ug(控件ID,"text",mm)
sss user_zh="宇柒云阁账号的ID"
ss("https://api.yuqios.com/dongtai.php? userid="+sss.user_zh+"&api=true",api2)
hs(api2,data2)
ufnsui()
{
json(data2,data2)
json(data2,"get","code",code)
f(code==-1)
{
json(data2,"get","msg",msg)
utw(null,"系统提示",msg,"好的",true,v)
{
endutw()
}
}
else f(code==0)
{
json(data2,"get","dtm",dtm)
f(mm==dtm)
{
utw(null,"系统提示","恭喜你！动态密码正确","好的",true,v)
{
endutw()
}
}
else
{
utw(null,"系统提示","抱歉！动态密码错误！","好的",true,v)
{
endutw()
}
}
}
else
{
utw(null,"系统提示","数据库链接错误，请尝试重启程序，若无效则请联系客服询问","好的",true,v)
{
endutw()
}
}
}
}调用QQ登录
此接口可用于向服务器后端发起GET请求，会输出登录者QQ的信息。
URL地址：https://api.yuqios.com/qq/
请求方式：直接访问链接即可。
返回参数（json格式）：
| 参数名称 | 参数内容 | 备注 |
| status | 反馈请求是否成功 | 成功为1，其他为失败 |
| msg | 请求反馈 | |
| QQ账号 | ||
| qqname | QQ名称 | |
| skey | ||
| pskey | QQ的一种密钥 | QQKey可以实现直接式登录QQ的各种业务； 权限相当与密码会更高,且无需进行各种号主认证 |
| superkey |
请登录后查看评论内容