REST API

Когда я впервые подключал свой AI к сервису, с которым никогда раньше не работал, я приготовился к новой кривой обучения. Ее не было. Все вело себя почти так же, как в прошлом сервисе, который я подключал. Та же форма, те же движения, другой логотип. Это не удача. Это REST.

API — это окно выдачи для машин: место, куда твой AI подходит и заказывает вещи из меню. Если бы каждый ресторан строил свое окно по-своему (другая высота, другой язык, другой способ показать на картошку фри), тебе пришлось бы заново учиться делать заказ в каждом месте. Утомительно. REST — это договоренность: строить свое окно примерно так же, как все остальные, чтобы никому не приходилось учиться заново.

Вся идея держится на двух простых частях.

1. Все — это "вещь", которая лежит по адресу. Твои заказы живут в /orders. Клиенты живут в /customers. Товар живет в /products. Каждый из них — существительное со своим местом, как проходы в супермаркете. Ты не говоришь "найди мне данные". Ты идешь в нужный проход.
2. Ты действуешь с этими вещами через маленький фиксированный набор глаголов. Не сто кастомных команд. Просто несколько действий, которые ты и так применяешь к любым своим вещам:

• получить это (прочитать, что там есть)
• создать новое
• обновить существующее
• удалить одно

Сложи это вместе, и система читается почти как обычный язык. Иди в проход /orders, получи то, что там есть. Иди в проход /products, создай новый товар. Вся суть — в этой предсказуемости.

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

Вот почему разработчик (или твой AI) может за день разобраться с совершенно новым сервисом и не вспотеть. Если это RESTful API, а большинство именно такие, они уже примерно знают, как он ведет себя, еще до первой страницы документации.

Где ты встретишь это слово. Кто-то скажет "у них есть REST API" или "он RESTful". Тебе просто сообщают:

• Эта штука следует нормальным, предсказуемым правилам.
• Твои инструменты, скорее всего, просто с ней заработают.
• Никому не нужно придумывать особое рукопожатие, чтобы с ней поговорить.

Это тихое маленькое обещание "здесь без сюрпризов". И все.

Тебе не нужно строить такой API и точно не нужно заучивать правила. Когда слышишь RESTful, слышь "ведет себя так, как ожидаешь". Когда слышишь, как кто-то ворчит, что API "не RESTful", слышь "уф, тут странная снежинка, придется учить ее причуды". Оба варианта сразу говорят, насколько тебе будет неприятно еще до начала.

Завтра: сами глаголы