iOS开发：对Yo的API学开发者的一些体验

iOS开发：对Yo的API学开发者的一些体验

 

　　在「别让开发者不开心…」一文中我们提到了开发者体验(DX, Developer Experience)的重要性。好的开发者体验，让开发者可以快速透过 API 来打造所需要的服务，替你的产品或服务创造更大的附加价值。本篇文章透过?Yo API?为例，让大家更清楚了解一个好的 API 服务所应具备的条件。

　　还记得在去年造成极大轰动的?Yo App? 吗? 他是一个只能传送一个 Yo 讯息的 App，你没看错，他的功能就只有这样。Yo 在一开始推出时被大家认为是世界上最蠢的点子，甚至不明白为什麽一个只花8小时开发，只能送出 Yo 讯息的 App 竟能拿到百万美金的投资。但自从 Yo 开放了 API 後，Yo 转身一变成为平台角色，让开发者能够透过 Yo 来发送讯息给订阅者，创造出许多有趣的应用。

　　1. Yo 到底可以做什麽?

　　Yo 刚推出时只能发送一个包含 “Yo” 的讯息，不过目前 Yo 除了单纯的发送 Yo 讯息外，还能发送超连结或是你目前的位置给你的朋友。还摸不着头绪吗? 现在你可以到 Yo 专属的?Yo Store?来看看世界各地的开发者都拿 Yo 来开发什麽新奇有趣的应用。

　　例如，你可以订阅?Product Hunt?的服务，当某个产品得到极高的关注时，你就会收到来自 Product Hunt 的 Yo 讯息，同时会带着该产品或服务的 Product Hunt 页面连结。

　　脚踏车半路中坏掉了怎麽办?订阅了 BIKESHOP 的服务後，你可以传送你的位置给 BIKESHOP，BIKESHOP 就会回传离你最近且有营业的店家资讯，是不是很方便呢?

　　也因为 Yo 本身天生的特性(就只能发送一个 Yo 讯息)，让开发者能够很清楚地了解 Yo 所提供的功能，而透过?Yo Store?能让使用者知道在什麽情境 (Context) 下可以使用你的服务，即时使用者暂时没有需求，当下次再遇到类似的情境时，便能快速地将需求和你的产品或服务联结起来。

　　2. 简单且清楚的说明文件

　　在上一篇文章中我们提到，如何让开发者快速地从无到有，是创造优良开发者体验的关键要素。在?Yo API 文件上提供了如何快速上手的文件，提供了开发者所需的基本资讯，包含如何认证，范例程式的连结，以及相关的情境。除此之外，在每个 API 的说明上，也提供了不同程式语言的程式码范例，方便开发者参考。

　　Yo 只提供了5个 API, 不过你大概只会用到一个(/yoall, 向所有订阅你服务的使用者发送 Yo 讯息)，每个 API 也都明确定义了参数、可能的回传内容和不同程式语言的呼叫范例。最後，如果你还是没有头绪，不妨在 Code Samples 中参考其他开发者开发的应用来获取一些灵感。

　　3. 遇到问题该怎麽办?

　　若 在开发上遇到了问题，或是有值得建议的想法，可以在 Yo API 论坛上搜寻是否有相关的讨论，或者发问。良好的社群支援是 API 能否持续被开发者采用的重要因素，若只是开放了 API，但遇到了问题却没地方问，想建议功能却找无门路，最终开发者碰得一鼻子灰，只能离你的产品或服务远去了。所以，别以为你的 API 功能已经够完善，或是文件已经写得够完美了，开发者永远有各种你意想不到的想法，保持双向的沟通，才能让你的 API 更臻完善。

　　Keep It Simple & Stupid!

　　不 得不承认 Yo 服务本身的特性，造就了 Yo API 的简单易用，当然 Yo 在开发者体验上也不是完美的，像是缺乏服务状态查询，开发者无法得知目前 Yo API 是否能正常服务，都是 Yo 可以持续改善的，不过总体而言，从 Yo App 和 Yo API 让我们体验到一个服务所应呈现的样貌，保持简单但却又不过於简化(我想也没办法再简化了)，让使用者能透过 Yo App 和 API 来创造出无限的可能。