DMALL — External API

Клиенты настраивают и оплачивают рассылку на этом сайте. Ваш сервис забирает оплаченные задания через этот API, сам выполняет рассылку в Discord и отправляет статус обратно. Ниже — всё, что нужно разработчику.

Жизненный цикл задания

paid → (вы claim) claimed → (progress) running → (complete) done / failed. Задание оплачено клиентом в момент создания.

Рабочий цикл сервиса

1. Опрашивайте GET /dmall/v1/jobs?status=paid (например, раз в 10–30 c).
2. На каждое задание — POST /dmall/v1/jobs/:id/claim (чтобы два воркера не отправили дважды). 409 = уже занято/не в статусе paid.
3. Рассылайте. Периодически шлите POST /dmall/v1/jobs/:id/progress с sent/failed.
4. По завершении — POST /dmall/v1/jobs/:id/complete со статусом done или failed.

Endpoints

Схема задания (Job)

{
  "id": "dm_lz9…",                // идентификатор задания
  "status": "paid",              // paid|claimed|running|done|failed|cancelled
  "createdAt": 1750000000000,    // ms
  "buyerId": "8334…",            // Discord ID клиента
  "price": 5.00,                 // списано с баланса клиента (USD)
  "messageCount": 5000,          // сколько сообщений оплачено (сколько отправить)
  "target": {
    "guildId": "1392…",          // СЕРВЕР, участникам которого рассылать
    "guildName": "My Server"
  },
  "message": {
    "content": "Текст… {{LINK}}",// плейсхолдер {{LINK}} и т.п. подставляет ваш сервис
    "username": "Sender" | null, // webhook-имя (если задан setName), иначе null
    "avatarUrl": "https://…" | null,
    "status": "custom status" | null,
    "embeds": [ { "title":"", "desc":"", "color":"#5865f2", "image":"",
                  "btnlabel":"", "btnurl":"", "…":"" } ]
  },
  "filters": {
    "excludeIds": ["…"],         // не отправлять этим member/role ID
    "cooldown": { "enabled": true, "days": 7, "hours": 0 },
    "priority": "normal"
  },
  "progress": { "claimedBy":null, "claimedAt":null, "startedAt":null,
                "finishedAt":null, "sent":0, "failed":0, "note":"" },
  "raw": { "fields": { … }, "embeds": [ … ] }   // исходный конфиг «как есть», на случай доп. полей
}

Пример

# забрать оплаченные задания
curl -H "Authorization: Bearer $KEY" \
     "https://api.vemoni.info/dmall/v1/jobs?status=paid"

# занять задание
curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
     -d '{"worker":"node-1"}' \
     "https://api.vemoni.info/dmall/v1/jobs/dm_lz9.../claim"

# прогресс и завершение
curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
     -d '{"sent":1200,"failed":15}' ".../dmall/v1/jobs/dm_lz9.../progress"
curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
     -d '{"status":"done","sent":4980,"failed":20}' ".../dmall/v1/jobs/dm_lz9.../complete"

Ошибки: 401 неверный ключ · 404 нет задания/маршрута · 409 конфликт статуса · 503 API не сконфигурирован (не задан DMALL_API_KEY).