Что такое API на самом деле
Самый чистый способ думать об — это как о меню запросов, которое одна программа предлагает другой.
Ресторан не пускает вас на кухню готовить. Он даёт вам меню: вот что вы можете заказать, вот как это заказать, вот что вы получите в ответ. Вам не нужно знать, как устроена кухня. Вам нужно только меню. API — это ровно то же самое: компания говорит «вот запросы, которые вам разрешено делать к нашему сервису, и вот что каждый из них возвращает».
Когда ИИ пишет код, который «вызывает погодный API», он делает заказ из этого меню: дай мне прогноз для этого города. Серверы погодной компании делают работу и возвращают ответ. Ваше приложение никогда не видит их базу данных или их код. Оно просто получает блюдо.
┌────────────┐ запрос: GET /forecast?city=London ┌────────────┐
│ ВАШЕ │ ───────────────────────────────────▶ │ API │
│ ПРИЛОЖЕНИЕ │ │ эндпоинт │
│ (клиент) │ ◀─────────────────────────────────── │ (сервер) │
└────────────┘ ответ: { "temp": 14, ... } (JSON) └────────────┘
заказывает делает работу,
по меню подаёт блюдо
Важный сдвиг в мышлении: API — это контракт. Другая компания обещает, что если вы спросите определённым образом, вы получите ответ определённой формы. Ваша задача — и задача ИИ — спросить правильно и прочитать ответ правильно. Большинство ошибок с API — это нарушение этого контракта одной из сторон.