классный срач про гц был 👍

классный срач про гц был 👍

Эпик

Эпик

Лучше такие, чем о табах и пробелах

Коллеги, возможно, я проблему придумываю. Но есть такая мысль. Я по сути являюсь сейчас бизнесс овнером проекта. Сам проект на стадии проектирования. Так вот, есть (будет) APIшка. Очень хочется написать спеку по АПИ. Но! Хочется как то облегчить с помощью спеки написании тестов для АПИ. Писать спеку по апиколллам с помощью тестов не хочется. Этим буду не я заниматься. Но было бы неплохо, если по спеке можно было бы хоть как то облегчить этот процесс (генеринг тестов?). Думал описать с помощью swagger.yaml , но как то видется по другому. Или вообще не морочить голову, напистать в markdown апиколлы и отдать на откуп разработчику?

А почему свагер выглядит по другому?

А как он поможет в написании тестов?

он просто будет, для тестировщика сваггер может и сгодится.

Как он поможет деву?

Нашел очень интересную задумку, кто то пробовал? https://github.com/matryer/silk

Как он поможет деву?

формализованной записью того что нужно и что вернется. это конечно если все что приходит и уходит сверяется со свагером

JSON-schema?

а че кто-то еще пишет апи без свегера?

да, используют например apidoc

свагер, несмотря на то что он гавно говном, несколько больше чем апидок.

а что у него есть такого?

несложно интегрируется проверка входящих и исходящих данных, ну и такая-же как у апидока админка

Раскажите флоу потом, как вы юзаете его. Ну есть у вас куча апиколов описанных в свагере. А дальше?

а дальше к нему подключатся мидлваря которая проеряет входязие данные а дальше круд

json schema validation

json schema вообще мощь без границ

Коллеги, пните плз в правильно русло. Где это почитать? (в гугле не забанили)

сначала декларативно описываешь апи, а потом ковыряешь логику

такая высокоуровневая апи типизация

ну допустим. В ямле описал все поведение. А дальше?

Все равно писать самому все, хоть полугенеринга, но нет же?

полугенеринг это sailsjs вам нужен

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

а потом вы в один момент заходите сделать graphql апи и сможете обернуть описанные типы в любую новую структуру

имел ввиду, что этот ямл только для свагера и нужен (генерилки списка апиколов и работы с ним). Бекенд самому писать придется, но только смотря на ямл. Заюзать его больше никак не получится?

или таки ямл-файл еще сгодится для чего то?

https://www.npmjs.com/package/swagger-validator

http://swagger.io/tools/

https://www.npmjs.com/package/swagger-to-js-api

или таки ямл-файл еще сгодится для чего то?

без ямлки вообще ничего не будет

короче https://www.npmjs.com/browse/keyword/swagger

Я наверно нудный 😊 но я все равно не понимаю как его еще юзать. Например, swaggerValidator принимает JSON-файл и валидирует его. И все? По сути это линтер. Чем он мне помоежет. В любом случае я буду в Swager Editor писать и там ошибки сразу. Я подразумеваю, что этот файл можно заюзать например где то действительно в миделварьке, которая будет валидировать входящие данные в моей АПИ. Это хоть как то облегчит написание апи-колов. Или нет?

он не json валидирует a пришедший запрос

Кажись у меня момент истины 😊

спасибо

Коллеги, пните плз в правильно русло. Где это почитать? (в гугле не забанили)

вот кстати

https://scotch.io/tutorials/speed-up-your-restful-api-development-in-node-js-with-swagger

и вот http://www.tothenew.com/blog/build-restful-api-using-node-and-hapi/

В этих статьях как раз показывают как свагер помагает разрабатывать путем тыцанья кнопок (апиколов). Дев по сути добивается, чтоб апишка работала без ошибок на эти апиколлы. Хочется большего 😊

а кто пользовался яндех картами? Можно ли как то определить, входят ли координаты в круг?

Кластеры?

https://tech.yandex.ru/maps/doc/jsapi/1.x/ref/reference/geopoint-docpage/#distance

> @baranovnikita Можно ли как то определить, входят ли координаты в круг? да и карты для этого не нужны

https://en.wikipedia.org/wiki/Haversine_formula

так то да.я тоже уже об этом подумал

но тут мне не то что бы в круг

а именно во МКАД

и в 3 транспортное

Для этого нужен point in polygon

https://github.com/vkurchatkin/which-country

аналогично

Либа: https://github.com/mapbox/which-polygon

Спасибо большое!

ребят

а кто нить на ноде магазы подымал?

как там с платежами доставкой дела обстоят никто не вкурсе?

нпм дает всякие киви?

Яндех деньги/пэйпал норм сдк вроде

Существуют ли какие-либо good practice или соглашения для проектирования API на WebSocket?

Лучший practice - не использовать websocket по возможности

Лучший practice - не использовать websocket по возможности

для кого?

Для всех

Всмысле - не использовать их там, где они не нужны

есть что-то лучше

http

можешь глянуть http://www.jsonrpc.org/specification

ну, это очевидно

Лучший practice - не использовать websocket по возможности

Двачую

COMET macht frei

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

COMET - это что-то про мамонтов

Если попытаться его сделать надежным, то окажется что и сокеты в общем не нужны

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

> реал-тайм > stop-the-world gc Дазнт компьют

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

например, личку?

В общем, можно юзать сокеты, если нужно получать какие то некритичные нотификации

Где нестрашное их терять