如何在 api-doc 中设置数组响应？

Question

我试图通过apidoc生成一个 API 文档

如果我的回应是一个数组

[
   {"id" : 1, "name" : "John"},
   {"id" : 2, "name" : "Mary"}
]

我怎么能在@apiSuccess 中设置？

我尝试过 Object[] 但不知道如何设置字段名称。谢谢。

Answer 1

假设在上面的示例中，id 和 name 属于用户配置文件，并且您有一组用户配置文件对象，那么 @apiSuccess 将如下所示：

/**
 * @api {get} /users
 * @apiSuccess {Object[]} profiles       List of user profiles.
 * @apiSuccess {Number}   profiles.Id    Users id.
 * @apiSuccess {String}   profiles.Name  Users Name.
 */