Более тысячи разработчиков используют открытый API 500px для разработки своих приложений. В докладе будет рассказано о том, как построить конкурентноспособный API, которым будут пользоваться разработчики по всему миру, и как превратить его в ключевой сервис компании.

3. Евгений Чеботарёв
Chief Product Officer
API для людей
Как создать API, которым по-настоящему пользуются

4. Немного истории
О том как создавался 500px

5. В октябре 2009 году мы
запустили 500px.com, в
августе 2011 запустили API

9. API в 500px
September 2011October 2011November 2011December 2011January 2012February 2012March 2012April 2012May 2012June 2012July 2012August 2012September 2012October 2012November 2012December 2012January 2013February 2013March 2013April 2013May 2013June 2013July 2013August 2013September 2013September 2011
September 2011
November 2011
November 2011
January 2012
January 2012
March 2012
March 2012
May 2012
May 2012
July 2012
July 2012
September 2012
September 2012
November 2012
November 2012
January 2013
January 2013
March 2013
March 2013
May 2013
May 2013
July 2013
July 2013
September 2013
September 2013
04008001 2001 6002 0000
0
400
400
800
800
1 200
1 200
1 600
1 600
2 000
2 000 1.3 млрд.

10. API в 500px
1,3 миллиарда API запросов в месяц
3600+ зарегистрированных разработчиков
4000+ приложений использующих 500px API
12 выделенных серверов
Интеграция с Flipboard, Vū, Google Glass, Flavors.me,
Samsung TV, и т.д.
developers.500px.com
•
•
•
•
•
•

11. Зачем нужен API?
Реализация ваших идей сторонними силами

12. Зачем нужен API?
Возможность разрабатывать свои приложения
Работать с партнёрами
Использовать на хакатонах
Генерировать идеи силами сторонних разработчиков
•
•
•
•

13. Подход к созданию API
Как сделать разработку максимально удобной

14. Подход к созданию API
Максимально упростить задачу разработчикам
Сделать API максимально “futureproof”, чтобы он
оставался релеватным спустя годы
•
•

16. Моделирование за лидером
Как привлечь разработчиков к вашему API

17. Моделирование за лидером
Две компании — две типа API
Flickr — устарелый тип API, но направленный на
фотографию
Twitter — современный API, но не фото-
ориентированный
•
•
•

18. Моделирование за лидером
На момент создания 500px API более миллиона
разработчиков использовали Twitter API
RESTful
JSON
OAuth
Convention over configuration
•
•
•
•
•

19. “Hit the Ground Running”
Зная Twitter API легко начать разрабатывать под 500px API

20. Моделирование информации
Постоянный анализ требований разработчиков

21. Моделирование информации
Анализ данных для понимания потребностей
Разбивка на логические классы
•
•

22. Моделирование информации
Разбивка запроса фото с комментариями на два
отдельных запроса: фото, комментарии
Результат обходится “дешевле”, и пользователи
быстрее видят важный им результат (фото)
•
•

23. {
""photo":"{
""""id":"4928401,
""""user_id":"164677,
""""name":""Northern"Fulmar",
""""description":""Photographed"during"a"pelagic"trip"east"of"Cape"Cod.,
""""camera":""Canon"EOSH1D"Mark"IV",
""""for_sale":"false,
""""width":"588,
""""height":"750,
""""votes_count":"36,
""""favorites_count":"18,
""""comments_count":"36,
""""highest_rating":"97.1,
""""highest_rating_date":""2012H04H16T15:05:56H04:00",
""""image_url":""http://pcdn.500px.net/4928401/16666558d7ba410f50922f86f736888d8cfaf9bb/4.jpg",
""""images":"{"size":"4,""url":
"http://pcdn.500px.net/4928401/16666558d7ba410f50922f86f736888d8cfaf9bb/4.jpg"}
""""store_download":"false,
""""store_print":"false,
""""user":"{
""""""id":"164677,
""""""username":""axelhildebrandt",
""""""firstname":""Axel",
""""""lastname":""Hildebrandt",
""""""city":""Bethlehem",
""""""country":""U.S.",
""""""fullname":""Axel"Hildebrandt",
""""""userpic_url":""http://acdn.500px.net/164677.jpg",
""""""upgrade_status":"0
"""}
"}
To create code snippets, see http://ioni.st/post/980

25. Версия 1.0
Минимальный набор

26. Версия 1.0
Read-write
Базовые возможности сайта
Аутентификация (логин)
Постоянное развитие (v 1.0 просуществовал 2 дня)
•
•
•
•

27. RTFM
Документация превыше всего

28. RTFM
Документация находится на Github
Разработчики могут предлагать правки, изменения и
задавать вопросы
Документация постоянно улучшается
128 коммитов, 11 авторов
•
•
•
•

29. Хорошая документация
Гарантия того, что разработчики будут довольны

30. Взгляд с 10,000 метров
Решение настоящих проблем с помощью аналитики

31. Взгляд с 10,000 метров
Проанализировать как пользуются API
Server performance
Оптимизация под массового потребителя
Среднее время запроса 100-120 мс
•
•
•

32. Взгляд с 10,000 метров
Feedback-driven development
Фото + комментарии
Гео-поиск
Будущие сервисы компании
•
•
•

34. API 2.0
Взгляд в будущее

35. API 2.0
Утилитарное использование API
Цветовой анализ
Реверсивный геокодинг
Анализ лиц, объектов
Анализ качества фотографии (контраст, яркость,
боке, композиция)
•
•
•
•

36. API 2.0
Marketplace
От небольших приложений
До коммерческого лицензирования
•
•

37. @tchebotarev
#yac2013