兼容性说明
<p>平安云API网关与Swagger规范在API参数类型的定义上有一定的差异,在使用时需要特别关注。</p>
<p><span style="font-size:18px"><strong>参数类型</strong></span></p>
<p>在<a href="https://pinganyun.com/console/apiGateway" target="_blank">API网关管理控制台</a>创建的参数、以及由导入Swagger文件创建的参数,在导出API时,系统会转换为Swagger支持的参数类型:</p>
<table border="1" cellpadding="0" cellspacing="0">
<tbody>
<tr>
<td style="background-color:#ededed">
<p><strong>平安云</strong><strong>API</strong><strong>网关支持的参数类型</strong></p>
</td>
<td style="background-color:#ededed">
<p><strong>Swagger</strong><strong>支持的参数类型</strong></p>
</td>
<td style="background-color:#ededed">
<p><strong>由导入</strong><strong>Swagger</strong><strong>文件创建的参数类型</strong></p>
</td>
</tr>
<tr>
<td>
<p>String</p>
</td>
<td>
<p>string</p>
</td>
<td>
<p>String</p>
</td>
</tr>
<tr>
<td>
<p>Int</p>
</td>
<td>
<p>integer</p>
</td>
<td>
<p>Int</p>
</td>
</tr>
<tr>
<td>
<p>Long</p>
</td>
<td>
<p>number</p>
</td>
<td>
<p>Double</p>
</td>
</tr>
<tr>
<td>
<p>Float</p>
</td>
<td>
<p>number</p>
</td>
<td>
<p>Double</p>
</td>
</tr>
<tr>
<td>
<p>Double</p>
</td>
<td>
<p>number</p>
</td>
<td>
<p>Double</p>
</td>
</tr>
<tr>
<td>
<p>Boolean</p>
</td>
<td>
<p>boolean</p>
</td>
<td>
<p>Boolean</p>
</td>
</tr>
</tbody>
</table>
<p><span style="font-size:18px"><strong>错误码</strong></span></p>
<p>平安云API网关的错误码是可选的,而Swagger要求错误码是必须设置的。如果在平安云API网关的管理控制台没有定义错误码,在导出API时,系统会默认为该API添加“200”的错误码。</p>
<p><strong>示例</strong>:</p>
<table border="0" cellpadding="0" cellspacing="0">
<tbody>
<tr>
<td style="background-color:#f7f8fa; vertical-align:top">
<p><span style="font-family:Consolas">responses:</span></p>
<p><span style="font-family:Consolas"> '200': {description: success}</span></p>
</td>
</tr>
</tbody>
</table>
提交成功!非常感谢您的反馈,我们会继续努力做到更好!