Про api

[stdray]

Чем меньше обещаний, тем проще их соблюдать. Можно пообещать json, а дальше пусть опирается на значения по умолчанию https://t.co/C0nEYyDFp6
- Разработчик бэкенда (@backendsecret) 8 Март 2016

Регулярно всплывает тема запиливания хорошего годного интерфейса к ентим нашим оперденям. И все глубокомысленно отвечают, что вопрос давно решен, и REST API -

Comments

[livejournal]

Здравствуйте! Ваша запись попала в топ-25 популярных записей LiveJournal центрального региона. Подробнее о рейтинге читайте в Справке.

[enternet]

Ну, на текущий момент манну небесную обещает swagger.io
Выглядит вменяемо. Сам не применял ещё. Для дотнетМВЦ есть готовые пакеты, визуализирующие это описание апи.

[stdray]

Я видел, уже хотел применять, но отменилось в пользу SOAP. В любом случае, это очень механическое описание, которое на 95% не нужно, если у тебя есть какой-то контракт до данным и методам.

[ext_2963294]

+ если есть генераторы из моделей\апих

[stdray]

Генераторы чего? Клиентов?

[ext_2963294]

>как часто и сильно можно изменять API
хоть каждый день там же версионирование есть

>насколько подробно и на какую аудиторию надо писать документацию
на пхп дибилов, но на мой взгляд самое сложное в апи это аутентификация\авторизация, вот тут надо кучка примеров. ну и плюс описать, збс если это оаус2 какой, чтобы были либы, ну и хуёва когда это подписаный сертификат тогда это может быть боль.

>надо и сколько, в конце концов, делать сэмплов клиентских приложений
0

ну и я считаю ешчё должен быть какой нибудь тестовый энвайромент\стэджинк где можно дёргать это апи и не боятся