codeSamples
Configure the code samples generated from your OpenAPI description.
Options
Option | Type | Description |
---|---|---|
languages | [language object] | REQUIRED. Array of language objects, one per language. The samples are displayed in the order that they are listed. Default array value is:[ { lang: curl }, { lang: JavaScript }, { lang: Node.js }, { lang: Python }, { lang: Java }, { lang: C# }, { lang: PHP }, { lang: Go }, { lang: Ruby }, { lang: R }, { lang: Payload } ] |
skipOptionalParameters | boolean | Excludes optional parameters (cookies, headers, query params) from the generated code samples. Defaults to false . |
Language object
Option | Type | Description |
---|---|---|
lang | string | REQUIRED. Sets the language to create code samples for. Supported values: curl , C# , C#+Newtonsoft , Go , Java , Java8+Apache , JavaScript , Node.js , PHP , Python , R , Ruby |
label | string | Custom label to use for the generated code sample. In the Request samples section of your reference docs, the code sample tab uses the custom label instead of the default lang value. |
Examples
The following example generates code samples for five tech stacks, including only the required parameters:
redocly.yaml
openapi: codeSamples: skipOptionalParameters: true languages: - lang: 'curl' label: 'cURL' - lang: 'JavaScript' label: 'JS' - lang: 'Go' - lang: 'Ruby' - lang: 'Java8+Apache' label: 'Java 8'
With this configuration, each endpoint has code samples in these five languages generated and displayed in the documentation.
Related options
- openapi - Learn more about using
openapi
configuration.