如何优雅的生成接口文档？（做直播需要什么？）

如何优雅的生成接口文档？

说到优雅的接口文档，很多人不免都想到了Swagger，但是Swagger真的好吗？众所周知，这个框架对代码有很大的侵入性，况且需要程序员自行开发，甚至可能会出现30分钟开发完业务，1个小时写Swagger注解的情况。

所以，Swagger不能被称之为优雅。那么，就不得不说一下YApi了。

YAPI，专为接口管理而生，友好的接口文档，基于websocket的多人协作接口编辑功能和类postman测试工具，让多人协作成倍提升开发效率。支持MockServer，基于Mock.js，使用简单而功能强大。

项目管理

YAPI可以添加分组，可以为每个分组设置组长，组员，其他人无权限访问该分组。然后，分组内可创建项目，可定义基本路径，其实，可以简单理解为api接口的固定前缀，不单单指上下文根。例如，可以为 /shop/api 等。

创建接口

项目创建完成后，即可进入详情页进行后续操作。

创建接口也比较简单，其内容通俗易懂，直接填写即可。

在设置界面，可对项目及接口进行相关设置，如域名等，也可以设置域名为本地。

还可以查看项目的动态，也就是变动日志。

如果你之前做过Swagger的集成，那么，在这里可以直接导入，不必一一创建，既贴心又方便。

还可以开发一个wiki，方便接口使用者及开发者了解项目详情，接口逻辑。

当然了，如果团队成员发生变动，如新进人员、离职人员等，可以再次对项目成员进行管理。

另外，还支持MOCK配置、环境配置、全局MOCK脚本、Swagger自动同步等。

介绍至此，大家已然明白，相较于Swagger，YAPI对系统的侵入，可以说是零。也很符合其优雅的接口管理系统美名。

关于其他更详细的使用方面的问题，大家可下载部署安装之后，亲自尝试尝试，即可领略其魅力。

关注@银河架构师，发现更多精彩内容。

做直播需要什么？

大家好，我是羽翼课堂创始人Benny。如果你已经在做直播了，应该都听过“3秒停留看场”这句话，其实不难理解，当我们正在直播，用户进入到直播间首先接收到的信息就是场，这里的场不只是静态的场景，还有动态的。

场是直播间的隐性竞争力，是最容易着手优化的点，但往往也是最容易被忽略的，特别是大部分刚开始做直播的新手。

这篇推文来跟大家详细聊聊“场”的优化，主要分为实体的场和虚拟的场两部分，双重升级，实现直播间吸引力、转化力暴增！

01 实体的场

其实这部分之前在黄皮书系列的第一章已经详细的写过。

但今天的内容会升级更新一些之前没讲到，以及没讲得很细的点，建议结合起来一起看，这样会更系统全面些。

实体的场，你可以理解为搭建直播间所需要搞定的所有事项，主要包含直播间的背景、灯光、设备、装修、产品摆设、以及产品信息的露出，接下来我们来逐个拆解聊一下：

1.直播间背景

直播间的背景搭建主要根据所售类目选择，目前整个做抖音电商的直播间，常见的背景类型有：货架式、实体店、源头产地、自定义：

①货架式

这类背景比较常见，比如像零食、家居、饰品、美妆、母婴、箱包、鞋子、餐具等等类目，基本上都是货架式。虽然比较常见了，但很多直播间的背景搭建其实是不合格的，那怎么搭建这种类型的直播间呢？

遵循搭建原则：突出主题产品，一秒吸睛，背景货架展示，中景主播在正中央，前景备选产品展示。

我们可以通过背景、中景、前景三个维度来对比以下这三个案例截图，可以看出第三个案例是不合格的，主题产品不够突出，主播头部已经超出屏幕了，且前景的产品比较杂乱，没有达到吸睛的效果。

②实体店背景

这种类型也比较常见，很多线下实体转线上的商家都会利用自己的场地优势，用实体店来当作直播间的背景，这样的背景相较于货架式会让用户觉得更真实，更具备说服力。

比如以上三个案例，第一个主播本身打造的人设就是实体店女老板转型线上，通过实体店的背景，进一步还原真实场景，给用户营造的感觉：实体批发店、款式更新快、性价比超高。

第二个是专门通过背景来打造的餐具专柜店，还原线下专柜场景，告诉用户他卖的产品是专柜货，线下的价格和直播间的价格比价，突出直播间的价格福利；第三个和第二个类似，只是类目换成了家纺。

③源头产地背景

这种类型背景的直播间在去年的年底陆续多了起来，因为那时候部分工厂已经意识到红利，开始杀入抖音电商，利用自身源头产地的场景和产品价格的优势，吃到了一大波流量红利。

