Skip to content

rhwilrForks/blueprint

This branch is 62 commits behind dingo/blueprint:master.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

7f61717 · Jan 25, 2017

History

82 Commits
Dec 27, 2016
Sep 3, 2016
Jun 20, 2015
Jun 20, 2015
Jun 20, 2015
Mar 31, 2016
Oct 5, 2015
Jan 25, 2017
Jul 17, 2015
Dec 21, 2016

Repository files navigation

API Blueprint Generator

Build Status License Development Version Monthly Installs StyleCI

This package generates a valid API Blueprint 1A document from a collection of classes.

Usage

Some index method phpdoc example:

<?php

/**
 * Products
 *
 * @Resource("Products", uri="/products")
*/
class ProductsController extends ApiController
{
    /**
     * Products list
     *
     * Get current products list
     * 
     * @Get("/")
     * @Versions({"v1"})
     * @Transaction({
     *      @Request(identifier="/?state=synced"),
     *      @Response(200, body={"data":{{"id":"rkoVJ7qa4Z6lzXdVnldgx9LmpBP0DQ3e","name":"Product name","status":"active"}},"meta":{"pagination":{"total":1,"count":1,"per_page":1,"current_page":1,"total_pages":1,"links":{}}}})
     * })
     * @Parameters({
     *      @Parameter("api_token", type="string", required=true, description="API Token", default=null),
     *      @Parameter("page", type="integer", required=false, description="Pagination page", default=1),
     *      @Parameter("state", type="string", required=false, description="Product status filter", default="synced", members={
     *          @Member(value="synced", description="Products synced"),
     *          @Member(value="pending", description="Products pending")
     *      })
     * })
     */
    public function index(Request $request)
    {}
}

License

This package is licensed under the BSD 3-Clause license.

About

Generate valid API Blueprint documentation

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 100.0%