In the numbers API, we have a country field, but sometimes it is required and sometimes not - so it is expressed as a reusable schema rather than a reusable parameter. There is no description at the parameter level so the description from the schema should be used (sorry I think I tested with redoc and then we didn't spot it on merge).
#/components/schema/ entry looks like this:
country:
type: string
minLength: 2
maxLength: 2
example: GB
description: The two character country code in ISO 3166-1 alpha-2 format
In the getOwnedNumbers endpoint, the parameter is like this:
- name: country
required: false
in: query
schema:
$ref: "#/components/schemas/country"
Here's that getOwnedNumbers in screenshot form - both on Nexmo developer and locally with Redoc.
The Nexmo one has no description - I guess because the parameter doesn't have a description? But in that case it should use the schema one (and if both are present the most specific one, i.e. the parameter, should be used).
In the numbers API, we have a country field, but sometimes it is required and sometimes not - so it is expressed as a reusable schema rather than a reusable parameter. There is no description at the parameter level so the description from the schema should be used (sorry I think I tested with redoc and then we didn't spot it on merge).
#/components/schema/
entry looks like this:In the
getOwnedNumbers
endpoint, the parameter is like this:Here's that getOwnedNumbers in screenshot form - both on Nexmo developer and locally with Redoc.
![localhost_8080_operation_getOwnedNumbers_-_2019-12-20_10 01 58](https://user-images.githubusercontent.com/172607/71247293-5aeaaf00-2310-11ea-8e19-0a206e292d39.png)
The Nexmo one has no description - I guess because the parameter doesn't have a description? But in that case it should use the schema one (and if both are present the most specific one, i.e. the parameter, should be used).