Привет, это Владимир. Как обещал – простая аналогия про API. Я часто замечал, что если продакты понимает суть, то разобраться потом с деталями для них не составляет проблем. А вот если и суть непонятна, и детали загадочны (мир теха - он такой), то все становится сильно сложнее...
Так вот, удобная метафора API из жизни - покупка мороженого в киоске. В данном случае "вызов API" - это процесс обмена денег и пожеланий (request) на мороженое определенного вкуса и размера (response) из меню киоска (API contact или API documentation, которое содержит ассортимент и цены). Например, за 2 евро можно попросить рожок с 2-мя шариками ванильного мороженого, подождать 2 минуты и получить именно то, что ты хотел.
Заметь важные особенности:
1) Нельзя попросить что-то вне меню (например, салат), потому что такого API (меню) не предусматривает.
2) Тебе не интересно, что сервис (киоск) делает для того, чтобы получить результат: где и по какой цене они покупают молоко, используют свои или арендованные холодильники, как именно смешивают ингредиенты. Важен только API response - рожок мороженого.
3) Если ванильный вкус закончился, то тебе придется ждать довольно долго, пока продавец принесет новую коробку из дальнего холодильника - задержка вызова API растянется до 10 минут.
4) Может так получится, что сонный работник ошибется, и ты получишь шоколадный рожок вместо клубничного - это API вернуло ошибку.
Вот такбы могла выглядеть API-дока:
API method:
/icecream/buy
Request:
- polite_prefix ("Пожалуйста")
- cash (купюра 10 евро)
- base ("рожок" или "стаканчик")
- requested_flavours (e.g. "1 vanilla" and "1 chocolate")
Response:
- change (8 евро, потому что цена мороженого - 2 евро)
- icecream (которое можно есть!)
Когда продавцов заменят роботы (chatGPT не дремлет!), то именно так ваш робот-ассистент будет просить робота-продавца выдать вам мороженку (только без "пожалуйста").
Теме API в курсе "Тех для продакта" (рассчитан на новичков!) мы посвящаем аж 2 урока, и даже учимся вызывать настоящие "ручки" тремя способами. Поскольку большинство ваших продуктов - сервисы, а сервисы общаются по API, то этот скилл очень полезен на практике, чтобы быстро посмотреть, как что работает, проверить, если программисты говорят «готово» или найти в инете API, которое можно интегрировать, и решить часть вашей бизнес проблемы без изобретения велосипеда.
Записывайся на курс, опыт не нужен. Ссылка в предыдущем посте. Симулятор можно проходить в любое время, а на интенсив в конце апреля до пятницы действует ранняя цена.
Так вот, удобная метафора API из жизни - покупка мороженого в киоске. В данном случае "вызов API" - это процесс обмена денег и пожеланий (request) на мороженое определенного вкуса и размера (response) из меню киоска (API contact или API documentation, которое содержит ассортимент и цены). Например, за 2 евро можно попросить рожок с 2-мя шариками ванильного мороженого, подождать 2 минуты и получить именно то, что ты хотел.
Заметь важные особенности:
1) Нельзя попросить что-то вне меню (например, салат), потому что такого API (меню) не предусматривает.
2) Тебе не интересно, что сервис (киоск) делает для того, чтобы получить результат: где и по какой цене они покупают молоко, используют свои или арендованные холодильники, как именно смешивают ингредиенты. Важен только API response - рожок мороженого.
3) Если ванильный вкус закончился, то тебе придется ждать довольно долго, пока продавец принесет новую коробку из дальнего холодильника - задержка вызова API растянется до 10 минут.
4) Может так получится, что сонный работник ошибется, и ты получишь шоколадный рожок вместо клубничного - это API вернуло ошибку.
Вот такбы могла выглядеть API-дока:
API method:
/icecream/buy
Request:
- polite_prefix ("Пожалуйста")
- cash (купюра 10 евро)
- base ("рожок" или "стаканчик")
- requested_flavours (e.g. "1 vanilla" and "1 chocolate")
Response:
- change (8 евро, потому что цена мороженого - 2 евро)
- icecream (которое можно есть!)
Когда продавцов заменят роботы (chatGPT не дремлет!), то именно так ваш робот-ассистент будет просить робота-продавца выдать вам мороженку (только без "пожалуйста").
Теме API в курсе "Тех для продакта" (рассчитан на новичков!) мы посвящаем аж 2 урока, и даже учимся вызывать настоящие "ручки" тремя способами. Поскольку большинство ваших продуктов - сервисы, а сервисы общаются по API, то этот скилл очень полезен на практике, чтобы быстро посмотреть, как что работает, проверить, если программисты говорят «готово» или найти в инете API, которое можно интегрировать, и решить часть вашей бизнес проблемы без изобретения велосипеда.
Записывайся на курс, опыт не нужен. Ссылка в предыдущем посте. Симулятор можно проходить в любое время, а на интенсив в конце апреля до пятницы действует ранняя цена.