Разработка и сопровождение API в большом сервисе (Wamba)

Каторгин Виталий Владимирович

Театр начинается с вешалки, а высоконагруженный сервис для множества платформ (мобильных, десктопных и даже консольных) начинается с API, который должен быть тщательно сконструирован, задокументирован и создан с учетом нужд каждого из потребителей.


- Автоматическая сборка документации для сторонних разработчиков:

-- web-консоль.

Генерируемая консоль в сервисе apigee.com на основе phpdoc-документации c помощью ApiGen, в которой разработчик может экспериментировать с API:

-- описание структур;

-- описание сервисов с http-роутингом.

- Генерируемый роутинг на основе документации (phpdoc).

В рамках доклада будет показано, как с помощью phpdoc создать красивый интерфейс документации для сторонних разработчиков и как сделать невозможным запуск сервиса, если на него нет документации.

- Динамическое построение форм с состояниями (FormBuilder).

Не переходя на гибридные приложения, добавляем динамику web-формы в нативных приложениях, используя легковесный JSON-протокол.


- Функциональное тестирование Behat.

Тестирование API на естественном языке.


- Версионность структур.

Как мягко изменять протокол API, не ломая production-клиенты?