Лорра кладёт планшет на стойку экраном вверх. На нём три ответа API Вышки, которые она получила за ночь на один и тот же вопрос «дай журнал»: строка нужен вход, HTML на сорок строк со стеком Python и {"error": true}. Ниже её почерком: «Что из этого ошибка? Какая? Что мне делать дальше?»
Когда сайт Вышки говорил с людьми, ошибки можно было писать как угодно: человек прочитает «нужен вход» и войдёт. Теперь у Вышки появились клиенты-программы: страница с fetch из прошлого урока, сверки Лорры, завтра чьи-то ещё. Программа не читает текст, она читает форму ответа. Если форма у каждого обработчика своя, клиенту приходится угадывать.
Сегодня у API Вышки появится контракт: как называются ресурсы, что значит каждый метод и статус, как выглядит ошибка, как листать длинный журнал и как просить новую версию, не ломая старых клиентов.
урок из курса
Урок из курса «Python backend: Тарбадель». Курс покупается один раз и остаётся навсегда: 500 ₽.
Оплата пока не подключена: премиум и курсы открываются промокодом.