接口文档怎么写

1.请求地址

/api/position/list

2.请求方式

GET

请求参数

{
hot: true, //热门推荐， [布尔：选填]
type: "home", //兼职类型，home:宅兼职 college:大学兼职 longtime:长期兼职 shorttime:短期兼职 [字符串：选填]
postype: "客服", //岗位类型 [字符串：选填]
start: 0, //记录开始值 [数值：必填]
count: 10 //返回记录条数 [数值：必填]
}

返回数据

  {
"errcode": 0, // 错误代码：[数值：必填] 0 无错误 -1 有错误
"errmsg": "", // 错误信息：[字符串：默认为空]
"data": { // 数据内容
start: 0, //记录开始值 [数值：必填]
count: 10, //返回记录条数 [数值：必填]
total: 120, //总记录条数 [数值：必填]
subjects: [
{
postype: "客服", //岗位类型 [字符串：必填]
posname: '世界500强客服，包吃住~', // 职位名称 [字符串：必填]
city: '北京', //工作地点 [字符串：必填]
duration: '2017-12-15~2017-12-18', // 有效时间 [字符串：必填]
createtime: '1小时前', // 发布时间 [字符串：必填]
companytype: '知名企业', // 企业类型 [字符串：必填]
salary: '365元/日', // 薪资 [字符串：必填]
},

]

}

  }

 

 

转载于:https://www.cnblogs.com/naniandongzhi/p/9297750.html