Театр начинается с вешалки, а высоконагруженный сервис для множества платформ (мобильных, десктопных и даже консольных) начинается с API, который должен быть тщательно сконструирован, задокументирован и создан с учетом нужд каждого из потребителей.
- Автоматическая сборка документации для сторонних разработчиков:
-- web-консоль.
Генерируемая консоль в сервисе apigee.com на основе phpdoc-документации c помощью ApiGen, в которой разработчик может экспериментировать с API:
-- описание структур;
-- описание сервисов с http-роутингом.
- Генерируемый роутинг на основе документации (phpdoc).
В рамках доклада будет показано, как с помощью phpdoc создать красивый интерфейс документации для сторонних разработчиков и как сделать невозможным запуск сервиса, если на него нет документации.
- Динамическое построение форм с состояниями (FormBuilder).
Не переходя на гибридные приложения, добавляем динамику web-формы в нативных приложениях, используя легковесный JSON-протокол.
- Функциональное тестирование Behat.
Тестирование API на естественном языке.
- Версионность структур.
Как мягко изменять протокол API, не ломая production-клиенты?
English version