Hi,
I'm writing the content around our API services, but I'm unable to use the
list of fields mentioned in the swagger specification content because they
are not allowed when the value of 'in:' is set to 'body'.
Has anybody worked around this so that you can specify the maxLength of the
parameters in the body?
Here's an example of the YAML structure I'm working on:
paths:
"/pigeon/sendemail":
post:
tags:
- Pigeon
description: > Send an email.
operationId: SendPigeonEmail
parameters:
- name: data
in: body
required: true
schema:
"$ref": "#/definitions/PigeonBody"
responses:
'200':
description: success
schema:
"$ref": "#/definitions/PigeonSuccess"
headers:
Content-Type:
type: string
Content-Length:
type: integer
Cache-Control:
type: string
'400':
description: Already processed batch
schema:
"$ref": "#/definitions/PigeonProcessedBatch"
headers:
Content-Type:
type: string
Content-Length:
type: integer
Cache-Control:
type: string
default:
description: Unexpected error
schema:
"$ref": "#/definitions/GlobalErrorResponse"
PigeonBody:
required:
- schedule
- batch_id
- recipients
properties:
schedule:
type: string
batch_id:
type: string
recipients:
"$ref": "#/definitions/RecipientFields"
RecipientFields:
required:
- email
- firstname
- ordernumber
properties:
email:
type: string
firstname:
type: string
titlelastname:
type: string
ordernumber:
type: integer
--
You received this message because you are subscribed to the Google Groups
"Swagger" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
For more options, visit https://groups.google.com/d/optout.
