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

资助包维护!
Patreon

3.19.3 2022-01-11 02:04 UTC

README

Latest Stable Version Total Downloads


v3已发布!

Scribe帮助您从您的Laravel/Lumen/Dingo代码库生成面向人类的API文档。在demo.scribe.knuckles.wtf查看实时示例。还有一个Node.js版本

特性

  • 美观的单页HTML文档,包含人性化的文本、代码示例,并包含浏览器内API测试器(“试试”)
  • 从FormRequests或验证规则中提取身体参数详情
  • 安全调用API端点以获取示例响应
  • 支持从Transformers或Eloquent API Resources生成响应
  • 生成Postman集合和OpenAPI规范
  • 易于使用自定义视图和内置UI组件进行自定义
  • 易于通过自定义策略进行扩展
  • 静态定义不在代码库中的额外端点

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

文档

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

v2文档(PHP 7.2+,不再积极维护)在scribe.rtfd.io

如果您来自mpociot/laravel-apidoc-generator,请查看迁移指南

贡献

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