API в pet-проекте и в продукте: две разные вселенные и деньги

Почему API в pet‑проекте и API в продукте — это две разные вселенные.

✏️Немного теории. Да, вот так сразу, а то ведь вы читать не будете, а я очень хочу донести до вас смысл. Поговорим о различиях между pet-проектом и продуктом. А различия есть, и как раз об этом я думала после встречи с чудесной Викой из ContentHero.

▪️В pet‑проекте API живёт «пока интересно»: сегодня GET /try‑this, завтра — DELETE /oops.

✔️В продукте API — это публичный контракт. Его подписывает юрист, считает CFO и клянётся не ломать CPO, иначе партнёры выставят счёт.

🫠Вчера я два часа подряд на одном очень классном обучении рисовала схемы REST API и поймала знакомый «щёлк» helicopter view:

«Стоп, это же не просто эндпоинты. Это договор о смысле между системой и миром».

Pet‑проект vs Продукт

Пет‑проект это:
👉/fun — «посмотрю, как работает»
👉API меняется каждый день «потому что могу»
👉Тестируют на localhost

Продукт это:
▪️/money — «сколько это сэкономит и принесёт?»
▪️API — контракт, который нельзя ломать, иначе партнёры лягут
▪️Отвечают SLA перед юристами и CFO

Переход происходит ровно в ту секунду, когда показываешь свою так долго и бережно лелеемую штуку людям и начинаешь говорить о деньгах. Код превращается в обещание, а каждый endpoint — в кусок бизнес‑модели.

Какие вопросы задать себе, чтобы понять, что pet-проект готов стать продуктом.

▪️Кто будет потреблять API через полгода? Если ответа нет — проект ещё перспективная, любимая, востребованная, классная, но игрушка.

▪️ Какой endpoint приносит деньги или экономит их прямо сейчас? Если ни один — у вас не REST, а R&D.

▪️Что рухнет в соседних командах, если вы переименуете поле? Это и есть цена «легко поменять».

Хороший API‑дизайн — не про JSON‑формат. Это про логическую цепочку «данные → решение → деньги». Разрыв в одном узле = трещина в бизнесе, даже если Postman показывает 200 OK.

Ведёте pet‑проекты к продукту?
Проверьте свои endpoint’ы не только на «отвечает ли», но и на зачем. Иногда достаточно спросить «зачем это поле живёт?» — чтобы сэкономить квартал работы.

#petproject