checkAccount API в MAX: что это, как работает, цена в 2026

checkAccount — это REST-эндпоинт, который принимает один или несколько номеров телефонов и возвращает информацию о том, зарегистрированы ли они в мессенджере MAX. Шаблон названия пришёл из GREEN-API (универсальный multi-messenger checker), но сейчас встречается в спецификациях большинства B2B-сервисов проверки.

У checkmaxapp эндпоинт называется POST /v1/check-account. Возвращает поля isMaxUser, server_id, lastSeen, и опционально profile (firstName, lastName, BIO).

curl -X POST https://api.checkmaxapp.com/v1/check-account \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phones": ["+79161234567", "+79261112233"],
    "include_profile": true,
    "include_server_id": true
  }'

Ответ возвращается в JSON. Положительные совпадения (isMaxUser=true) тарифицируются, отрицательные — бесплатные. Формат:

{
  "results": [
    {
      "phone": "+79161234567",
      "isMaxUser": true,
      "server_id": "65a0f...8b3c",
      "lastSeen": "2026-05-23T14:23:00Z",
      "profile": {
        "firstName": "Иван",
        "lastName": "Петров",
        "bio": "Продакт-менеджер"
      }
    },
    {
      "phone": "+79261112233",
      "isMaxUser": false
    }
  ],
  "billed": 1,
  "total": 2
}

Поле billed показывает фактическое число тарифицируемых записей в этом батче — удобно для биллинг-сверки на стороне клиента.

GREEN-API даёт мульти-мессенджер из коробки (WhatsApp + Telegram + MAX одним endpoint'ом), но платите вы за это в 10 раз больше за каждый запрос. Если задача — только MAX, узкоспециализированный checkmaxapp на порядок дешевле.

• Что возвращает checkAccount, если номер не зарегистрирован в MAX?+

  Поле isMaxUser принимает значение false, остальные поля (server_id, lastSeen, firstName) опускаются. Отрицательные ответы у checkmaxapp бесплатные — вы платите только за положительные совпадения.
• Чем checkAccount у checkmaxapp отличается от GREEN-API?+

  Спецификация эндпоинтов похожа (POST + телефон в JSON), но цена и латентность разные: checkmaxapp — $0.005 за положительный hit и 200–500 мс на запрос, GREEN-API — от ~$0.05 за проверку, поддержка нескольких мессенджеров одним endpoint'ом. Если задача — только MAX, checkmaxapp дешевле на порядок.
• Поддерживается ли batch (массовая проверка)?+

  Да. POST /v1/check-account принимает до 10 000 номеров за один запрос. Webhook callback на готовность результата избавляет от long-polling.
• Нужен ли OAuth или достаточно Bearer-токена?+

  Bearer-токена достаточно. OAuth не требуется — это B2B-API с однократной выдачей долгоживущего ключа в личном кабинете. Ротация по запросу.
• Что в поле server_id и зачем оно нужно?+

  Это стабильный внутренний идентификатор аккаунта MAX, который не меняется при смене SIM. Используется для дедупликации CRM-базы и антифрода. Подробнее — в глоссарии Server ID.
• Есть ли rate limit?+

  На batch — нет жёсткого лимита, throughput ограничен размером оплаченного тира (до 50 000 номеров/день на базовом плане). Sync-запросы — до 100 RPS на ключ.