接口介绍
基础信息
草图大全是由 YanJi 开发的综合生草图片社区,目前由 NLR DevTeam 的成员参与本站运营维护。
站点成立于 2021 年,自建立以来,我们以强迫症的高标准维护着一个全网优质的生草图库,其内容涵盖游戏、代码、生活等各方面,致力于优质草图的产出、汉化与收集,并稳定运行草图服务接口。
使用草图服务接口前,请先仔细阅读并同意我们的《草图服务条款》。
接口介绍
基于 NLR DevTeam「开放共享」的理念,我们为开发者开放了草图服务接口的调用文档。您可以阅读此文档,并快速在您的应用中接入草图的服务。草图全接口以 HTTP 协议为基础,支持在所有主流技术中调用。
请合理合规地调用我们的公开接口,任何违反条款的行为将可能导致您被我们加入黑名单。
开发者模式
为便于开发者调试接口,草图服务接口已上线「开发者模式」。
在请求任意接口时,添加 GET 参数 devmode
,设置其值为任意非空字符串。
若您在响应标头中看到 is-grass-dev-mode: true
,则代表接口正在开发者模式下运行。
> 功能 1:模拟请求错误
在请求任意接口时添加 GET 参数
devmode
。设置其值为下表所示的内容。
参数值 模拟情况 normal
正常运行 stopped
停止服务 banned
您已被加入黑名单 limited
您已被限流 error
出现其他错误 即可模拟相应的异常情况进行请求。
> 功能 2:模拟返回内容而不实际执行
在开发者模式下,进行的请求只会得到模拟响应,不会真正执行。
例如调试投稿接口时,开启开发者模式后,上传的图片不会被实际加入审核队列,方便大家开发时进行调试,同时避免因投稿大量无意义图片被加入黑名单。
> 功能 3:防止调试时受到限流
使用开发者模式请求 info
和 upload
接口时,您将会得到 dev01
- dev03
三张开发者测试图片,可以方便大家在不消耗限流值的情况下进行调试,防止短期内请求过多导致被限流或封禁
> 注意事项
- 明显滥用开发者模式进行攻击的行为将导致您被永久封禁。
- 判断为官方应用的请求(包括官网/Android客户端/Windows客户端)暂不能使用开发者模式,请官方开发者移步查看管理组内 PDF 版本的文档
现有服务
如需在 QQ 群聊中接入草图,您可以直接使用我们开发的官方 Mirai Console Loader 插件 👇
https://github.com/NLR-DevTeam/GrassPictures