Apidoc - Node.js не показывает мне @apiName

Question

У меня проблема с моей документацией по API.Я хочу сделать документацию, но @apiName не появляется ... Я пытался добавить @appVersion, но это не сработало.

Это моя документация

/**
 * @api {post} /createBook
 * @apiGroup Books
 * @apiName CreateBook
 * @apiHeaderExample {json} Header-Example:
 *     {
 *       "Authorization": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYXlsb2FkIjp7InVzZXIiOjV9LCJpYXQiOjE1NTA3NzI0MjEsImV4cCI6MTU1MDg1ODgyMX0.2xQyS6PrBIH3mZS2qTmrMemXxVSTHNhdxCgl_4qY3pU"
 *     }
 * @apiParam {String} name something
 * @apiParam {String} yearOfRelease something
 * @apiParam {String} condition something
 * @apiParam {String} price something
 * @apiParam {String} images something
 * @apiSuccessExample {json} CreateBook-Success-Response : HTTP/1.1 2000k
 * {
 *  'status': 'Added',
 *  'description': 'Book was added'
 * }
 */

Это мой код ... Кто-нибудь решает эту проблему?Спасибо

Answer 1

Используется для именования и имен навигации.

<ul class="sidenav nav nav-list">
<li class="nav-fixed nav-header" data-group="_">
<li class="nav-header" data-group="User">
<li data-version="0.3.0" data-name="GetUser" data-group="User">
<a href="#api-User-GetUser">Read data of a User</a>
</li>

Позже имя следует использовать для встроенных ссылок (еще не реализовано).

Мне нужно обновить документы, apiName изменить и теперь не является обязательным.Имя автоматически генерируется из типа и пути: @api {type} / path / -> внутренняя автоматически генерирует этот @apiName TypePath, если apiName не установлено.

через github https://github.com/apidoc/apidoc/issues/259