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

Answer 2

Я реализовал это так:

/**
 * @api {get} /alerts/param? Get target alerts by target action ids
 * @apiGroup ALERT
 * @apiName Alert Information
 *
 *

Образ

вы можете попробовать это:

/**
 * @api {post} /createBook Create a new Book
 * @apiGroup Books
 * @apiName CreateBook
 .....