IOS development: some experience for API developers of Yo

IOS development: some experience for API developers of Yo

 

In "don't make developers unhappy ...」 The article mentions the importance of Developer Experience. A good developer experience allows developers to quickly create required services through APIs and create greater value for your products or services. Through this article? Yo API? For example, you can better understand the conditions that a good API service must meet.

Remember what caused a sensation last year? Yo App? ? He is an App that can only send one Yo message. If you are not mistaken, his function is only like this. At the beginning, Yo was regarded as the dumbest idea in the world, and did not even understand why it only took 8 hours to develop, only apps that send Yo messages can get millions of dollars in investment. But since Yo opened the API, Yo turned to become a platform role, allowing developers to send messages to subscribers through Yo, creating many interesting applications.

　　1. What can Yo do?

At the time of its launch, Yo can only send one message containing "Yo". However, in addition to sending the Yo message, Yo can also send a hyperlink or your current location to your friends. Still confused? Now you can go to the exclusive Yo? Yo Store? Developers from all over the world use Yo to develop novel and interesting applications.

For example, you can subscribe? Product Hunt? When a Product gets a high level of attention, you will receive a Yo message from Product Hunt and link it to the Product Hunt page of the Product or service.

What should I do if the bicycle breaks down halfway? After subscribing to the BIKESHOP service, you can send your location to BIKESHOP. BIKESHOP will return the information of the store that is closest to you and has business. Is it very convenient?

Because of the inherent features of Yo itself (only one Yo message can be sent), developers can clearly understand the functions provided by Yo? Yo Store? It allows users to know the Context in which their services can be used. Real-time users do not have any requirements at the moment. When they encounter similar situations next time, you can quickly connect your needs with your products or services.

　　2. simple and clear description file

In the previous article, we mentioned that how to make developers quickly start from scratch is a key element for creating a good developer experience. In? The Yo API file provides files for Quick Start, basic information required by developers, including how to authenticate, links to sample programs, and related situations. In addition, the code examples for different programming languages are provided in each API description for developers to refer.

Yo only provides five APIs, but you may only use one (/yoall, sending Yo messages to all users subscribing to your service ), each API also clearly defines parameters, possible return content, and call examples in different programming languages. Finally, if you still have no clue, you may wish to get some inspiration by referring to the applications developed by other developers in Code Samples.

　　3. What should I do if I have any problems?

If you encounter problems in development or have suggestions, you can search for related discussions or ask questions on the Yo API forum. Good community support is an important factor in the continued use of APIS by developers. If you only open APIs but have encountered problems, there is no way to ask questions, in the end, developers can only get away from your products or services. Therefore, do not think that your API functions are complete or that your files are well written. Developers will always have unexpected ideas and maintain two-way communication, in order to improve your API.

Keep It Simple & Stupid!

You do not have to admit the features of the Yo service, which makes the Yo API simple and easy to use. Of course, Yo is not perfect in the developer experience, such as querying the service status, developers cannot know whether the current Yo API can provide normal services, but Yo can continue to improve. However, in general, from Yo App and Yo API, we can experience the appearance of a service, keep it simple but not simplified (I don't think it can be simplified), so that users can create unlimited possibilities through the Yo App and API.