Skip to content
This repository has been archived by the owner. It is now read-only.
master
Switch branches/tags
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

API Blueprint Documentation Provider for Apigility

Repository abandoned 2019-12-31

This repository has moved to laminas-api-tools/api-tools-documentation-apiblueprint.

Build Status Coverage Status

Introduction

This module provides Apigility the ability to show API documentation through a Apiary documentation.

In addition to providing Apiary documentation, module also plugs in the original Apigility documentation and provides content negotiated response with raw API Blueprint.

Requirements

Please see the composer.json file.

Installation

Run the following composer command:

$ composer require zfcampus/zf-apigility-documentation-apiblueprint

Alternately, manually add the following to your composer.json, in the require section:

"require": {
    "zfcampus/zf-apigility-documentation-apiblueprint": "^1.2"
}

And then run composer update to ensure the module is installed.

Finally, add the module name to your project's config/application.config.php under the modules key:

return [
    /* ... */
    'modules' => [
        /* ... */
        'ZF\Apigility\Documentation\ApiBlueprint',
    .,
    /* ... */
.;

zf-component-installer

If you use zf-component-installer, that plugin will install zf-apigility-documentation-apiblueprint as a module for you.

Usage

Apiary documentation can be found on /apigility/blueprint/:api uri and is accessible from the Apigility welcome page.

Querying API Blueprint

When raw API Blueprint is needed, request can be done via content negotiation. Target uri is /apigility/blueprint/:api and Accept header is text/vnd.apiblueprint+markdown.

To learn more about API Blueprint language, please check its specification.

About

No description, website, or topics provided.

Resources

License

Packages

No packages published