knuckleswtf/scribe

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

资助包维护!
Patreon

安装数: 6,081,286

依赖者: 18

建议者: 0

安全性: 0

星星: 1,697

关注者: 17

分支: 303

开放问题: 83

4.37.2 2024-08-30 12:15 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

贡献

贡献很简单!请参阅我们的贡献指南