[Go] Unknown field при json unmarshal

[DeOne4eg]

С недавнего время появилась проблема в Go, которая ломает множество запросов.

Генерация:

openapi-generator generate \
  -i openapi/openapi.yaml \
  -g go \
  -o . \
  --git-host githost \
  --git-user-id user_id \
  --git-repo-id yandex-market \
  -p packageName=yamarket \
  -p structPrefix=true \
  -p enumClassPrefix=true \
  -p generateInterfaces=true \
  -p withGoMod=true

Версия:

> openapi-generator version
7.8.0

Суть: рассмотрим, например, метод https://api.partner.market.yandex.ru/campaigns/{campaignId}/stats/orders. В массиве orders присутствует поле buyerType, но в описании моделей (yaml файлы) этого поля нет. Из-за этого я получаю ошибку json: unknown field \"buyerType\", которая возвращается из json.Unmarshal().

Подобное происходит по многим методам и это лишь один вариант.

Дополнительно:
Есть еще одна проблема, которая возникает в ChannelType:

func (v *NullableChannelType) Unset() {
	v.value = nil
	v.isSet = false
}

value является пустой структурой, поэтому никак не может быть nil. Правильный вариант struct{}{}, но, скорее всего, это все же проблема самого openapi-generator.

[DeOne4eg]

Если в генераторе установить disallowAdditionalPropertiesIfNotPresent=false, то все работает.

Но проблема с ChannelType остается.

[vbauer]

@DeOne4eg Доброго времени суток,

Подобное происходит по многим методам и это лишь один вариант.

Методы могу возвращать больше параметров, чем указано в спецификации. Такое происходит в двух случаях: либо параметр пессимизируют из контракта чтобы постепенно вывести, либо наоборот вводят новый параметр (который пока что еще не готов 100% открыться на всех пользоваталей)

Как вы правильно подметили, нужно включить disallowAdditionalPropertiesIfNotPresent=false

Есть еще одна проблема, которая возникает в ChannelType

Если я правильно понял комментарий, сам ChannelType описан как:

channels:
  description: Список каналов продвижения товаров.
  type: array
  nullable: true
  items:
    $ref: '../schemas.yaml#/ChannelType'

• Генератор знает что channels является nullable
• Но к сожалению по OAS 3.0 items может быть либо Schema, либо Reference https://github.com/OAI/OpenAPI-Specification/blob/main/schemas/v3.0/schema.json#L470
• Поэтому про элементы внутри items он ничего не знает и использует NullableChannelType
• Такое поведение присутствует во многих генераторах на других языках
• То что выставляется nil - видимо так работают nullable-типы в генераторе (есть разные обсуждения на эту тему вроде https://github.com/search?q=repo%3AOpenAPITools%2Fopenapi-generator+nullable+go&type=issues)