接口怎么写（接口文档一般由谁写）

　　接口文档怎么看？其实公司大多数用的都是内部接口，第三方接口其实相比起来用得少，两者区别只是提供方不一样。
　　接口文档其实就是一个讲解某个接口是做什么的文件。不管是你们公司内部的开发，或者是你跟一些第三方合作的时候，产品经理必须要知道怎么看接口文档，知道里面哪些部分是重要的才行。
　　否则别说功能实现，沟通都很难进行……
　　懂点基础知识好沟通
　　比方说，你们公司要做一个考勤系统，想用人脸识别来进行打卡，但是人脸识别这个事可能有点技术难度，我们就决定用第三方了。
　　找到第三方，第三方可能会丢你一个接口文档让你自己看去
　　这时你就要通过看文档了解这个接口提供哪些功能，你需要用到哪些，你的哪些想法是他的接口能满足的，哪些是不能满足的。
　　比方说，现在有一种情况，大家现在经常戴口罩或者是戴墨镜什么的。这个api接口提供的人脸识别的打卡功能里面，人戴上的这种戴上眼睛之后，能不能进行打卡，就需要在他的文档里面去找到，看是否有相应能力。
　　研发也是要写很多东西的~比如接口文档
　　先介绍几个概念：
　　请求参数
　　比方说你需要让阿里云给你发一条短信，你至少需要告诉他你要发送到哪个手机上面去，对吧？这个手机号码就是请求参数。在请求接口的时候，需要把这个请求参数给他。
　　请求参数跟设计功能很相关的，必须在产品设计的时候考虑如何这些请求参数，检查接口文档的时候也要重点留心各种请求参数是不是都写全了。
　　跟请求参数相对应的是返回参数
　　请求做完了之后，它要告诉你他有没有发送成功，成功了就返回查询的信息，失败的就报错。比如说你是一个查询订单详情的，或者查询一个商品页，接口就需要把商品查询出来商品的关键信息之类的返回给你，这个就是返回参数。一般在工作中＂返回参数＂比较多。
　　这时一般都会返回多个字段，但是我们在接口文档里面就需要知道它字段代表什么意思，比如参数名是什么，类型是什么；如果出现错误的话，它会有一些错误码给你。比方说你在下一个支付订单的时候，前端在调用的时候就返回了一个403的一个错误，然后这个时候对照接口文档一看你就知道403代表什么意思了。
　　接口文档可以是word、txt等等，形式不重要，关键是文档里面最关键的7个步骤需要好好了解一下：
　　1.接口描述：简述接口是干什么的
　　2.接口地址是什么？
　　接口暴露出去给别人用，一定是有一个地址的。一定要知道请求地址是什么，这也就是请求的URL是什么。
　　3.调用时的方法类型是什么
　　是pose的还是get，都会在这个文章里面描述好。
　　post的和get的区别是什么？在get请求传输的时候，URL地址会在网址的后面附加上去，也就是说网址上会有请求参数，并且get请求的参数是有长度限制的；post请求的参数就不会在URL里面展示出来。
　　4