Что такое API на самом деле

Самый чистый способ думать об API — это как о меню запросов, которое одна программа предлагает другой.

Ресторан не пускает вас на кухню готовить. Он даёт вам меню: вот что вы можете заказать, вот как это заказать, вот что вы получите в ответ. Вам не нужно знать, как устроена кухня. Вам нужно только меню. API — это ровно то же самое: компания говорит «вот запросы, которые вам разрешено делать к нашему сервису, и вот что каждый из них возвращает».

Когда ИИ пишет код, который «вызывает погодный API», он делает заказ из этого меню: дай мне прогноз для этого города. Серверы погодной компании делают работу и возвращают ответ. Ваше приложение никогда не видит их базу данных или их код. Оно просто получает блюдо.

Важный сдвиг в мышлении: API — это контракт. Другая компания обещает, что если вы спросите определённым образом, вы получите ответ определённой формы. Ваша задача — и задача ИИ — спросить правильно и прочитать ответ правильно. Большинство ошибок с API — это нарушение этого контракта одной из сторон.