В пятницу днем мы немного повеселились с API Yo. Мы хотели сделать программу, которая вызывала бы какие-либо действия при получении Yo.
Мы сделали Yo’ed, хаб, написанный на Golang (язык, который мы очень любим в Mention), который как раз и запускал действия при получении сообщения.
Начав с этой простой идеи, я на самом деле провел большую часть выходных за написанием распределённой версии, заодно получив множество удовольствия от связи Yo API с другими сервисами (такими, как, например, Mailjet API, который использовал для отсылки электронной почты при получении Yo).
Играя с API, мы задались вопросом, что в нем нас привлекло больше всего. Внимательно изучив его, мы обнаружили, что у него есть много чему научиться!
Простота
Yo по-прежнему находится в самом начале своего развития, но развивается быстро и очень прагматично.
Пару недель назад у вас не было возможности войти в свой аккаунт, если вы вышли и забыли свой пароль. Чтобы получить доступ к API, надо было ждать несколько дней. Но с самого начала разработчики приложения знали, что большую роль в их успехе играет API.
Две недели назад единственной доступной конечной точкой было «yoall» , широковещательная рассылка Yo всем подписчикам аккаунта, без разумных ограничений.
Неделю назад они запустили панель управления API для того, чтобы создавать и управлять аккаунтами. Они также добавили некоторые ограничения (в настоящее время — одно сообщение в минуту) для ограничения спама.
Сами API как продукт – простой. Сейчас вы можете послать Yo всем своим подписчикам («yoall») или отдельным аккаунтам («yo»), а также посмотреть количество подписчиков («subscribers_count»).
Эта простота дает возможность людям начать использовать API за секунды: простой вызов с помощью cURL дает вам моментальный отклик. Это всегда и должно быть так просто!
Документация
Предоставление ясной документации о том, что может делать ваш API и как его начать использовать, всегда получит хороший отклик у разработчиков.
Если взять для примера Yo API, который сам по себе очень простой (два вызова, один параметр – токен), то у разработчиков все равно нашлось время для создания документации и выкладки ее в доступном виде в панель управления API.
Дайте контекст разработчикам
Простые вещи – но большие возможности! Для успеха, вы должны дать людям контекст, чтобы вдохновить их на создание новых вещей.
Разработчики Yo две недели назад в Сан-Франциско организовали хакатон, чтобы подкрепить тот успех, которого они добились при запуске.
После этого они сделали отличную пост-статью в блоге с описанием всех идей, которые были задействованы в ходе хакатона. Описание этих проектов было отличным способом показать людям те возможности, которые они в продукте раньше не видели.
Когда я прочитал этот пост в блоге, он действительно поразил меня тем, сколько возможностей есть для использования их API. Например, проект BASKETBALLBERRY, упомянутый в статье, стал вдохновением для меня в написании клиента, который посылает мне Yo, если мой поезд прибывает по расписанию.
Фичеринг проектов в собственном аккаунте Github — еще один прекрасный способ показать инновации в использовании их программного интерфейса. Вы, кроме того, можете легко пообщаться с разработчиками по электронной почте.
Всегда давайте простую возможность разработчикам показать то, что они создают при помощи вашего продукта. Это бесценно.
Yo API действительно прост, но он открывает бесконечные возможности. Парни, сделавшие его, проделали большую работу, облегчая взаимодействие с ним разработчикам, помогая им создавать удивительные вещи при помощи него.
Наш проект Yo’ed является открытым и доступен для форка на Github, так что вы можете поиграться с ним. Вы также можете написать нам на yoed@mention.com.
Вот некоторые идеи для развития:
- Yo/Fitbit, Jawbone: посылать Yo в конце дня, если вы не достигли своей цели.
- Обратный таймер Yo: клиент, который посылает Yo обратно через Х минут после вашего Yo, напоминая таким образом о чем-либо.
- Система шаринга велосипедов через Yo: уведомлять о наличии велосипедов на вашей любимой парковке в связке с расписанием поездов.
Возможности безграничны!