Справочник API
Создавайте мощные интеграции с Icebox API. Программный доступ к электронной почте, контактам и многому другому.
RESTful дизайн
Чистые, предсказуемые URL и стандартные HTTP-методы
Безопасность по умолчанию
Варианты аутентификации OAuth 2.0 и API-ключ
Webhooks в реальном времени
Мгновенные уведомления при возникновении событий
Официальные SDK
Библиотеки для популярных языков и фреймворков
https://api.icebox.cool/v1Быстрый старт
Начните работу с Icebox API за несколько минут.
// Install the SDK
npm install @icebox/sdk
// Initialize the client
import { Icebox } from '@icebox/sdk';
const icebox = new Icebox({
apiKey: 'your_api_key_here'
});
// Fetch emails from inbox
const emails = await icebox.emails.list({
folder: 'inbox',
limit: 10
});
console.log(emails);curl -X GET "https://api.icebox.cool/v1/emails" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"{
"data": [
{
"id": "msg_abc123",
"subject": "Welcome to Icebox",
"from": {
"email": "hello@icebox.cool",
"name": "Icebox Team"
},
"date": "2025-01-15T10:30:00Z",
"snippet": "Thanks for signing up...",
"labels": ["inbox", "unread"]
}
],
"pagination": {
"total": 156,
"page": 1,
"per_page": 10
}
}Конечные точки API
Изучите доступные конечные точки, организованные по ресурсам.
Письма
Отправка, получение и управление сообщениями
/emailsСписок всех писем/emails/{id}Получить конкретное письмо/emailsОтправить новое письмо/emails/{id}Обновить метаданные письма/emails/{id}Удалить письмоКонтакты
Управление адресной книгой и контактной информацией
/contactsСписок всех контактов/contacts/{id}Получить конкретный контакт/contactsСоздать новый контакт/contacts/{id}Обновить контакт/contacts/{id}Удалить контактПапки и метки
Организация писем с помощью папок и меток
/foldersСписок всех папок/foldersСоздать новую папку/labelsСписок всех меток/labelsСоздать новую меткуВебхуки
Получение уведомлений о событиях в реальном времени
/webhooksСписок подписок на webhook/webhooksСоздать webhook/webhooks/{id}Удалить webhookАккаунт
Управление настройками и предпочтениями аккаунта
/accountПолучить данные аккаунта/accountОбновить настройки аккаунта/account/usageПолучить статистику использования APIВложения
Загрузка и скачивание вложений
/attachments/{id}Скачать вложение/attachmentsЗагрузить вложение/attachments/{id}Удалить вложениеОфициальные SDK
Используйте наши официальные библиотеки для быстрой интеграции.
JavaScript / TypeScript
npm install @icebox/sdkPython
pip install icebox-sdkRuby
gem install iceboxGo
go get github.com/icebox/sdk-goЛимиты запросов
Лимиты API зависят от уровня подписки.
Аутентификация
Все запросы API требуют аутентификации через API-ключ или токен OAuth 2.0. Включите свои учетные данные в заголовок Authorization.
Authorization: Bearer YOUR_API_KEYГотовы начать?
Создайте API-ключ и начните строить интеграцию сегодня.