Тут обсуждаем, предлагаем, осуждаем, советуем.
Каким должно быть API, чего не хватает, что лишнее,
Ну и т.д. и т.п.
Коды ошибок - в описании
Если в версии доки по АПИ изменилась только последняя цифра - значит просто что-то добавлено/исправлено в доке а не в протоколе.
API версий 0.х некорректно работает с временами. И потому требует дополнительных "танцев с бубном" при настройке клиентского аккаунта. Исправление этого недостатка требует значительных переделок серверной части. В силу большого количества клиентов уже работающих с этим API, принято решение оставить его как есть и сделать отдельную ветку API.
API версий 1.х в основном внешне похож на ветку 0.х, но новая идеология работы с временами (преобразование времен на клиенте а не на сервере, обмен временами в глобальном формате GMT|UTC) все же требует существенной переделки клиентской части, ранее работавшей с API 0.x.
В документации по 1.х есть небольшое описание различий.
Каким должно быть API, чего не хватает, что лишнее,
Ну и т.д. и т.п.
Коды ошибок - в описании
Если в версии доки по АПИ изменилась только последняя цифра - значит просто что-то добавлено/исправлено в доке а не в протоколе.
API версий 0.х некорректно работает с временами. И потому требует дополнительных "танцев с бубном" при настройке клиентского аккаунта. Исправление этого недостатка требует значительных переделок серверной части. В силу большого количества клиентов уже работающих с этим API, принято решение оставить его как есть и сделать отдельную ветку API.
API версий 1.х в основном внешне похож на ветку 0.х, но новая идеология работы с временами (преобразование времен на клиенте а не на сервере, обмен временами в глобальном формате GMT|UTC) все же требует существенной переделки клиентской части, ранее работавшей с API 0.x.
В документации по 1.х есть небольшое описание различий.
Комментарий