Я пытаюсь написать спецификацию Open API (V3) для API, который я разрабатываю, и сталкиваюсь с проблемой определения заголовка accept. В моей спецификации определение заголовка accept выглядит следующим образом:
parameters:
- in: header
name: Accept
required: true
description: Defines the media type and version of the API endpoint
schema:
enum:
- 'application/vnd.iotdeviceenrollment.v1'
- 'application/json'
type: string
Но я обнаружил, что использовал ограниченное значение «Принять» в качестве имени параметра заголовка: https://apisecurity.io/encyclopedia/content/oasv3/oasconformance/bestpractices/v3-warning-parameter-header-accept
В результате, когда я экспортирую спецификацию Open API в Azure APIM, заголовок accept не отображается и игнорируется.
Если это так, как правильно определить заголовок принятия в спецификации Open API V3?
Примечание. При тестировании с Open API SwaggerUI я мог видеть значение заголовка accept в предварительном просмотре пользовательского интерфейса.