当前位置: 首页 > 科技观察

Yo的API学习开发者体验

时间:2023-03-13 19:22:22 科技观察

在《不要让开发者不开心……》一文中我们提到了开发者体验(DX,DeveloperExperience)的重要性。良好的开发者体验可以让开发者通过API快速创建所需的服务,为您的产品或服务创造更大的附加值。本文以“哟API”为例,让大家更清楚地了解一个好的API服务应该具备的条件。还记得吗?YoApp?去年引起轰动?他是一个只能发一条哟消息的app,你没有看错,他的功能也就只有这么一个。当Yo刚推出时,每个人都认为这是世界上最愚蠢的想法。他们甚至不明白,为什么一个只用了8个小时开发,只能发送Yo消息的应用程序获得了百万的投资。但自从Yo开放了API,Yo变成了一个平台角色,允许开发者通过Yo向订阅者发送消息,创造出许多有趣的应用。1.Yo到底能做什么?Yo刚上线时,只能发送包含“Yo”的消息,而现在Yo除了可以发送Yo消息外,还可以将超链接或你的当前位置发送给你的朋友。还是一头雾水?现在可以去哟的专属了吗?哟商店?看看来自世界各地的开发者正在使用Yo开发哪些有趣的新应用程序。例如,您可以订阅“ProductHunt”,当产品获得大量关注时,您会收到来自ProductHunt的Yo消息,其中包含指向该产品或服务的ProductHunt页面的链接。自行车半路坏了怎么办?订阅BIKESHOP服务后,您可以将您所在的位置发送给BIKESHOP,BIKESHOP会返回距离您最近的营业店铺信息。是不是很方便?也因为Yo本身固有的特性(只能发送一条Yo消息),开发者可以清楚地了解Yo提供的功能,并且通过“YoStore”,用户可以知道在什么上下文(Context)下可以使用你的服务,即使用户暂时没有需求,下次遇到类似情况时,也可以快速将需求与你的产品或服务联系起来。2.简单明了的文档正如我们在上一篇文章中提到的,如何让开发者能够快速从头开始,是打造良好开发者体验的关键要素。?YoAPI文档提供了如何快速上手,提供了开发者所需的基本信息,包括如何认证、示例程序链接、相关情况等。此外,在每个API的描述中,还提供了不同编程语言的代码示例,供开发者参考。Yo只提供了5个API,但你很可能只会使用一个(/yoall,向所有订阅你服务的用户发送Yo消息),并且每个API也明确定义了参数、可能的返回内容和不同编程语言的调用示例。最后,如果你还有不懂的地方,不妨参考CodeSamples中其他开发者开发的应用,获得一些启发。3、遇到问题怎么办?如果您在开发中遇到问题,或者有值得建议的想法,可以在YoAPI论坛搜索相关讨论,或者提问。良好的社区支持是API能否继续被开发者采用的重要因素。如果只开放API,遇到问题却无处可问,也没有办法建议功能,开发者最终会受挫。您只能远离您的产品或服务。所以,不要觉得你的API功能够完善,或者文档写的够好。开发者总会有各种意想不到的想法。只有保持双向通信,你的API才能更加完善。保持简单和愚蠢!不得不承认,Yo服务本身的特性,让YoAPI简单易用。当然,在开发者体验方面,Yo并不完美。比如缺少服务状态查询,开发者无法知道当前的YoAPI是否正常工作。服务可以通过Yo不断改进,但总的来说,YoApp和YoAPI让我们体验到一个服务应该是什么样子,保持简单但又不过分简化(我觉得没有什么办法可以简化),让用户通过YoApp和API创造独特的可能性。知道其他有趣的案例吗?不管你有什么想法和意见,欢迎在下方留言与大家分享!