Эндпоинт

Когда мне впервые сказали "дерни эндпоинт заказов", я кивнул так, будто понял. Я не понял. Звучало как какое-то место. Оказалось, почти так и есть.

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

• Одна дверь для получить мои заказы.
• Другая дверь для создать товар.
• Еще одна — для отправить письмо.
• Еще одна — для удалить клиента.

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

Как эндпоинт выглядит на самом деле. В реальной жизни это просто веб-адрес. Берешь API компании и добавляешь к нему маленький хвост в конце:

Каждый такой хвост — отдельная дверь. /orders — дверь заказов. /customers — дверь клиентов. То же здание, разные двери для разных запросов. Когда ты видишь эти слэши в чьем-то коде или документации, это всего лишь таблички на дверях.

Так что когда разработчик говорит "дерни эндпоинт заказов", он имеет в виду: постучи в дверь с надписью orders и попроси то, что за ней. Никакой мистики.

Твой AI тоже не разговаривает с "Shopify" как с одной большой кашей. Он идет по коридору и стучит в несколько конкретных дверей, по одной за раз. Поэтому "напиши всем клиентам, которые покупали на прошлой неделе" — это три стука подряд:

1. Дверь заказов: кто покупал на прошлой неделе?
2. Дверь клиентов: какие у них email-адреса?
3. Дверь email: отправь сообщение.

Одно здание, много дверей. Эндпоинт — ровно та дверь, которая тебе нужна.