API для проверки номеров: индивидуальный доступ через поддержку

Если вы дочитали до этой страницы, скорее всего у вас уже стоит вопрос: «нам нужно интегрировать проверку номеров MAX в свой бэкенд — есть ли API?». Короткий ответ: да, доступ выдаём, но индивидуально, через поддержку.

TL;DR

• Самообслуживаемой публичной формы регистрации API-ключей пока нет — это осознанное решение
• Доступ выдаём по запросу через /support в Telegram-боте — обычно 1–2 рабочих дня
• Цена та же: от $0.01 за проверку, скидочные тиры сохраняются
• Получаете: прямой REST-эндпоинт, документацию под ваш кейс, выделенный rate-limit, опциональный SLA
• Популярные интеграции: amoCRM, Bitrix24, HubSpot, Make/Zapier/n8n, антифрод-стеки

Почему не публичная форма

Когда мы запускали сервис, было соблазнительно сделать самообслуживаемый dashboard с автогенерацией ключей, как в условном Twilio или Stripe. Но в нашей нише быстро всплыли две вещи:

1. Очень разные кейсы. Антифрод-команда проверяет 200 номеров в день синхронно, рекрутер — 1 000 раз в неделю батчами по 5 000, маркетинговый отдел — 100 000 номеров перед каждой рассылкой. Стандартный «один тариф для всех» либо ограничивает крупных, либо переплачивает за мелких. Индивидуальный разговор позволяет сразу собрать нужный профиль.

2. Чувствительность данных. Мы знаем, для чего клиент использует API — и можем заранее настроить корректную обработку: например, специальный формат для антифрода (с дополнительными полями скоринга) или batch-режим с локальной кэширующей прослойкой для маркетологов. Это нельзя автогенерировать.

Поэтому сейчас работаем по схеме «опишите кейс → команда настроит».

Что вы получаете при индивидуальном доступе

• REST-эндпоинт — стандартный JSON, идемпотентность через идентификатор запроса, чёткие коды ошибок
• Документация под ваш сценарий — мы не просто кидаем общий swagger, а делаем примеры под вашу конкретную платформу (CRM, рассыльщик, антифрод-стек)
• Выделенный rate-limit — обсуждаем под ожидаемый месячный объём, без жёсткого общего ограничения
• Опциональный SLA — для команд с критичной зависимостью от стабильности
• Приоритетная поддержка — отдельный канал, ответ обычно в течение нескольких часов в рабочее время

Цена остаётся такой же, как в боте: от $0.01 за проверку, скидочная сетка применяется так же. Разница только в способе доставки и сопровождении.

Какие сценарии чаще всего просят

По нашей статистике запросов в поддержку, 80% индивидуальных API-доступов используются под одну из четырёх задач:

1. Чистка базы перед рассылкой. Маркетинговая команда раз в неделю или раз в месяц прогоняет всю базу контактов через API, чтобы оставить только живые номера. Здесь критичны batch-эндпоинты и стабильная пропускная способность. Подробнее в гайде по чистке базы.

2. Антифрод и скоринг. Антифрод-движок при каждой регистрации/транзакции делает синхронный запрос. Здесь критична низкая латентность и стабильность ответа. Подробнее в статье про антифрод.

3. Обогащение лидов в CRM. Менеджер получает входящий лид → CRM автоматически дёргает API → подтягивает имя/фамилию/server ID/BIO в карточку лида. Здесь важна скорость отклика и единичные запросы.

4. White-label зеркала и реселлеры. Партнёры подключают свой маркетплейс/SaaS как зеркало — API даёт прямой канал для их клиентов. См. гайд по white-label.

Что нужно прислать при запросе

Чтобы команда поддержки сразу подобрала тариф и rate-limit, в /support опишите:

1. Ожидаемый объём проверок в месяц (например: «20 000–40 000»)
2. Сценарий: чистка базы, антифрод, обогащение CRM, white-label
3. Платформа интеграции (если стандартная — amoCRM/Bitrix24/HubSpot/Make/Zapier/n8n, или кастомный бэкенд)
4. Латентность: критична ли низкая задержка отклика или достаточно batch
5. SLA: нужен ли формальный SLA-договор

Стандартный путь от запроса до боевого ключа — 1–2 рабочих дня. Для особо срочных кейсов команда вернётся быстрее.

Что не даём через индивидуальный доступ

Чтобы не перегружать ожидания: индивидуальный API-доступ не решает следующих задач:

• Произвольный поиск по странам — мы работаем с RU-номерами, доступ к другим странам не предоставляем
• Поиск по другим мессенджерам — только MAX
• Доступ к переписке или внутренним данным MAX — мы возвращаем только публичные поля профиля
• Покупка готовых баз — это не наш продукт; мы инструмент проверки, а не источник данных

Что дальше

Если вы дочитали и кейс ваш — пишите в /support в Telegram-боте. Если кейса пока нет, но интересна экономика — посмотрите страницу с тарифами или сравнение с ручной проверкой.

Если вы партнёр, который хочет перепродавать проверку под своим брендом — это не API-доступ, а отдельная схема: см. white-label.

Полезные материалы

• Тарифы и скидочные тиры — базовые цены, которые применяются и в API-доступе
• Гайд по чистке базы — типовой сценарий API-интеграции для маркетинга
• Антифрод по номеру — кейс синхронного API-доступа
• Гайд по белым-лейблам — отдельный сценарий для реселлеров
• Сравнение с ручной проверкой — про экономику автоматизации