技术文档

API 是什么:用点外卖讲清楚接口

「API」「接口」「对接」这几个词听着很技术,其实就是一次点外卖。

你打开外卖 App 下单,相当于发出一个请求:我要什么、送到哪、几点送,这些是参数。餐厅后厨(服务端)收到后处理,做出餐或告诉你卖完了,这叫响应。中间那套"你怎么问、我怎么答"的约定,就是接口。

几个常听到的词,对上号就不难了:

  • 请求 / 响应:你问的那句、对方回的那句。问答都按约定好的格式来,双方才不用每次重新解释。

  • 参数:随请求带过去的信息。查订单要带订单号,查天气要带城市。

  • 状态码:回执上的一句话。200 是办好了,404 是"你要的这个不存在",500 是"我这边出错了"。看到 404 不用慌,它只是说没找到。

  • 鉴权:证明"你有权这么问"。像会员卡或者一次性口令,没有它,别人也能替你查订单、替你下单。

为什么做项目总在说"对接"?因为很多能力不是自己写的,要去问别人:小程序里展示商品,要问商品接口;用户付款,要去问支付平台;发货之后查物流,要问快递那边。所谓"跟微信支付对接",说白了就是按它规定的格式发请求、接住它的回执,并且保证回执重复来的时候不会重复发货。

想让你的业务也快人一步?

选择沧州时代网络,专业网络客服为您赋能!