ThinkChat2.0新版上线,更智能更精彩,支持会话、画图、阅读、搜索等,送10W Token,即刻开启你的AI之旅 广告
## Schema请求类型 参数`@SWG\Schema()`是输入和输出数据类型的定义,这些类型可以是对象,也可以是字符串和数组 ``` /** * @SWG\Post( * path="/index/index/user", * tags={"用户相关"}, * summary="个人资料", * consumes={"application/json"}, * produces={"application/json"}, * @SWG\Parameter( * in="body", * required=true, * name="body", * description="description", * @SWG\Schema(example={"username"="username","password"="password"}) * ) */ ``` | 参数 |含义 | | --- | --- | | ref | 允许此路径项的外部定义 | | example | 设置一个自定义的对象 | | discriminator | 添加多个自定义 `ref` 的支持 | > 我们来看看参数`@SWG\Schema()`使用 > 使用`example`参数来自定义 ``` /** * @SWG\Schema(example={"username"="username","password"="password"}) */ ``` > 使用`discriminator`参数来进行多个模型的支持 ``` /** * * @SWG\Response(response="200",description="ok",@SWG\Schema(ref="#/definitions/Definition",discriminator="Definition")), * @SWG\Response(response="404",description="ok",@SWG\Schema(ref="#/definitions/index",discriminator="index")) */ ``` > 使用`@SWG\Property()`参数来设置: > | 参数 | 含义 | | --- | --- | | property | 名称 | | type | 类型 可设置值为 string、 number、 integer、boolean、array、object" | | example | 设置默认值 | | readOnly | 属性声明 | ``` /** @SWG\Schema( * @SWG\Property( * property="username", * type="string", * example="username" * ), * @SWG\Property( * property="password", * type="string", * example="password" * ), * @SWG\Property( * property="sex", * type="integer", * example=0 * ) * ) * / ``` > 参数`readOnly`如果设置为true,这意味着它只作为响应的一部分发送,不能作为请求的一部分发送,默认false >