80,465
社区成员




<returns name="json_result" remark="所有的接口用这个格式返回数据">
<return key="success" remark="操作结果" />
<return key="message" remark="提示语" />
<return key="data" remark="数据集, 接口返回的数据包含在这里">{key:value}</return>
</returns>
<interface url="/advert/list.htm" remark="首页的广告图">
<params>
<param name="ak" type="string" must="true" remark="调用接口安全认证的key" />
<param name="cityId" type="number" must="true" remark="城市ID" />
</params>
<returns extends="json_result">
<return key="result" remark="广告列表">
<return key="id" remark="广告ID" />
<return key="title" remark="标题" />
<return key="image" remark="模板图片:{imageUrl}/{image}" />
<return key="linkUrl" remark="链接地址" />
</return>
</returns>
</interface>
有了文档,再结合界面,就好办了