今年厂播模式将会继续兴起，这种类型的直播背景有个天然的优势就是：能够打造出“极致源头感”，来看几个案例。

第一个类型，是陶瓷类目的源头工厂，通过工厂背景直播，作为用户进入到这样一个直播间，给人的感觉就是款式多样，还是出厂价，没有中间商赚差价，价格优势明显；

第二个是零食坚果类的源头加工厂，直播间的背景也是正在加工的过程，背后有工人现场加工生产，体现直播间的产品都是优质源头好货，说服力十足啊；

第三个很有趣，是卖海鲜的，在池塘边开播，制作了一个道具，让盆里面的小龙虾从制作的道具中进入到锅里，现场开煮，体现这个直播间的产品是源头食材，且是优质源头货源，新鲜价，很有创意，人气做得很高。

④自定义背景

这种类型的直播间，很多品牌自播和商家都在用，背景是绿幕，通过摄像头，电脑后台抠像完成，背景可以通过设置视频或图片素材辅助转化。

比如我们可以在背景设置促销信息，也可以通过绿幕实现半仓播，通过提前准备的素材，来辅助主播讲解，展现卖点等。

以上四种，是目前抖音直播间常见的背景，不管你做哪种背景，都需要遵循这三点通用的布置原则：1色调一致，不串色，视觉协调；2背景能提升所售产品价格背书；3软装随时调整，便于更换。

2.直播间灯光

灯光重要性不用多说，直接决定了直播间的整体效果，常见有顶灯、环境灯、辅助灯。

但具体如何选择，如何搭配，还是要根据自身所售类目，以及需求决定。

①顶灯

顶灯决定了直播间的质感，如果顶灯没装好，直播的效果就会大打折扣，所以在开始装修直播间的时候，一定要把顶部布满，简单均匀的从头顶位置照射，给背景和地面增加照明，同时还能加强瘦脸效果。

第一个直播间是卖服装的，装修的顶灯是方块型，均匀照射，旁边会有两个长方形的灯照射地面，提升整个直播间的亮度；

第二个是家居日用的直播间，顶部装了多个射灯，中间是主播对应的位置，所以会多了两个灯。

②环境灯

环境灯的作用起到补亮效果，主要打在产品上，首先要保证灯光的亮度，前提是顶灯的数量和瓦数一定要充足，这样直播间产品才能足够高清。

比如像下面这种，很明显顶灯不够多，不够大，导致直播间的整体亮度都不够。

其次是灯光色彩，要根据我们所售类目选择，比如用白光常见的类目有：美妆、服装、鞋包，因为这类产品颜色不能失真，不然会有色差，导致退货率增高。

暖光一般像美食、家居、家纺类会用，因为这类型的产品是可以通过暖光来激发食欲，以及增加温馨感的。

③辅助灯

辅助灯又分为补光灯和射灯或其他装饰灯，补光灯大家应该都知道，如下图的样子，一般直播间都会必备的设备：

补光灯的类型有很多，常见的方形灯、圆形灯、环形灯，球形灯，一般建议用球形灯最佳，因为打光比较均匀，建议配置2-4个150w左右的即可。

另外就是射灯，比如这个服装账号，通过射灯装饰T台，打造出一种时装走秀的画面感。

装饰灯，一般用来填充直播间背景的空白处或装饰背景，比如下图的直播间，通过装饰灯装饰背景。

注意，射灯不作为光线的主要来源，还是装饰灯，是没有照亮的作用，只是起到装饰作用，避免光线太暗或太亮。

3.直播间产品摆设

产品的摆设要根据直播，我们可以划分为站姿直播，和坐姿直播，如果你是站姿直播类型，那产品摆设遵循以下原则即可：

①远近适中，可远景可聚焦，总能有一个角度能让产品充盈整个屏幕；

②画面丰满，较空的地方可以用产品填充，或者其他软装装饰，让直播间看起来丰满不空白。

举例说明一下，比如这个卖鞋子的账号，她空白处通过产品进行了填充，然后主播远景展示上身效果，副播对着镜头近景展示，让整个画面看起来比较充盈。

如果你是坐播类型，那产品摆设遵循以下原则即可：

①整洁清晰，一目了然，货架式直播间一定要善用对称美；

②产品色彩搭配和视觉效果有吸睛点。

比如珠宝通过灯光营造处闪烁的效果；家居背景放上高档的电器，前景用高颜值的餐具；零食类，通过食物刺激食欲。

4.直播间产品信息露出

直播间通过产品信息的露出，可以有效的辅助主播讲解和转化，减少主播重复传达指令。

