Инструкция по отправке заявок через API

Запрос необходимо передавать методом POST в кодировке UTF-8 на адрес
http://mtargetapi.ru/api?token={token}&method=request
Переменная token - Это ключ выданный вебмастеру (для получения обратитесь в службу технической поддержки support@mastertarget.ru)

Если Ваш сайт написан на PHP то мы рекомендуем Вам скачать наш скрипт и работать с ним. В нашем репозитории находятся настройки для всех офферов с которыми мы работаем.

// В случае успешной подачи заявки, ответ будет
// id(int) - Идентификатор вашей заявки в нашей системе
Array
(
    [method] => request
    [id] => 1423440
)
// В случае системной ошибки
// error(string) - Текст ошибки
Array
(
    [method] => request
    [error] => "Текст ошибки"
)
// В случае отсутствия обязательных системных данных в запросе
// required(string) - Текст ошибки
Array
(
    [method] => request
    [required] => "Ошибка в данных: email"
)
// В случае отсутствия обязательных для оффера данных в запросе
// errors(array) - Массив в котором
// Ключ: название поля содержащее ошибку
// Значение: Текст ошибки
Array
(
    [method] => request
    [errors] => Array(
        [offer] => "Длина строки не может быть меньше чем 5-символов"
    )
)
// Если за обозначенный рекламодателем период фильтрации дублей оффер
// получал заявку с указанным вами номером мобильного телефона,
// Вы получите ниже указанную ошибку:
Array
(
    [method] => request
    [error] => Заявка с таким номером телефона есть в базе
)

Важно! Если ответ от сервера 503 значит система не принимает заявки, и нужно повторить подачу позже

Скачать Api.php

Перечень активных офферов API
База обрабатываемого ГЕО

Для указания регионов и городов нужно использовать их идентификаторы указанные в нашей базе. Чтобы скачать их, нажмите на кнопку - Скачать ГЕО базу

region_id идентификатор региона
region_name название региона
city_id идентификатор города
city_name название города

Заявки распределяются в зависимости, от ГЕО, возраста клиента, его кредитной истории, а также от суммы и срока займа. Помимо этого на распределение заявки влияет перечень полей. При передаче максимального пакета данных в заявке - увеличивается количество подходящих для неё офферов.

Перечень возможных передаваемых данных

ПеременнаяОписаниеПримерОбязательность
offerНазвание оффера
(Строка длинной от 2 до 20)
offer_nameНет
channelРекламный канал
(Строка длинной от 2 до 50)
demo_nameНет
birth_dayДень рождения
(Число от 1 до 31)
15Нет
birth_monthМесяц рождения
(Число от 1 до 12)
10Нет
birth_yearГод рождения
(Число от 1940 до 2050)
1980Нет
birth_placeМесто рождения клиента
(Строка длинной от 3 до 100)
г. МоскваНет
credit_periodПериод кредитования в днях
(Число от 1 до 10000)
90Да
credit_sumСумма кредита
(Число от 1000 до 10000000)
100000Да
emailЭлектронная почта
(Адрес электронной почты)
name@site.ruНет
last_nameФамилия
(Строка длинной от 2 до 30)
КалашниковДа
first_nameИмя
(Строка длинной от 2 до 30)
ВасилийДа
patronymicОтчество
(Строка длинной от 2 до 30)
ВладимировичДа
sexm - Male или f - FemalemНет
activityРод деятельности
(Строка длинной от 5 до 150)
пенсионер, студент, служащий, индивидуальный предприниматель, руководительНет
mobile_phoneМобильный телефон
(Число длинной 10 цифр)
9275554433Да
home_phoneДомашний телефон
(Число длинной 10 цифр)
9275554433Нет
overdue_loansКредитная история
(Число длинной 1 цифр)
0 - Нет данных
1 - Никогда не брал кредитов
2 - Никогда не допускал просрочек
3 - Закрытые просрочки
4 - Текущие просрочки
5 - Работают коллекторы
3Нет
passport_codeПаспорт
(Строка длинной от 11 до 11)
5555 666666Нет
passport_unit_codeКод подразделения
(Строка длинной от 7 до 7)
123-456Нет
passport_dateДата выдачи паспорта
(Текстовое представление даты)
2000-10-07Нет
passport_fmsКем выдан паспорт
(Строка длинной от 5 до 150)
Отделением УФМС России г. МоскваНет
work_addressАдрес места работы
(Строка длинной от 5 до 150)
Москва, Ленина 1 оф 1Нет
work_organizationНазвание организации
(Строка длинной от 5 до 150)
ООО ПросторНет
work_occupationДолжность
(Строка длинной от 3 до 150)
УчительНет
work_phoneТелефон рабочий
(Число длинной 10 цифр)
9275554433Нет
fact_region_nameРегион фактического проживания
(Число от 0 до 10000)
123Нет
fact_city_nameГород фактического проживания
(Число от 0 до 10000)
123Да
fact_city_streetУлица фактического проживания
(Строка длинной от 3 до 50)
ул. ЕфремоваНет
fact_houseДом фактического проживания
(Строка длинной от 1 до 10)
139Нет
fact_housingСтроение фактического проживания
(Строка длинной от 1 до 10)
50Нет
fact_flatКвартира фактического проживания
(Число от 1 до 1000)
80Нет
reg_region_nameРегион по прописке
(Число от 0 до 10000)
321Нет
reg_city_nameГород по прописке
(Число от 0 до 10000)
321Нет
reg_city_streetУлица по прописке
(Строка длинной от 1 до 150)
ул. ЕфремоваНет
reg_houseДом по прописке
(Строка длинной от 1 до 10)
21Нет
reg_housingСтроение про прописке
(Строка длинной от 1 до 10)
453Нет
reg_flatКвартира про прописке
(Число от 1 до 1000)
92Нет
phoneДополнительный контактный телефон
(Число длинной 10 цифр)
9275554433Нет
work_region_nameРегион места работы
(Число от 0 до 10000)
321Нет
work_city_nameГород места работы
(Число от 0 до 10000)
321Нет
work_city_streetУлица места работы
(Строка длинной от 1 до 150)
ул. ЕфремоваНет
work_houseДом места работы
(Строка длинной от 1 до 10)
21Нет
work_flatОфис места работы
(Число от 1 до 1000)
92Нет
work_positionТип должности
(Число от 0 до 5)
0 - Нет данных
1 - Генеральный директор
2 - Руководитель
3 - Специалист
4 - Обсл. персонал
5 - Рабочий
3Нет
work_salaryЗаработная плата
(Число от 1000 до 500000)
90000Нет
work_dateСтаж работы примерно в днях
(Число от 10 до 10000)
356Нет
childrensКоличество детей
(Число от 0 до 15)
3Нет