python开发接口的经验（大白话版）

1. 服务框架的选择

直接选择 django + uwsgi 的方式部署项目，尽量使用多层路由的接口，方便后续api的拓展

2. 日志记录

将详细日志记录在本地，将接收到的数据和处理结果记录到数据库中，方便之后排查问题

3. 异步任务的处理

同步任务响应很快，处理好直接返回即可；
异步任务通常是计算量大的、响应慢的任务，通常用kafka的生产消费模式去解决。一般做法是：
服务端——接收数据——记录日志——记录数据库——发送kafka——返回（告诉客户端，我接收到数据了）
后端通常用多线程（多进程）去消费任务：
从kafka接受数据——计算过程——输出结果——更新数据库——返回（告诉客户端，计算的结果）
异步接口通常要定义任务id和接受一个回调地址，方便消费脚本根据此id更新数据库状态和把计算结果返回给对方。消费任务的脚本根据不同任务类型通常和服务端程序不在同一个环境，此时注意写好文档，避免找不到这个消费脚本部署在哪个服务器、那个docker。注意，消费任务时，由于任务的不同，可能会出现任务失败的情况，因此需要经常去数据库检索一下出问题的任务，排查原因，必要时再写个脚本定时处理出问题的任务