Scribe可以帮助您自动生成文档,但是如果您真的想制作友好,可维护和可测试的API文档,则还需要了解更多信息。所以我为你做了一门课程。🤗

shalvah c1eaafd28b Complete Try It Out implementation пре 2 година
.github d2b152627e Merge branch 'master' into v4 пре 2 година
camel 9f63e32e69 Show JSON body in Try It Out пре 2 година
config 44996fe6f0 Support custom "Last updated at" label пре 2 година
resources c1eaafd28b Complete Try It Out implementation пре 2 година
routes 92c128171c Final cleanups пре 2 година
src b863862463 Show non-JSON body in Try It Out пре 2 година
tests 66492aabdd Support #[ResponseField] on API resources пре 2 година
.editorconfig c897db868e fix(.editorconfig): added formatter for .json files пре 3 година
.gitattributes c3a31009ba Support spatie/dto 3 пре 3 година
.gitignore ac9404ac12 Add tests for laravel type пре 2 година
.travis.yml c91eed5499 Update CI пре 3 година
CHANGELOG.md da89aed0e3 4.2.2 пре 2 година
CONTRIBUTING.md 6457ea46f4 Add contribution guide пре 5 година
LICENSE.md 561dac8003 Refactor пре 2 година
README.md 561dac8003 Refactor пре 2 година
composer.dingo.json 23a6583667 Refactor пре 2 година
composer.json e3092307da Fix bug in upgrader пре 2 година
composer.lowest.json 3ea1bc647f Dingo and lowest deps пре 2 година
logo-scribe.png 908fd36b04 Update doc пре 5 година
phpstan.neon 44996fe6f0 Support custom "Last updated at" label пре 2 година
phpunit.xml 44996fe6f0 Support custom "Last updated at" label пре 2 година

README.md

Scribe

Latest Stable Version Total Downloads


v4 is out now!

Scribe helps you generate API documentation for humans from your Laravel/Lumen/Dingo codebase. See a live example at demo.scribe.knuckles.wtf.

Features

  • Pretty single-page HTML doc, with human-friendly text, code samples, and included in-browser API tester ("Try It Out")
  • Extracts body parameters details from FormRequests or validation rules
  • Safely calls API endpoints to get sample responses
  • Supports generating responses from Transformers or Eloquent API Resources
  • Generates Postman collection and OpenAPI spec
  • Easily customisable with custom views and included UI components
  • Easily extensible with custom strategies
  • Statically define extra endpoints that aren't in your codebase

👋 Scribe helps you generate docs automatically, but if you really want to make friendly, maintainable and testable API docs, there's some more things you need to know. So I made a course for you.🤗

Documentation

Check out the documentation at scribe.knuckles.wtf/laravel.

If you're coming from mpociot/laravel-apidoc-generator, first migrate to v3`, then to v4.

Contributing

Contributing is easy! See our contribution guide.