metafox / scribe

从您的Laravel代码库生成面向人类的API文档。✍

维护者

详细信息

github.com/metafoxapp/scribe

主页

源码

资助包维护!
Patreon

v4.22.1 2023-07-26 07:37 UTC

README

Latest Stable Version Total Downloads


v4已发布!功能包括子组、易于排序和自动升级命令。

Scribe帮助您从Laravel/Lumen/ Dingo 代码库生成面向人类的API文档。请查看demo.scribe.knuckles.wtf上的实时示例。

功能

  • 有用的输出
    • 漂亮的单页HTML文档,包含易于理解的文字、代码示例和浏览器中的API测试器(“试一试”)
    • 生成Postman集合和OpenAPI规范
  • 智能。Scribe可以做
    • 从FormRequests或验证规则中提取请求参数细节
    • 安全地调用API端点以获取示例响应
    • 从Eloquent API资源或转换器生成示例响应
  • 可自定义到不同级别
    • 通过调整文本、排序、示例或更改UI本身来自定义UI
    • 添加自定义策略以调整数据提取方式
    • 静态定义额外的端点或不在代码库中的信息

👋 Scribe可以帮助您自动生成文档,但如果您真的想制作友好、可维护和可测试的API文档,还有一些其他事情您需要知道。所以我为您制作了一门课程。🤗

文档

请查看scribe.knuckles.wtf/laravel上的文档。

如果您来自mpociot/laravel-apidoc-generator,首先迁移到v3,然后迁移到v4

贡献

贡献很容易!请参阅我们的贡献指南