Parse and generate API specification formats

v3.0.1 2020-10-03 14:03 UTC



Currently there are several API specification formats (OpenAPI, RAML, Swagger, etc.) which describe the functionality of an API endpoint. This project provides a data model which contains the common information of an API endpoint. There are parser classes which create such models based on a specification and it is also possible to generate a specification from a model object. We have also created an online tool to test those conversions.




  • PHP (Generates a PHP client stub)
  • Typescript (Generates a Typescript based client stub)


  • HTML (Generates a HTML representation of the resource)
  • Markdown (Generates a Markdown representation of the resource)
  • Template (Generates a representation based on a Twig template)


  • PHP (Generates a PHP controller class which represents the API resource)


  • JsonSchema (Generates a JsonSchema which contains all schemas of the specification)
  • OpenAPI (Generates a OpenAPI 3.0 specification)
  • RAML (Generates a RAML 1.0 specification)
  • Swagger (Generates a Swagger 2.0 specification)


The root model object is called resource which represents a specific API endpoint. The following is a simple showcase of the resource API so you get a basic understanding how it is designed.


// reads the OpenAPI specification and generates a resource object which was
// defined under the path /foo
$resource = \PSX\Api\Parser\OpenAPI::fromFile('openapi.json', '/foo');

// returns the title

// returns available path parameters as PSX\Schema\PropertyInterface

// checks whether a specific request method is supported

// returns all allowed methods

// returns the available query parameters per method as PSX\Schema\PropertyInterface

// checks whether the method has a request specification

// returns the request body specification as PSX\Schema\SchemaInterface

// checks whether the method has a response with the status code 201

// returns the response body specification as PSX\Schema\SchemaInterface

// creates a PHP client which consumes the defined /foo resource
$generator = new \PSX\Api\Generator\Client\Php();

$source = $generator->generate($resource);