比如产品卖点信息时刻，辅助主播讲解产品；展示产品尺寸，让新进直播间的人清晰可见；提前打印好其他平台的截图物料，通过展示价格进行比价，显示直播间价格优势；

02 虚拟的场

说完实体的场，接下来我们看看虚拟的场，主要是通过我们的设置和优化营造出来的场氛围，是虚拟的，不像实体的场那样可以直接装修搭建，那具体从哪里着手优化呢？

主要包含：讲解处、活动贴片、公屏区、福袋/红包、粉丝券、评论置顶、飘屏，我们继续来逐个拆解：

①讲解处

讲解处，这个最容易被忽视的点，最容易降低跳失率，增加商品点击率，试想一下你进入一个直播间，如果正在讲解中的卡片，主图和价格都吸引人，你肯定会去点击看看对吧。

所以，讲解处的优化设置有2个要点：

1首先你的主图需要简单易懂，看起来能够吸引人，这样子才能吸引点击；

2在顶讲解的时候每隔3-5秒弹屏一次，因为你点一次上讲解，出现几秒后就会消失，但会不断有新的直播间进入，所以需要不断的弹屏。

活动贴片。主要通过电脑直播，在直播伴侣后台设置，通常会展示产品活动，展示尺寸和规格，以及展示额外权益，比如运费险/7天无理由/其他。

②公屏区

公屏区，也就是评论区，是最能体现直播间氛围感的点，当所有人都在扣一个指令时，你只要进入到这个氛围中，也会情不自禁的跟着扣指令，因为人都是有从众心理的。

所以，可以找几个水军助力来优化公屏区，比如个性化的好评：“收到货，质量好”，“价格比别家便宜”等等，或主播通过水军来引出我们想要卖的产品。

后台管理员也要实时控屏，解答粉丝的问题，引导关注，活动等，来营造直播间的紧张氛围感。

③福袋/红包

这个工具简直是我们做直播的利器，可以帮我们做各项数据指标，一定要用好！福袋可以发实物或抖币，但新号一般是没有实物福袋的功能，所以一开始只有抖币福袋，实物和抖币福袋它们分别的用途是啥？

实物福袋：主要用来做活动送礼，吸引停留为主，文案设置要点：行动指令+奖品内容。

比如送一个砂锅，文案设置为“中福袋，领砂锅”，这样新进来的用户也会自动取点击福袋，然后自动发送一条你设置好的文案指令，且要等到时间到了才知道结果，非常显著的拉升了停留时长和互动率。

抖币福袋：可以小额发也可以大额发，如果小额发抖币福袋，可以有这些作用：形成公屏区好评/引出某产品/代替实物福袋，抖币数量建议设置30抖币/3人;50抖币/5人（人均10抖币），文案范例“拍过好用”“想要菜板”

大额抖币福袋，吸引停留，抖币数量可以设置1000抖币/10人，10000抖币/100人，文案设置要点，突出主播大方的人设，例如老板豪气。

④红包/粉丝券

红包，主要是直播间的抖币红包，可以直接发红包吸引停留，中红包的用户一般都会送灯牌或礼物，提升互动加粉，因为系统会引导中红包的用户给主播送礼；粉丝券，用户领取后自动加粉，提升精准用户的转粉率，以及转化率。

⑤评论置顶

评论置顶有点类似我们上面实体的场中提到的活动贴片，不过这种，直接置顶评论即可达到我们想要展示的效果。

评论置顶的内容设置思路，可以‍置顶用户好评，直播间活动，或产品信息。

⑥正中央飘屏

飘屏内容设置思路：引导关注、互动、扣屏，减少主播口播引导互动，引导正向反馈。

例如主播给力、老板大方，主播配合说，哪个说老板大方的，来直接送一条项链，是不是直播间的氛围瞬间就起来了

最后说一下，如果说直播间主播是主角，那么直播间的整体效果呈现就是最佳配角，通过场景化直播间搭建，加强用户对产品的信任感，才能更好的通过直播卖出产品。

如有其它问题，请关注公众号“scyyhd”，会安排专人，第一时间回答您的疑问~~

Web前端密码加密是否有意义？

这个话题现在是很有争议的。是否有意义肯定是从网站安全的角度，而安全又是个很广的概念，每个人心中都有一个哈姆雷特，我们后面再一一分析。先抛出我的观点：Web前端密码加密是有意义的。

反方观点一直从加解密的角度分析这个问题，认为加密密钥和算法都保存在前端，攻击者通过查看js源码就能得到算法和密钥，加密多此一举，还浪费性能。只要网站是https的，就能防止传输链路上的第三方导致的密码泄露，不需要额外在前端再来一层加密。另外还有人认为前端加密后还是防不住中间人重放攻击，攻击者还是能在不解密的情况下登录劫持到的用户账号。不知道我对反方观点总结的是否全面，欢迎大家持不同意见在评论进行补充。

