前端怎么写接口？

Question

有这样一个视频播放页面 领导让我跟后台要接口 还让我把所有接口写出来
我不知道怎么跟后台沟通 不应该后台给我接口吗？ 这个领导什么技术都不懂
他非要我写我下面这样写的 对吗

1.视频播放页面根据视频ID获取用户信息接口
/GetVideoUserInfo
请求方式：GET
参数：VideoId

Answer 1

接口地址：/GetVideoUserInfo
http请求方式：get
功能说明：买家线索列表页查询接口
接口说明：
请求参数：
参数名	参数类型	是否必须	说明
VideoId	num	y	视频ID
响应参数：
参数名	参数类型	是否必须	说明
respCode	Integer	y	状态码, 参见状态码表
errMsg	String	n	状态描述信息(如果respCode=0，errMsg字段没有)
respData	Json数组	y	返回信息
返回样例：获得信息成功:{ respCode: 0, respData: { url:* } }

Answer 2

这个叫 「定接口」 ，把你需要的参数拟定一个文档出来，给后端，让后端根据拟定文档提供接口。

Answer 3

并不是让你写接口，只是让你定义接口的规范：接口名、请求方法、参数、接口返回的数据结构等的。比如现在有一个商品列表，这个接口的规范大致如下：

接口名：/api/goodsList
请求方法：GET
请求参数：currentPage、pageSize
接口返回数据结构：

{
  code:0,
  list:[
    {name:'Iphone11',price:11990,color:'red'},
    {name:'Iphone11',price:11990,color:'red'},
    {name:'Iphone11',price:11990,color:'red'}
 ]
}

前端规范接口的这些东西的好处是也方便自己去进行mock操作。

Answer 4

这可以啊，证明你们领导其实还蛮重视前端，让前端来定义接口。