Быстрый старт

1. Проверьте ключ #

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

curl 'https://api.dashamail.com/v2/account/balance' \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "response": {
    "msg": { "err_code": 0, "text": "OK", "type": "message" },
    "data": {
      "limit_members": 5000,
      "limit_emails": 50000,
      "expiration_date": "01.10.2026 12:00:00",
      "members": 1284
    }
  }
}

Полезная нагрузка всегда лежит в response.data. Подробнее — в разделе Формат запросов и ответов.

2. Создайте адресную базу #

Подписчики в DashaMail всегда лежат внутри адресной базы, поэтому она нужна раньше всего.

curl -X POST 'https://api.dashamail.com/v2/lists' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name": "Клиенты интернет-магазина"}'

{
  "response": {
    "msg": { "err_code": 0, "text": "OK", "type": "message" },
    "data": { "list_id": 128341 }
  }
}

Запомните list_id — он понадобится дальше.

3. Добавьте подписчика #

Дополнительные поля адресуются как merge_1, merge_2 и так далее. В новой базе merge_1 — это «Имя», merge_2 — «Фамилия».

curl -X POST 'https://api.dashamail.com/v2/lists/128341/members' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "ivan@example.com",
    "merge_1": "Иван",
    "merge_2": "Петров"
  }'

Коллекция запросов #

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

• Коллекция Postman — её же читают Insomnia, Bruno, Hoppscotch и Yaak.
• Описание OpenAPI 3.1 — для генераторов клиентских библиотек, валидаторов и шлюзов.
• Коллекция для API 1.21 — если интеграция написана на ?method=lists.get.

В Postman: Import → вкладка Link → вставьте адрес файла. Дальше откройте Variables коллекции и впишите свой ключ в api_key — он подставится во все запросы сразу.

Что дальше #

• Массовая рассылка по базе — Рассылки.
• Письма по событию (welcome, брошенная корзина) — Автоматизации.
• Открытия, клики, возвраты — Отчёты.
• Приём ответов и входящих писем — Обработка входящих.