Skip to content

Files

Latest commit

 

History

History
36 lines (26 loc) · 1.17 KB

nelmio-api-doc.md

File metadata and controls

36 lines (26 loc) · 1.17 KB

NelmioApiDocBundle Integration with Symfony

Warning

For new projects, prefer using the built-in Swagger support and/or NelmioApiDoc 3.

NelmioApiDoc provides an alternative to the native Swagger/Open API support provided by API Platform.

As NelmioApiDocBundle 3+ has built-in support for API Platform, this documentation is only relevant for people using NelmioApiDocBundle between version 2.9 and 3.0.

Screenshot of API Platform integrated with NelmioApiDocBundle

NelmioApiDocBundle is supported by API Platform since version 2.9.

To enable the NelmioApiDoc integration, copy the following configuration:

# api/config/packages/api_platform.yaml
api_platform:
  # ...

  enable_nelmio_api_doc: true

nelmio_api_doc:
  sandbox:
    accept_type: 'application/json'
    body_format:
      formats: ['json']
      default_format: 'json'
    request_format:
      formats:
        json: 'application/json'

Please note that NelmioApiDocBundle has a sandbox limitation where you cannot pass a JSON array as parameter, so you cannot use it to deserialize nested objects.