Описание объекта ответа в API-Explorer/Swagger

Вы делаете это с помощью комментария @return PHPDoc.

Например, взгляните на Пример ограничения скорости в проводник для

GET authors.json/{id}

вы найдете список Информация об ответе

Author ( name: string, email: string )

Он исходит из следующего класса, установленного в качестве возвращаемого типа.

<?php
/**
 * Dummy class, used only for creating swagger spec model (json schema)
 * look at the generated resources json to understand
 */
class Author
{
    public $name='Name';
    public $email='[email protected]';
}