Шаблон усов для статической документации Swagger codegen — responseMessages

Я пытаюсь использовать swagger-codegen для создания статических документов.

Документы создаются на основе шаблонов Mustache, включенных в проект.

Когда я запускаю его с образцом JSON из wordnik Swagger api-docs, он генерирует все отлично (каждый API имеет свой собственный .file, такой как Pet.html, User.html), но когда я пытаюсь запустить его с похожим JSON, он генерирует только 1 файл операций, содержащий все методы моего REST API.

Ответ Wordnik JSON можно найти по адресу wornik JSON API.

Ответ моего API выглядит так:

{"apiVersion":"1.0","swaggerVersion":"1.2","apis":[{"path":"/default/countries","description":"Operations about countries"},{"path":"/default/gateways","description":"Operations on payment gateways"},{"path":"/default/location","description":"Operations about locations"},{"path":"/default/mccs","description":"Operations about MCCs"},{"path":"/default/merchants","description":"Operations about merchants"},{"path":"/default/partners","description":"Operations about partners"},{"path":"/default/payments","description":"Operations about payments"},{"path":"/default/resources","description":"Operations about resources"},{"path":"/default/terminals","description":"Operations about terminals"},{"path":"/default/terminalsubsetdefaultresourceset","description":"Operations about terminalSubsetDefaultResourceSet"},{"path":"/default/users","description":"Operations about users"}],"info":{"title":"my API","description":"","termsOfServiceUrl":"","contact":"","license":"","licenseUrl":""}}

Кроме того, я хотел бы извлечь коды ReponseMessage в каждой операции, в которой они есть в JSON. я пытался добавить

{{#ResponseMessages}} <h3 class="responseMessages">{{message}}</h3> {{/ResponseMessages}}

в Operations.model, но это не работает (ни с myApi, ни с Wordnik) (у меня есть похожий JSON, например: JSON с кодами ответа


json templates mustache
person Maroš Pataky    schedule 07.11.2014    source источник

Ответы (1)


arrow_upward
0
arrow_downward

Вы должны иметь возможность использовать следующее (по крайней мере, это работает для меня) на основе текущей версии Codegen.scala

    {{#errorList}}
    {{code}} {{reason}} {{responseModel}}
    {{/errorList}}
person Leif K    schedule 02.02.2015