VF
Ну реально мы сложность не прячем, а наоборот выставляем на показ и заставляем генерировать тонны никому не нужного кода, зачем?
Size: a a a
2021 November 18
AM
Ну, у нас все сервисы на Java и если сервис предоставляет какой-то апи для других сервисов, то мы делаем в рамках сервиса Java SDK. Но у нас также фронт и мобилка может нашими апи пользоваться, или в каких-то случаях тех.поддержка или тестировщики могут ручки в постамане подергать. Поэтому, полность абстрагироваться от представления не получится.
VF
Думаю и фронт и мобилка у себя все равно сделали обертки и не сами их придумали, а посмотрели как у вас это сделано в сдк
VF
Ну или прочитали описание, где вы прописали типичное поведение
SG
Так вопрос генерации/написания клиентских либ к дизайну самого api особого отношения не имеет. Тут же речь за дизайн шла, а не за то, как потом либы делать
AM
Сильно сомневаюсь. К тому же, апи для фронта и апи для других сервисов - это в общем случае разные множества.
VF
Так дизайн апи либы и дизайн апи сервиса это же вообще разные слои. Либа остается такой-же, а апи сервиса может поменяться
AM
Дизайн апи - это не только про схему путей, это не самая большая и не самая сложная часть. Более интересные моменты - как работать с фильтрацией, пагинацией, сортировками. Еще интереснее - батчи, транзакции, асинхронные операции и т.п.
AB
А как делать транзакции в апи?
AM
Представление ошибок еще
SG
да, просто все разговоры за rest/rpc - это про дизайн api. Как-то незаметно перешли на либы )
AB
Перешли пушо за либой дизайн уже не так важен, он важнее серверу, не клиенту
SG
есть же openapi, зачем в sdk подклядывать
AM
Зависит от потребностей. Я в целом стараюсь не тащить транзакции на уровень апи. Ну и транзакции - не в смысле транзакций БД, а в смысле бизнес-транзакций, конечно.
VF
Я о том, что дизайн апи сервиса в целом никого особо (кроме разработчиков апи) не волнует, погромист хочет кусок кода, который он скопипастит
AB
Волнует порядок в апи, на самом деле, иначе программист тоже будет страдать
PD
У тебя в этом клиенте - какие методы будут?
Проблема же именно в этом.
Не важно, рисовать API для этой библиотеки или API для межсервисного взаимодействия, все равно нужно его продумывать.
И это сложно (
Проблема же именно в этом.
Не важно, рисовать API для этой библиотеки или API для межсервисного взаимодействия, все равно нужно его продумывать.
И это сложно (
AB
Т.е. как раз дизайн
VF
Я не говорю что придумывать апи просто, я говорю, что апи сервера и апи клиента это разные задачи совершенно
VF
ну если у меня есть кусок кода с поведением, то я не переживаю, как там оно внутри работает