我来阐述我的观点，安全问题要考虑的问题很多，除了自己其他都是假想敌，都不可信。整个系统的短板往往是攻击者最喜欢攻击的目标，这个就是安全最著名的理论——木桶原理。

用户登录密码从前端用户输入到后端入库会有哪些风险？

首先用户键盘敲的肯定是明文，这个登录框如果是钓鱼假冒网站，或者是网站本身存在xss漏洞被攻击者前端劫持了登录框，从我们这里讨论的加密技术上，怎么防都防不住的，攻击者肯定都能获得明文。我们就不讨论这个风险了，既然前端加密，我们默认前端可信。

然后接下来就是传输可信的问题了，从前端到后端，整个通道，可能要绕大半个。上面说了都可以依赖于https传输，解决的问题是第三方通过拦截数据包分析出明文密码的问题。这个没有什么好争辩的，https就是干这个事情的，前端不加密传输在https里面的数据第三方肯定拿不到的，否则整个密码学体系就崩溃了。

那我们是不是就不需要前端加密了呢？非也，因为在安全的角度，两端也是不可信的。不加密解决不了两端对明文密码的泄露。

我们先考虑用户不可信的问题。如果用户就是攻击者呢？这个现象存在于很多web测试代理抓包场景中，https网站想代理抓包，就需要设置浏览器代理并且信任代理软件ca证书，浏览器类似于把抓包软件作为后端，真正的后端把抓包软件作为前端，抓包软件作为用户主动设置的中间人能够成功在自己电脑上破掉https加密。这样做的好处是什么呢，只能看到自己输入的明文密码？那就图样图森破了，获取了整个登录请求的http包，如果有用户密码对字典，就可以很简单地对后端进行批量爆破了，安全界叫“撞库”，这几年这么多数据库被脱库，我们应该重视这个问题。

前端加密并不能完全解决撞库问题，但是能提高攻击成本。任何能提高攻击成本的方案都是有意义的，阻挡了小白黑客，那些高级黑客还是能利用前端的加密算法，对自己的字典密码进行处理。所以还要加入一次性验证码放入加密算法中进行防重放攻击，我看过一篇文章讲的是，非常复杂，要知道每天都有成千上万的黑客盯着，也有各种奇葩的我们不知道的利用技术，多加一层保障总是好的。

我们再考虑的是后端的不可信问题。后端开发总认为自己比前端开发重要，有一句流传在坊间的话，“后端不信任任何来自前端的输入”，从安全角度，我认为前端也不应该信任任何敏感信息的输出。很多时候出事，恰恰就出在后端。我记得github就翻车过一次，在请求日志里面发现了明文密码。你不知道运维或者后台会不会记录包含post请求体的access log，如果不加密，log里面就是明文密码。公司后台可能有各种监控系统，到时候密码就满天飞了。黑客突破任何一台服务器，自己系统的密码就有泄露的风险。

还有后端的密码入库问题，这个正反方都没有异意，肯定不能明文存储，我就不多说了，主要是防止sql注入，直接被黑客撸到数据库里面来了，目前站库分离，黑客不知道后端代码用的什么加密。顺便提一下，后面回答有些说md5是加密，明显是概念混淆，加密是可逆的，md5这些哈希散列算法是不可逆的。

综上所述，开发千万不要过度依赖https，认为上了https就天下太平了。任何安全措施在不过分影响用户体验和开发成本的情况下都是好的，有意义的。

我是一个正在学安全的开发，如有纰漏，欢迎指正！

怎么在淘宝上开店？

淘宝开店可以直接在手机淘宝上完成操作，步骤分为六步，分别是：

01

点击手机上事先安装好的淘宝，点击我的淘宝。

02

点击更多工具。

03

拉到页面底部，点击我要开店。

04

输入自己店铺的名称，和适当的描述一下自己的小店。

05

再点击进行实名认证和开店认证。

06

认证之后就可以点击发布宝贝了。

文章名称：如何优雅的生成接口文档？（做直播需要什么？）
分享路径：http://www.hantingmc.com/qtweb/news28/469928.html

网站建设、网络推广公司-创新互联，是专注品牌与效果的网站制作，网络营销seo公司；服务项目有等

广告

声明：本网站发布的内容（图片、视频和文字）以用户投稿、用户转载内容为主，如果涉及侵权请尽快告知，我们将会在第一时间删除。文章观点不代表本网站立场，如需处理请联系客服。电话：028-86922220；邮箱：631063699@qq.com。内容未经允许不得转载，或转载时需注明来源： 创新互联