Перейти к содержимому
Все статьи

С чего начать интеграцию через API

Общий план для технического поставщика, который хочет автоматизировать работу с SimAggregator через API: что подготовить, какую логику заложить и в каком порядке подключать.

Что подготовить до начала

Для работы с API нужен подключённый аккаунт поставщика, прошедший проверку при подключении, как и для работы через обычный кабинет. Если в планах не только активация, но и продажа на сутки, трое суток или неделю, для аккаунта отдельно включается доступ к долгой аренде: без него такие заказы недоступны ни через кабинет, ни через API.

Дальше стоит решить, что переносится в свою систему первым: статусы номеров, заказы, цены или начисления. Чем больше устройств и сервисов, а в каталоге SimAggregator их 3000+, тем заметнее эффект от автоматизации, но начинать разумно с одной задачи.

Какую логику заложить

Платформа различает два вида заказов: активацию (один сервис, от 20 до 60 минут в зависимости от сервиса) и аренду (сутки, трое суток или неделя, под сервис или за номер целиком со всеми входящими SMS). Правила возврата у них разные: при активации деньги возвращаются покупателю, если код не пришёл, при аренде от суток и дольше возврат после первого часа обычно не предусмотрен. Эту разницу стоит сразу заложить в учёт выручки.

Номер не всегда свободен для продажи: он может быть занят активной арендой целиком, находиться в окне после неё или быть новой SIM, которая пока продаётся только целиком. Повторная покупка номера после окончания срока оформляется как новый заказ. Если интеграция сама решает, когда выставлять номер на продажу, эти состояния нужно учитывать наравне с показаниями устройства.

В каком порядке подключать

Логичный порядок: сначала забрать в свою систему данные для наблюдения, статусы устройств и номеров, историю заказов, начисления, и только потом переходить к действиям, например к корректировке цен в пределах коридора платформы. Начисление приходит сразу после оплаты заказа, вывод делается отдельной заявкой, это стоит отразить в учёте отдельно от самой интеграции.

Постепенный переход снижает риск: часть процессов проверяется на небольшом числе номеров, остальные продолжают работать через кабинет.

  • Частые ошибки новичков

    Несколько типичных ошибок новых поставщиков SimAggregator в первые недели работы и как их избежать.

  • Что значит быть надёжным поставщиком

    Почему стабильная работа устройств и предсказуемое наличие номеров ценятся платформой и покупателями, и как надёжность поставщика сказывается на его доходе.

Уже работаете с другой площадкой?

Подключите те же SIM к SimAggregator, а бот цен на протоколе слайдеров hero-sms или smsbower переключите сменой адреса.

Как перейти →

Начните зарабатывать на своих SIM-картах

Регистрация и подключение оборудования за 10 минут. Первые продажи происходят в день подключения.