Зачем нужен API
- Интеграция сервисов
- Автоматизация процессов
- Расширение функционала
- Снижение затрат
Примеры использования API
- Приложения такси используют API карт и платежей
- Интернет-магазины — API логистики и оплаты
- Авторизация через соцсети — API Facebook/Google
Виды API
По архитектуре:
- REST API: лёгкий, популярный, HTTP + JSON
- SOAP: строгий XML-протокол
- GraphQL: гибкий, минимизирует запросы
- RPC/gRPC: удалённые вызовы процедур
Основные методы HTTP API
GET — Получение данных
curl "https://apirouter.ru/v1/models"{"data": [{"id": "gpt-4o"}, {"id": "claude-3.5"}]}POST — Отправка данных
curl -X POST "https://apirouter.ru/v1/chat/completions" \
-d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "Привет"}]}'{"choices": [{"message": {"content": "Привет! Как дела?"}}]}Аутентификация
-H "Authorization: Bearer your_api_key"JSON формат
Запрос:{"model": "gpt-4o", "messages": [{"role": "user", "content": "Что такое API?"}]}{"choices": [{"message": {"content": "API - это интерфейс для взаимодействия программ"}}]}Практические примеры
| Задача | Запрос | Ответ |
|---|---|---|
| Список моделей | GET /v1/models | Массив доступных AI моделей |
| Отправить сообщение | POST /v1/chat/completions | Ответ от AI |
| Проверить статус | GET /v1/status | Информация о работе сервиса |
Статус коды
- 200 — Успешно
- 401 — Неверный API ключ
- 429 — Превышен лимит запросов
- 500 — Ошибка сервера
По доступности:
- Public API: доступен всем
- Partner API: доступ по договору
- Private API: для внутреннего использования
Безопасность API
- API-ключи, OAuth
- HTTPS и шифрование
- Ограничение частоты запросов
FAQ — Часто задаваемые вопросы
Что означает аббревиатура API?
API расшифровывается как Application Programming Interface — интерфейс программирования приложений.Чем REST отличается от SOAP?
REST проще и работает с JSON, SOAP использует XML и подходит для защищённых систем.Где используется API?
В веб-сайтах, мобильных приложениях, CRM, платёжных системах и многих других.
Полина Сергеева
AI-разработчик и технический писатель. Создаёт инструменты на базе нейросетей и делится практическими гайдами для разработчиков и бизнеса.
