Skip to content

Automated API Documentation with Scramble

Scramble, integrated into our Laravel project, offers a streamlined approach to generating API documentation effortlessly. This Laravel package eliminates manual effort, simplifying the documentation process for developers.

Accessing the Documentation

After integrating Scramble into your Laravel application, two routes are automatically available:

  • /docs/api: This route presents a user-friendly UI for browsing your API documentation.
  • /docs/api.json: Access the OpenAPI document in JSON format, outlining your API endpoints.

To access your documentation, simply navigate to /docs/api using your web browser.

Integrating with Postman or Insomnia

Seamlessly integrating your API documentation with tools like Postman or Insomnia is straightforward with Scramble:

  1. Export Documentation: Visit /docs/api and locate the option to export the documentation. Choose either JSON or YAML format.

  2. Save the Exported File: Download and save the exported file to your local system.

  3. Import into Postman:

    • Launch Postman, click on "Import," and select the exported JSON or YAML file.
  4. Import into Insomnia:

    • In Insomnia, navigate to the "Import/Export" section and opt to import a file. Choose the exported JSON or YAML file.

Released under the MIT License.